ECC Recipes
單一入口點:「哪一組 ECC 斜線指令可以執行我的工作流程?順序為何?何時停止?」。同時瀏覽每個指令群組的配方家族。
填補以下兩個既有技能之間的缺口:
ecc-guide— 列出指令及其文件位置,但為平坦目錄。prompt-optimizer— 將任務對應到元件,但輸出單一提示,而非包含執行順序與停止條件的多指令群組。
此技能增加:家族分組 + 執行順序 + 停止條件。
何時啟用
- 「哪個指令群組可以執行 <工作流程>?」
- 「建立 MVP / 修復缺陷 / 重構的指令順序是什麼?」
- 「顯示所有 ECC 指令群組配方」(目錄模式)
- 「ECC 有多少個工作流程管線?」
- 使用者呼叫
/ecc-recipes,無論有無描述。
不應使用時機
- 使用者希望立即執行任務 — 直接導向實際指令,不要描述。
- 使用者希望取得單一指令的詳細文件 — 使用
ecc-guide。 - 使用者希望重新編寫草稿提示 — 使用
prompt-optimizer。
核心原則
根據當前檔案回答,而非記憶。 指令集會變動;絕不硬編碼計數或成員清單。每次執行時讀取即時的 commands/ 目錄,然後分類到家族中。
即時讀取
解析指令目錄(第一個存在的),然後列出名稱:
for D in \
"$HOME"/.claude/plugins/marketplaces/ecc/commands \
"$HOME"/.claude/plugins/cache/ecc/ecc/*/commands \
./commands \
./.claude/commands \
"$HOME"/.claude/commands; do
[ -d "$D" ] && CMD_DIR="$D" && break
done
[ -z "${CMD_DIR:-}" ] && { echo "No ECC commands directory found."; return 1; }
find "$CMD_DIR" -maxdepth 1 -name '*.md' -exec basename {} .md \; | sort
可選:如果存在 manifests/install-*.json 則讀取以取得更豐富的分組。使用所需的最小讀取集合。
家族分類(依前綴)
依前導前綴將指令名稱分組;手動對應已知的單體指令。家族是即時推導的——下表為分類規則,並非固定列表。
| 家族前綴 | 配方含義 | 典型執行順序 |
|---|---|---|
orch-* | 針對每種任務類型進行閘控式研究、規劃、TDD、審查、提交 | 依任務類型選取一個 orch-*;它會自行執行內部階段 |
multi-* | 多模型工作流程 | multi-plan 再 multi-execute 再審查(或直接使用 multi-workflow 端到端) |
prp-* | 從 PRD 到規劃到實作再到 PR 的管線 | prp-prd 再 prp-plan 再 prp-implement 再 prp-commit 再 prp-pr |
epic-* | 大型多單元史詩,可並行 | epic-decompose 再 epic-claim 再 epic-validate 再 epic-review 再 epic-unblock 再 epic-sync 再 epic-publish |
loop-* | 受管自主迴圈與監控 | loop-start <pattern> 再透過 loop-status 觀察 |
gan-* | 生成器與評估器迴圈 | gan-build(程式碼)或 gan-design(UI);自我迴圈 |
*-build / *-review / *-test | 各語言 CI 三元組 | <lang>-test(TDD)再 <lang>-build(修正)再 <lang>-review |
hookify-* | 行為鉤子管理 | hookify 再 hookify-list 再 hookify-configure |
learn / instinct-* / evolve / promote / prune | 持續學習 | learn 再 instinct-status 再 evolve 再 promote |
| 單體指令 | santa-loop, plan, plan-prd, pr, code-review, checkpoint 等 | 獨立使用或作為群組間的黏合劑 |
任何不符合前綴規則的指令 → 將其列在單體指令下,並附上一行說明。
運作方式
1. 從 CMD_DIR 即時讀取指令名稱。
2. 依前綴與單體指令對應表分類到家族。
3. 如果有提供工作流程描述 -> 比對模式。
如果沒有 -> 目錄模式。
4. 僅供建議:印出計畫。絕不執行比對到的指令。
目錄模式(無描述)
輸出家族表格:每個家族、成員數量、成員、一行含義、典型執行順序。最後以總指令數與請使用者描述工作流程以取得比對配方的提示結尾。
比對模式(有描述)
- 用一句話重述工作流程。
- 選出最佳 1-2 個家族;各用一行說明原因。
- 執行順序區塊 — 比對家族的精確指令順序。
- 停止條件 — 始終明確(最大執行次數、完成訊號、審查通過或一次性)。對於自主迴圈,需警告訂閱用量並建議設置上限。
- 閱讀文件 —
commands/<name>.md路徑加上/ecc-guide <name>。
輸出範本(比對模式)
工作流程:<一句話重述>
最佳比對:<家族> — <原因>
(備選:<家族> — <原因>)
執行順序:
/<cmd1> # 工作
/<cmd2> # 工作
/<cmd3> # 工作
停止條件:<條件>
警告(僅適用於自主迴圈):無界限迴圈會消耗訂閱/點數——請在完成訊號外,同時加入最大迭代或最大成本上限。
閱讀完整文件:
commands/<cmd1>.md (或使用:/ecc-guide <cmd1>)
範例
目錄: /ecc-recipes → 印出家族表格與總數。
比對: /ecc-recipes 預先規劃整個應用程式,然後自動建置並搭配對抗性審查,直到完成 → 最佳比對:loop-*(自主)包覆 gan-* 或 santa-loop(對抗性)。執行順序:plan-prd 再 loop-start rfc-dag --mode safe 再監控 loop-status;停止條件:所有單元連續通過審查 N 次(加入最大迭代上限以控制用量)。
比對: /ecc-recipes 修復我的 Go 服務中的錯誤 → 最佳比對:orch-fix-defect(重現、修正、審查、提交)。備選:go-test 再 go-build 再 go-review。停止條件:回歸測試通過且審查通過。
非目標
- 非執行工具 — 僅供建議。
- 非單一指令的詳細文件 — 那是
ecc-guide。 - 非提示改寫 — 那是
prompt-optimizer。 - 絕不硬編碼指令計數或成員清單 — 始終即時讀取。