Skip to content

docs(skills): clarify miniapp CLI coverage so it stops reading web-only - #92

Merged
maidang-xing merged 2 commits into
tuya:mainfrom
maidang-xing:fix/miniapp-skill-cli-coverage
Sep 28, 2026
Merged

maidang-xing merged 2 commits into
tuya:mainfrom
maidang-xing:fix/miniapp-skill-cli-coverage

Conversation

@maidang-xing

Copy link
Copy Markdown
Contributor

What

The two shared miniapp skills (miniapp-development-workflow 2.7.3, tuyaopen-miniapp 2.5.2) carried a ## No tuyaopen-cli CLI coverage section that said what the payload does not have, and nothing else. A field agent developing a real product read it and concluded submit-for-review / release / bind are web-only, sent the user to the browser, then got stuck for a round on MINIPROGRAM_UI_INFO_NOT_COMPLETE with no recoverable hint.

Why the bodies only get prose

The repo gate on the IDE side (skillIsolationScan.test.ts) keeps these four shared executable skills Broker-only by owner decision, so no command table is added here — the executable route's authoritative discovery surfaces are the CLI itself: the miniapp upload envelope's webSteps block and schema list. Both bodies now say the heading's precise meaning: no native subcommands ≠ web-only; the steps are scriptable outside the IDE and the CLI publishes the route itself.

Bookkeeping

  • Per-item versions bumped (2.7.4 / 2.5.3) for the payload change
  • registry skills.version 1.1.2 → 1.1.3, publishedAt refreshed (domains gate)

Validation

  • validate-skills-index.py — OK (24 items)
  • check-skill-version-bumps.py — OK (2 changed payloads)
  • check-domain-version-bumps.py --base-ref origin/main — OK (4 domains)
  • IDE-side skillIsolationScan.test.ts — 12/12 green against the updated payloads

The two shared miniapp skills said 'No tuyaopen-cli CLI coverage' and
left the reader to conclude submit/release/bind are web-only - exactly
what a field agent concluded while shipping a real product. The heading
is literally true (no native tuyaopen-cli subcommands) but the section
never said what the absence means, and never pointed at the surfaces
that DO publish the shell route.

Both bodies now state the heading's precise meaning: the platform steps
are scriptable outside the IDE, and the route is published by the CLI
itself - the miniapp upload envelope's webSteps block and schema list
discovery. No commands are added to the payloads (repo gate
skillIsolationScan keeps these Broker-only by owner decision).

Versions bumped 2.7.4 / 2.5.3 for the payload change; registry skills
1.1.2 -> 1.1.3 and publishedAt refreshed per the domains gate.
The '申领 appid / 网页步骤' row pointed at 'skill tuyaopen-miniapp
0.2 (3)' - an anchor that no version of that skill's SKILL.md carries
(it died with the pre-migration shared-skill layout and the
capability-broker migration removed the last body that could have held
it). The row now states what is actually true: the appid itself is
issued on the web console only, and the post-appid version/bind page
URLs ride the tuyaopen-cli miniapp upload webSteps envelope.

tuyaopen-start 2.0.2 -> 2.0.3 for the payload change.
@maidang-xing
maidang-xing merged commit fbc035e into tuya:main Sep 28, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant