dev-workflow

整理 CHANGELOG（自上一版 tag 至 HEAD），依 Conventional Commits 分類、建議版號、產出草稿供使用者 review。先偵測該 repo 既有的 CHANGELOG 慣例（單語/雙語、單層/兩層明細）再沿用，不強加格式。當使用者提到「整理 CHANGELOG」、「準備發版」、「draft changelog」、「發 vX.Y.Z」、「下一版要發了」、「整理 release notes」之類情境時使用。**只產草稿，不 commit、不改版號檔、不打 tag。**

定期健檢 Claude Code 設定檔語料（CLAUDE.md、rules/、skills/、commands/、hooks、plugin、memory）—— 量測常駐 context 成本、抓失效引用與過期量化斷言、偵測跨檔衝突、判定「常駐 vs 按需」錯置、檢查 skill description 觸發重疊、plugin 版本漂移，以及自有 marketplace 兩份資訊清單的一致性。核心判準是「這段會不會改變下一個 session 的行為」，不是「長不長」。當使用者要「整理 CLAUDE.md」、「精簡 rules」、「設定檔健檢」、「config audit」、「skill 太多太亂」、「context 太肥」、「規則互相衝突」、「定期整理 .claude」之類需求時使用。**產出分級報告供逐項確認，不自動改寫規則。**

依照計畫文件（預設 docs/plans/，以 repo 約定為準）實作時的驗證閘門 —— 動筆前確認 plan 是最新版本（入版控的 plan 以 git 為準；gitignored 的 plan 重新讀檔，不用 session 早期讀過的快取）、宣告受影響檔案清單並於階段結束對帳、改完檢查是否存在未同步的平行實作路徑。當使用者要「實作這個 plan」、「執行 plan」、「照 plan 做」、「開始做階段 X」，或你即將依據某份 plan 動手改任何原始碼時使用。

撰寫 / 更新計畫文件（預設 docs/plans/，repo 的 CLAUDE.md 可另指定，例如 gitignored 的 local/plans/）—— 計畫目錄的判定、狀態列格式（✅ 已完成 / 🚧 進行中 / 📝 擬定中 + ISO 日期）、多階段 plan 的階段表格（階段 / 範圍 / 狀態）、整體狀態與階段狀態的對應規則、plan 內外的連結慣例（含「公開文件不得連結 plan」）、封存流程與封存目錄約定。當使用者要「寫一份 plan」、「擬計畫」、「更新 plan 狀態」、「標記 plan 完成」、「封存 plan」，或你即將建立 / 修改計畫目錄下任何文件、或要在 README / ADR / 對外文件裡引用 plan 時使用。

.NET / NuGet repo 的發版流程 —— 前置條件檢查、版號判定（含 analyzer 擋不到的破壞性變更兩類自檢）、四個步驟（CHANGELOG、版號檔、出貨基準 Unshipped→Shipped —— repo 有 analyzer 時是兩份不是一份、commit+tag）、以及「push main 與 push tag 分兩次、中間停一下」的不可逆閘門。當使用者要「發版」、「發 vX.Y.Z」、「release」、「準備出版本」、「打 tag 發佈」、「上 NuGet」之類需求時使用。**agent 不自動推送 tag——那步必須由使用者明確同意。**

把已定案的工作交接給新 session 接手下一步。**它規範的是流程不只是格式**：交接的第一個動作是把交接文件 commit（步驟，不是詢問；交接文件在 gitignored 目錄時例外：不 commit、絕不 git add -f、只能 local only），接著優先用 spawn task、否則輸出可複製 prompt，且 prompt 必須明寫工作樹與分支期望（worktree 或 local only），否則預設開的 worktree 會讀不到未 commit 的檔案。prompt 的必備區塊：交接文件路徑與 commit hash、「設計已定案」封印、出貨與順序約束、未驗證項目、環境前置、git 狀態、回報對象 session（做完把狀況送回哪裡）。**不限程式碼實作**：撰寫文章、重構、遷移、資料處理、文件改版都適用；**交接文件不限是 `docs/plans/` 的 plan**，可以是規格、規範文件組、或連載系列的大綱＋逐篇筆記＋寫作規則。當使用者要「開新 session 實作／撰寫這個 plan」、「開新 session 寫 X」、「接下來開新 session 寫下一篇」、「接著寫」、「開始實作了」、「把這個交出去做」、「另開 session 做這個」、「交接給新 session」、「換 session 接手」時使用，**不論下一步是寫程式還是寫文章、也不論有沒有一份叫 plan 的檔案**。