Files
meta/skills/skill-update/SKILL.md
T

1.9 KiB

name, description
name description
skill-update Update an existing skill in the jsc skill set. List all skills from the Gitea canonical marketplace (cloning any missing domain repo) and let the user pick one, ask update details via decision tree, apply the change, then re-check against the guidelines checklist until it passes and open a PR via jsc-git pr. Use for modifying a skill; not for creating (skill-new) or removing (skill-delete).

skill-update — update a skill

Single source of guidelines: ../../references/guidelines.md.

Flow

  1. Query Gitea for the canonical skill set first: run jsc-gitea/tools/gitea.sh api GET /repos/plugins/meta/raw/.claude-plugin/marketplace.json to get the authoritative domain list, then scan local jsc-*/skills/*/SKILL.md and present a "domain / name / description" list covering every domain in the marketplace. Completion condition: the list covers all marketplace domains.
  2. For any marketplace domain whose repo is missing from the working directory, clone it first (gitea.sh clone-url plugins/{domain}), then rescan. Completion condition: every domain repo exists locally.
  3. Let the user pick the skill to update.
  4. Ask for update details via the jsc-ask:ask decision tree (change the goal? the trigger? the flow? move rules down to a hook or a tool?). Every option states its impact scope (example: renaming breaks the existing invocation command).
  5. Update the skill — the modification part MUST run as a sub agent: modify SKILL.md and related files. Then run tools/sync-skill-manifest.sh {domain-path} directly (no sub agent needed) to sync the domain README's 「Skills 目錄」 section and bump the version in all three manifests.
  6. Check every item of the guidelines.md audit checklist. On any failure, return to step 4: ask again and fix, until all items pass.
  7. Call jsc-git:pr to open a Push Request.