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

2.1 KiB
Raw Blame History

name, description
name description
skill-new Create a new skill in the jsc skill set. Ask skill details via decision tree, generate the skill under the right jsc-{domain} per guidelines.md (create the domain from the template repo if missing), then open a PR via jsc-git pr. Use when the user wants to add a skill; not for editing an existing one (use skill-update).

skill-new — 新建技能

準則單一來源:../../references/guidelines.md。

流程

  1. 依 jsc-ask:ask 決策樹詢問技能細節,直到沒有疑慮:
    • 目標(單一、與既有技能不重複;先掃 jsc-*/skills/*/SKILL.md 列出相近技能供比對,選項需標明「複用既有」與「新建」的影響範圍)
    • 觸發時機(何時用、何時不用、觸發關鍵字)
    • 輸入與輸出(是否有標準輸入輸出可下放 tools/;是否需要 gitea 操作,需要就讓技能使用 jsc-gitea/tools/gitea.sh + token)
    • 所屬 domain(列出現有 jsc-* 供選擇)
  2. 若 domain 不存在:
    1. 幫新 domain 想一個簡短的英文代表詞(一個單字為佳),與使用者確認。
    2. 請使用者建立存取庫 plugins/{domain},clone 後依 https://gitea.jsc.idv.tw/plugins/template 的結構建立內容:三份 plugin manifest(plugin 名 jsc-{domain},版本從 0.0.1 開始)、skills/、README.md、AGENTS.md(不放 marketplace 檔)。
    3. 把 plugin 條目(URL 來源指向新存取庫)加入 plugins/jsc 的 .claude-plugin/marketplace.json 與 .agents/plugins/marketplace.json。
  3. 依 guidelines.md 產生技能(此步驟必須以 sub agent 執行):
    • skills/{name}/SKILL.md:英文 description(≤ 5 句、含觸發時機)、STE100 繁中內文
    • 可 hook 的規則放 jsc-hooks(不可散落本 domain);標準輸入輸出流程放 tools/
    • 同步該 domain README 的「Skills 目錄」、三份 manifest 的 version bump
  4. 依 guidelines.md「審核檢查清單」逐項自檢,不符就修正。
  5. 呼叫 jsc-git:pr 建立 Push Request。