docs(meta): translate SKILL.md into English per guidelines

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 14:28:37 +08:00
parent 526c6c2b93
commit 7283fea040
3 changed files with 41 additions and 41 deletions
@@ -3,24 +3,24 @@ 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 — 新建技能
+# skill-new — create a skill

-準則單一來源：[`../../references/guidelines.md`](../../references/guidelines.md)。
+Single source of guidelines: [`../../references/guidelines.md`](../../references/guidelines.md).

-## 流程
+## Flow

-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。
+1. Ask for skill details via the `jsc-ask:ask` decision tree until no doubt remains:
+   - Goal (single and not duplicating an existing skill; first scan `jsc-*/skills/*/SKILL.md` and list similar skills for comparison — options must state the impact scope of "reuse existing" versus "create new")
+   - Trigger (when to use, when not to, trigger keywords)
+   - Input and output (can a standard input/output flow move down to `tools/`; does it need Gitea operations — if so, make the skill use `jsc-gitea/tools/gitea.sh` + token)
+   - Owning domain (list the existing `jsc-*` domains to choose from)
+2. If the domain does not exist:
+   1. Propose one short English word for the new domain (a single word preferred) and confirm it with the user.
+   2. Ask the user to create the repository `plugins/{domain}`. Clone it, then build the content following the structure of `https://gitea.jsc.idv.tw/plugins/template`: three plugin manifests (plugin name `jsc-{domain}`, version starting at `0.0.1`), `skills/`, README.md, AGENTS.md (no marketplace files).
+   3. Add the plugin entry (URL source pointing at the new repository) to `.claude-plugin/marketplace.json` and `.agents/plugins/marketplace.json` in `plugins/jsc`.
+3. Generate the skill per guidelines.md — this step MUST run as a sub agent:
+   - `skills/{name}/SKILL.md`: entirely in English (description ≤ 5 sentences with trigger conditions; body in STE100-style English)
+   - Rules enforceable by hooks go to `jsc-hooks` (never scattered in this domain); standard input/output flows go to `tools/`
+   - Sync the domain README's 「Skills 目錄」 section and bump the version in all three manifests
+4. Self-check every item of the guidelines.md audit checklist; fix anything that fails.
+5. Call `jsc-git:pr` to open a Push Request.