diff --git a/AGENTS.md b/AGENTS.md index c0569c0..ebba66c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,6 +28,8 @@ ## 慣例 - **零外部套件**:`package.json` 不得出現 `dependencies` 或 `devDependencies`。測試用 Node 內建 `node:test` + `node:assert`。 +- **委派標記雙向一致**:流程正本的 `〔可委派〕` 集合必須與 `references/delegation.md` 相同;任何變更同步更新資產測試與 ADR。 +- **文字編碼**:流程正本、規則正本、README、AGENTS.md 與 ADR 一律以 UTF-8 儲存,面向使用者的文字維持繁體中文。 - **契約以議題為正本**:腳本的 flag 介面、JSON 輸出形狀、前置檢查與路徑定位規則,正本在[議題 #1](https://gitea.jsc.idv.tw/plugins/tea-sdlc/issues/1),實作時以該處為準;本檔不複寫,以免兩邊走鐘。 - **測試**:`npm test`(等同 `node --test`)。測試產生的暫存一律寫到 `.tmp/`,該目錄已被 git 忽略,也不會被測試探索掃到。 - **不改目標專案**:本 plugin 只讀目標專案的程式碼,不寫入目標專案的 `CLAUDE.md` 或任何設定檔。 diff --git a/README.md b/README.md index 76894d2..91f8fcc 100644 --- a/README.md +++ b/README.md @@ -7,8 +7,10 @@ - **副作用集中**:所有對 Gitea 與 git 的呼叫下沉到 `scripts/` 的零相依 Node 腳本,統一 JSON 輸入輸出。 - **產出有固定形狀**:議題、PR、報表一律套 `templates/` 的模板。 -> 六個流程正本都到齊了,`tea-sdlc install` 會把它們一次佈署到偵測到的平台。 -> 完整需求見[議題 #1](https://gitea.jsc.idv.tw/plugins/tea-sdlc/issues/1),進度見其底下的工作包。 +> 六個流程正本都到齊了;`tea-sdlc install` 會把它們一次佈署到偵測到的平台。委派標記以 +> `references/delegation.md` 為對照正本,資產測試會檢查雙向一致;流程與文件均以 UTF-8 +> 儲存並維持繁體中文。進度見 +> [議題 #1](https://gitea.jsc.idv.tw/plugins/tea-sdlc/issues/1) 底下的工作包。 --- @@ -41,6 +43,7 @@ tea-sdlc/ ├── plugin.json # Antigravity 的 plugin manifest ├── package.json # npm 打包與測試入口,無任何相依套件 ├── AGENTS.md # 給 AI 助理的模組邊界與慣例 +├── docs/adr/ # 已接受的架構決策紀錄 └── README.md ``` diff --git a/docs/adr/0002-以能力描述而非工具名表達委派.md b/docs/adr/0002-以能力描述而非工具名表達委派.md index 6b582a1..2230e2d 100644 --- a/docs/adr/0002-以能力描述而非工具名表達委派.md +++ b/docs/adr/0002-以能力描述而非工具名表達委派.md @@ -5,6 +5,7 @@ status: accepted # 以能力描述而非工具名表達委派 流程正本在只在意結果的步驟上標記 `〔可委派〕`,並以**能力描述**說明怎麼委派——「你的環境若能把工作交給子代理,就交出去,只把結果帶回來;不能就自己做」——而不指名任何平台的子代理工具。子代理是平台專屬能力(Claude Code 與 Codex 有,Copilot/Kiro/OpenCode 不一定),而流程正本必須保持平台中立:這是 #4 已交付並打勾的驗收標準,也是 `AGENTS.md` 的模組邊界之一。能力描述對不支援的平台是自然降級,同一份正本兩邊都讀得通,不需要維護兩份。 +目前的標記集合是:`sdlc-plan` 列出九段落依據與缺漏、`sdlc-analyze` 對四份清單列出疑點與算出截止日,以及 `sdlc-feat` 把議題標題翻成英文與計算分批提交方案。分批提交的實際執行仍由主流程處理;完整對照以 `references/delegation.md` 為準。 ## Considered Options