diff --git a/references/guidelines.md b/references/guidelines.md index 743b66e..5463754 100644 --- a/references/guidelines.md +++ b/references/guidelines.md @@ -5,10 +5,11 @@ ## 命名 1. Plugin 名稱:`jsc-{domain}`,domain 用一個簡短的英文代表詞(例:`ask`、`sdlc`、`gitea`)。 -2. Marketplace 名稱:`jsc`。 +2. Marketplace 統一為 `jsc`,唯一承載存取庫為 `https://gitea.jsc.idv.tw/plugins/jsc.git`;安裝 token 一律 `jsc-{domain}@jsc`。各 domain 存取庫**不放** marketplace 檔。 3. Skill 名稱:小寫、數字、連字號(`-`),最長 64 字元。名稱即指令(`/jsc-{domain}:{name}`)。 -4. 每個 domain 是一個獨立存取庫 `https://gitea.jsc.idv.tw/plugins/{domain}.git`。新 domain 必須依 `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`。 +4. 每個 domain 是一個獨立存取庫 `https://gitea.jsc.idv.tw/plugins/{domain}.git`。新 domain 必須依 `https://gitea.jsc.idv.tw/plugins/template` 的結構建立新存取庫(三份 plugin manifest、`skills/`、`README.md`、`AGENTS.md`),並把 plugin 條目加入 `plugins/jsc` 的 `.claude-plugin/marketplace.json` 與 `.agents/plugins/marketplace.json`(URL 來源指向新存取庫)。 5. Git 分支名**只允許 ASCII**(`a-z0-9` 與 `/`、`-`);中文需求或標題先翻譯成英文短語再 slug 化。 +6. Manifest 版本號從 `0.0.1` 開始,三份 manifest 同步 bump。 ## Description 規則 diff --git a/skills/skill-new/SKILL.md b/skills/skill-new/SKILL.md index acc0b5a..ee1bde0 100644 --- a/skills/skill-new/SKILL.md +++ b/skills/skill-new/SKILL.md @@ -16,7 +16,8 @@ description: Create a new skill in the jsc skill set. Ask skill details via deci - 所屬 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。 + 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/`