26 lines
2.0 KiB
Markdown
26 lines
2.0 KiB
Markdown
---
|
||
name: skill-new
|
||
description: 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`](../../references/guidelines.md)。
|
||
|
||
## 流程
|
||
|
||
1. 依 `jsc-ask:ask` 決策樹詢問技能細節，直到沒有疑慮：
|
||
- 目標（單一、與既有技能不重複——先掃 `jsc-*/skills/*/SKILL.md` 列出相近技能供比對，選項需標明「複用既有」與「新建」的影響範圍）
|
||
- 觸發時機（何時用、何時不用、觸發關鍵字）
|
||
- 輸入與輸出（是否有標準輸入輸出可下放 `tools/`；是否需要 gitea 操作——需要就讓技能使用 `jsc-gitea/tools/gitea.sh` + token）
|
||
- 所屬 domain（列出現有 `jsc-*` 供選擇）
|
||
2. 若 domain 不存在：
|
||
1. 為其想一個簡短的英文代表詞（一個單字為佳），與使用者確認。
|
||
2. 請使用者建立存取庫 `plugins/{domain}`，clone 後依 `https://gitea.jsc.idv.tw/plugins/template` 的結構建立內容：三份 plugin manifest（plugin 名 `jsc-{domain}`）、自身的 `.claude-plugin/marketplace.json` 與 `.agents/plugins/marketplace.json`（marketplace 名 = `{domain}`）、`skills/`、README.md、AGENTS.md。
|
||
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。
|