create-agentic-dev-env 0.2.4 → 0.2.5

package/bin/create.js

@@ -20,8 +20,10 @@ fs.cpSync(path.join(__dirname, '..', 'template'), dest, { recursive: true })
 // npm publish 會剝掉 dot 開頭的檔案/目錄，template 內以無點名稱存放，複製後改名
 fs.renameSync(path.join(dest, 'gitignore'), path.join(dest, '.gitignore'))
 fs.renameSync(path.join(dest, 'dot-claude'), path.join(dest, '.claude'))
-// add-service 主要使用場景在 ADE repo 內，symlink 進 .claude/skills/ 讓它在本 repo 也可觸發（單一真相在 skills/）
-fs.symlinkSync(path.join('..', '..', 'skills', 'ade-add-service'), path.join(dest, '.claude', 'skills', 'ade-add-service'), 'dir')
+// 這些 skill 在 ADE repo 內也要可觸發，symlink 進 .claude/skills/（單一真相在 skills/）
+for (const s of ['ade-add-service', 'ade-add-skill']) {
+  fs.symlinkSync(path.join('..', '..', 'skills', s), path.join(dest, '.claude', 'skills', s), 'dir')
+}
 for (const rel of fs.readdirSync(dest, { recursive: true })) {
   const p = path.join(dest, rel)
   if (!fs.statSync(p).isFile()) continue

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agentic-dev-env",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Scaffold and manage team Agentic Dev Environment (ADE) knowledge repos",
   "repository": {
     "type": "git",

package/template/README.md

@@ -53,8 +53,8 @@ knowledge/
 ├── process/     # 團隊流程知識
 ├── specs/       # 當前功能規格，持續迭代的真相來源
 └── prd/         # 一次開發一檔的需求文件，歷史文件不迭代
-skills/          # init 時注入工作目錄的 .claude/skills/（五支，見下方 Skills 一覽）
-.claude/skills/  # 在本 repo 內工作用的 skills（三支＋ade-add-service 的 symlink，見下方 Skills 一覽）
+skills/          # init 時注入工作目錄的 .claude/skills/（六支，見下方 Skills 一覽）
+.claude/skills/  # 在本 repo 內工作用的 skills（三支＋add-service、add-skill 的 symlink，見下方 Skills 一覽）
 claude-md/       # CLAUDE.md managed 區段的內容
 ```
 
@@ -70,6 +70,8 @@ claude-md/       # CLAUDE.md managed 區段的內容
 
 - **`ade-spec-audit`** — spec 的定期健檢。PRD 流程只覆蓋「計畫內」的開發，hotfix 和直接改 code 的計畫外變更會讓 spec 悄悄失真——這支 skill 補上這條偵測路徑。觸發後它逐份 spec 對照相關服務的實作（缺的 repo 會先 clone），找出「行為已變、功能已移除、實作有但 spec 沒記載」的漂移，產出清單讓人確認該修 spec 還是該修 code（漂移不一定是文件錯，也可能是實作偏離了規格），確認後開 PR 修正。建議在 release 後或定期執行。
 
+- **`ade-add-skill`** — 為 ADE 生態新增 skill 的 meta-skill。使用者說「新增 skill」「把這個做成 skill」時觸發。它先問使用對象再決定放置位置：消費端工作目錄用 → `skills/ade-*`（init/update 注入）；本 ADE repo 內用 → `.claude/skills/ade-*`；兩邊都用 → 放 `skills/` 加 symlink。並落實命名規則（`ade-` 前綴）、context 紀律與 README 同步。**本 ADE repo 內也可用**（`.claude/skills/` 有 symlink）。
+
 - **`ade-add-process`** — 為團隊建立或修改流程慣例的 meta-skill。使用者說「以後都這樣做」「定一個慣例」時觸發。它依三層機制選載體：無條件約束 → `claude-md/section.md` 加一行指標；有觸發時機的程序 → 新增一支 `ade-` 前綴 skill；細節 → `process/` 一主題一檔。並執行 context 紀律：常駐層只寫「何時做＋去哪看」（參考技巧）、常駐規則超過 10 行時新增前必須與使用者確認取捨。最後走 `ade-contribute` 流程開 PR。
 
 ### 在本 ADE repo 內工作用的 skills（PO／維護者在本 repo 開 Claude Code 使用）

package/template/skills/ade-add-process/SKILL.md

@@ -28,7 +28,7 @@ description: 為團隊建立或修改流程慣例並落地到 ADE 知識庫。
 
 1. 依 `ade-contribute` skill 流程 clone ADE repo、建分支（含查重：同一流程已有 issue/PR 就別重開）
 2. 寫 `knowledge/process/<主題>.md`（細節層，kebab-case 檔名）
-3. 需要 skill 的：在 `skills/` 下建立，**目錄名必須 `ade-` 前綴**——runner 只管理此前綴，非前綴會被拒裝
+3. 需要 skill 的：依 `ade-add-skill` skill 建立（它管使用對象選擇、放置位置與命名規則）
 4. 需要常駐行的：在 `claude-md/section.md` 適當小節加一行指標
 5. 更新 `process/README.md` 的主題索引
 6. 依 `ade-contribute` 慣例開 PR；merge 後各工作目錄 update 即生效

package/template/skills/ade-add-skill/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: ade-add-skill
+description: 為 ADE 生態新增 skill（供 ADE repo 內或消費端工作目錄使用）。使用者說「新增 skill」「建一支 skill」「把這個做成 skill」「這個 skill 消費端也要能用」時使用。
+---
+
+# 新增 skill
+
+1. **判斷所在位置**：repo 根有 `knowledge/services/` → 你在 ADE repo 內，直接編輯本 repo 檔案；只有 `.claude/ade/knowledge/` → 你在工作目錄，依 `ade-contribute` skill 的流程 clone ADE repo 並建立分支（絕不直接改 `.claude/ade/` 副本）
+2. **選使用對象**——這決定放哪，不確定就問使用者：
+   - **消費端工作目錄用** → `skills/ade-<name>/`。init/update 會注入各工作目錄的 `.claude/skills/`；**目錄名必須 `ade-` 前綴**，runner 只管理此前綴，非前綴會被拒裝
+   - **ADE repo 內用**（PO／維護者）→ `.claude/skills/ade-<name>/`
+   - **兩邊都用** → 放 `skills/ade-<name>/`，再建 symlink：`ln -s ../../skills/ade-<name> .claude/skills/ade-<name>`（單一真相在 `skills/`，維護只改一份）
+3. 寫 `SKILL.md`：frontmatter 的 `name` 與目錄同名；`description` 寫觸發語（使用者會說什麼、什麼情境該觸發）；body 遵守 context 紀律——只寫「何時做＋去哪看」，超過一頁的細節拆到 `knowledge/process/` 檔並連結（禁止孤兒：細節檔必須被引用）
+4. skill 內需要「開 PR 回 ADE repo」的動作一律寫「依 `ade-contribute` 流程」，不要重複實作回流機制
+5. 更新本 repo `README.md` 的 Skills 一覽
+6. 收尾：ADE repo 內 → 照一般 git 慣例 commit；工作目錄 → 依 `ade-contribute` 流程開 PR