claude-dev-skill

claude-dev-skill 是什麼？

claude-dev-skill 是 Claude Code 的自訂技能，將 Claude 轉化為使用多個 AI 工程代理建構軟體的「技術領導」流程。該技能提供結構化的多階段工作流程，在隔離的工作樹中協調平行工程工作，透過 PR 和審查路由變更，以減少上下文遺失和合併衝突。

其核心目的是超越單執行緒程式碼生成：引導需求對齊（PRD）、架構決策、任務分解、平行實作、靜態 QA 檢查，以及結構化的 PR 審查/合併步驟。

/dev 指令工作流程（多階段 SOP）：從請求分類開始，執行 PRD 對齊、架構與議題建立、工程實作、QA 驗證，以及 PR 合併協調。
技術領導路由規則：主對話視為協調者；「絕不直接寫程式碼」，變更必須透過 Worker Agent → PR → 審查流程。
透過工作樹的平行工程代理：產生多個工程代理，在隔離的工作樹中平行開發，以支援功能的不同部分（例如 auth、API、前端）。
實作前衝突掃描：工作開始前，工程代理掃描其他開放議題的檔案重疊，以提早偵測潛在衝突。
合併後 PR 協調：合併後，掃描開放 PR 並通知需 rebase 的分支。
審查前安全閘門：強制執行安全工具（例如 Python 的 bandit 加上 pip-audit，或 Node 的 npm audit）作為審查前必要步驟。
結構化 PR 審查檢查清單與否決條件：程式碼審查透過 7 項檢查清單執行，包含強制否決條件。
測試涵蓋的反例自我檢查：包含六類自我檢查，確保工程代理考量 Null/Empty/邊界/外部失敗/並發/惡意輸入情境。

安裝技能檔案 至 Claude Code 的 commands 目錄（macOS/Linux/Windows 的腳本安裝，或手動複製並保留目錄結構）。
確保已登入 Claude Code (Anthropic 官方 CLI)。
使用已認證的 GitHub CLI (gh)（先執行 gh auth login）。
在 Claude Code 中執行 /dev [選填描述]。技能將分類請求（例如新專案、新功能、bug 修正、hotfix、架構變更、重構）並進入適當流程。

典型執行遵循儲存庫所示階段：PRD 對齊（兩輪）、架構與任務分解（使用 GitHub Issues）、平行工作樹中的工程執行、QA 靜態驗證，以及清單導向的 PR 審查與合併。

使用既有 PRD 建構中小型網頁後端功能：使用 /dev 將既有產品需求文件轉譯為架構決策、GitHub Issues 與平行工程實作。
同時實作多模組並最小化合併衝突：讓獨立工程代理處理不同元件（例如認證 vs. 任務 CRUD API vs. 前端元件），依賴實作前衝突掃描與合併後 rebase 協調。
協調 bug 修正或 hotfix 工作：針對 bug 修正或緊急 hotfix，流程分類請求類型並路由至架構審查、工程變更、QA 驗證與結構化 PR 合併。
具結構化審查的系統性重構：重構時，SOP 的反例自我檢查與合併前安全閘門有助確保工程代理考量邊緣案例並執行必要審計工具後再審查。
需對齊後才編碼的架構變更工作：使用第 1 階段 PRD 對齊與第 2 階段架構決策，確保團隊計劃明確後再由工程代理開始實作。

此技能工作流程中的「tech lead」是什麼意思？ 主要對話扮演協調者角色：對齊 PRD、決定架構方向、產生 worker agents，並強制程式碼變更透過 Worker Agent PR 與審查流程，而非直接在聊天中編輯。
claude-dev-skill 會從主要對話直接撰寫程式碼嗎？ 不會。此工作流程包含「鐵律」，主要對話絕不直接撰寫程式碼；變更應透過 Worker Agent 後再經 PR 審查。
平行開發時如何處理衝突？ 此技能包含編碼前衝突掃描（worker agents 在開始前檢查開放 Issues 的檔案重疊），以及合併後步驟掃描開放 PR 以識別需 rebase 的分支。
強制哪些安全性檢查？ 在審查階段前，強制執行安全性工具，例如 Python 的 bandit 加上 pip-audit，或 Node 的 npm audit，依據儲存庫的安全閘描述。
這適合用於生產部署工作嗎？ 儲存庫範圍註明不適合需要生產部署的專案，因為不提供 DevOps/部署功能。

單一代理程式碼助理（自動完成/聊天式）：這些專注從提示直接撰寫程式碼，但通常不提供多代理、從 PRD 到 PR 的工作流程與強制審查閘。
傳統多步驟提示 + 手動 PR 工作流程：您可自行提示 Claude 分解任務並手動執行 worker，但會失去內建 SOP 結構（分類、衝突掃描、QA 與檢查清單審查協調）。
標準 GitHub 驅動團隊工作流程（無 AI SOP 的 Issues/PRs）：團隊可使用 GitHub Issues 與 PR 審查複製部分流程，但無法提供相同「worker agent」平行化與自動階段路由。
其他專注規劃或測試的 Claude Code 自訂技能：有些技能僅針對工作流程單一部份（例如測試產生），而非端到端協調平行 worker agents，整合與合併協調仍需使用者自行處理。