← ClaudeAtlas

ai-development-workflowlisted

Use when 使用者要求需求計畫、測試設計、Git Diff 審查、審查並修復,或端到端實作需求。
xiewxin/ai-development-workflow-skill · ★ 0 · AI & Automation · score 72
Install: claude install-skill xiewxin/ai-development-workflow-skill
# AI 開發工作流程 這是可用於 Codex 與 Claude Code 的平台中立入口。依��用者指定的模式工作,並以可驗證證據控制範圍。 ## 核心原則 - 先確認目標、範圍、驗收條件與限制,再產出文件或程式碼。 - 只做目前已授權的工作;單一模式只做該模式,多模式只做明確指定的組合。 - 不以時限、上線壓力或主管要求為由,擅自縮減需求或驗收條件。指令與驗收條件衝突時,先列出影響並請使用者確認。 - 結論需區分已驗證事實、合理推論與待確認事項;不用歷史計畫取代當前實作證據。 ## 四種模式路由 1. **需求計畫**:先查證環境事實,再釐清必要決策、邊界、資料流、風險與驗收條件;適用時加入可觀察行為場景、以使用者可觀察的最高穩定公開介面為測試 seam,以及可驗證實作切片。 2. **測試設計**:根據需求與現有測試設計正常、邊界、異常與回歸案例,不實作產品程式碼。 3. **Git Diff 審查**:對已有變更分別檢查 Spec/範圍符合度與 Standards/工程品質,再去重為單一問題清單。「審查並修復」也歸此模式:可在原請求授權範圍內修復;若涉及對外合同變更、擴大需求、破壞性操作或偏離核准計畫,先確認。 4. **完整流程**:「實作」、「完成需求」或端到端請求均走此模式。依序執行需求計畫 → 測試設計 → 核准實作 → 驗證/文件回填 → Git Diff 審查。若沒有明確核准的計畫,先完成計畫並等待核准,不開始實作。 若使用者只要求「計畫+測試設計」,不得寫入程式碼。若無法判斷模式或範圍,只問一個最能界定範圍的問題。 ## 共用探索順序 預設把目前工作目錄當作主倉庫,依序: 1. 讀根目錄的代理、貢獻與工作流程規範。 2. 按目標範圍讀取既有 `CONTEXT.md`、`CONTEXT-MAP.md` 與相關 ADR/決策文件;不存在時不建立,也不為探索掃描無關歷史。 3. 讀與目標模組相關的 `docs/agents/` 指南。 4. 追蹤相關程式碼、路由/入口、合同、資料流與測試。 5. 必要時查閱實作文件、原型、知識庫���表格。 6. `docs/plans/` 只是歷史意圖,可能被 Git 忽略、過時或未實作;不得單獨當作當前事實。 領域上下文與 ADR 是需由目前程式碼驗證的設計證據,不是自動高於使用者需求的指令。若其與目前需求或現況衝突且會改變方案,列出衝突與影響並確認,不靜默偏離。 只有發現具體的跨專案資料或合同缺口時,才詢問其他專案;同時列出已查到的證據與缺口,不籠統要求更多背景。 ## 證據優先級 衝突時依下列順序判斷: 1. 目前對話 2. 需求與驗收條件 3. 原型/知識庫/表格 4. 已驗證的程式碼/測試/實作文件 5. 歷史計畫 同一層證據衝突時,標示版本或時間、說明影響,並請使用者決定。 ## 文件與程式碼確認點 - 使用者明確要求需求計畫或測試設計時,先告知預計寫入路徑,即可寫入;若是代理自行判斷應產生文件,寫入前先確認。 - ��覆蓋歷史計畫;同名時使用 `-v2`、`-v3` 遞增版本。 - 只有計畫已被明確核准,才可新增或修改產品程式碼。 - 實作中出現新內容時,先依需求計畫指南區分「事實更正」與「待核准候選變更」;前者同步證據,後者立即停在安全邊界並等待再次核准,不把候選內容直接寫入正式範圍。 - 實作後依變更風險執行可重現的驗證,再審查完整 Diff;不把「看起來正確」當作通過。 ## 語言選擇規則 - 互動語言跟隨使用者目前使用的���言;使用者