crd

crd 技能是一種專為既有軟體開發（Brownfield Development）設計的協調工具，旨在簡化在現有程式碼庫中請求與實作變更的流程。它作為開發者意圖與結構化行動任務計畫之間的主要橋樑。透過自動化文件編寫與影響評估階段，它能協助工程團隊維持清晰的架構邊界與一致的專案後設資料。

此技能的核心在於管理 Git 歷史紀錄與文件之間的關係。它透過與 PROJECT.md 檔案互動，利用雜湊值（hashes）追蹤程式碼庫狀態，確保背景知識與最新提交保持同步。當使用者提出變更需求（例如新增功能、修改現有模組或重構程式碼）時，該技能會自動觸發影響分析，找出受影響的元件，讓開發者在開始實作前擁有明確的作業範圍。這種預先處理的方法有助於預防技術債，並減少處理複雜程式碼修改時的認知負擔。

• 使用 PROJECT.md 進行自動化背景知識管理，為既有專案維護最新的說明文件。

• 無縫整合 Git，用於驗證儲存庫狀態並透過 Diff 處理背景知識更新。

• 支援基於關鍵字的變更分類（新增功能、修改功能、移除功能、重構），以標準化開發任務。

• 整合影響分析功能，評估建議變更對現有程式碼結構的潛在連鎖反應。

• 互動式需求擷取，包含驗收標準（Given/When/Then）的生成。

• 自動生成結構化的 CRD Markdown 文件並儲存於 docs/crd 目錄中。

• 內建支援在開發工作流程中列出與追蹤 CRD 的狀態。

• 必須指定有效的 Git 儲存庫作為目標專案路徑。

• 適合軟體工程師與專案負責人，用於管理需要結構化變更流程的現有專案。

• 作為無狀態（stateless）技能運作，所有狀態直接保存在專案儲存庫中（PROJECT.md 與 CRD 檔案）。

• 是更大規模 /breakdown 與 /execute 工作流程的基礎依賴。

• 建議搭配 /crd-investigate 與 /crd-impact-analysis 使用，以達到完整的生態系覆蓋。

• 有助於為企業級功能請求維持清晰的稽核軌跡與需求追蹤。