claude-code-project-bootstrap

此工具包簡化了 Claude Code 軟體開發專案的啟動與維護流程。它提供了一個自動化設定嚮導，處理從初始化 Git 與 GitHub 儲存庫到建立保護性鉤子 (Hooks) 的繁瑣配置。專為開發者與自動化代理設計，確保 Claude 在安全的環境中運行，透過防止破壞性指令、強制執行提交規範以及整合秘密掃描來防止敏感憑證外洩。除了初始化功能，此工具包還包含審計機制，可根據 45 項最佳實踐清單檢查現有專案，識別安全漏洞、缺失的設定檔或效率低下的工作流程。它同時提供結構化專案規劃模組，生成多階段開發的階層式文件架構，有效追蹤需求、架構決策與程式碼分析。本系統不限技術棧，適用於 Node/TypeScript, Python, Rust, Go 與 Swift 等多種開發環境。

• 提供互動式 /bootstrap 嚮導，用於建立儲存庫、README、CLAUDE.md 文件與目錄骨架。

• 針對 PreToolUse, PostToolUse 與 SessionStart 生命週期觸發器的高級鉤子管理。

• 安全防護欄：防止遞迴強制刪除、硬重置與意外推送至主分支。

• 內建秘密保護機制，掃描 API 金鑰（如 Anthropic, GitHub, AWS）、硬編碼憑證與私鑰材料。

• 自動化維護鉤子，包括提交前的建構閘門與多語言程式碼自動格式化。

• 完整的 /audit-project 指令，用於驗證 Git、鉤子、設定檔與文件的完整性。

• 結構化的專案路線圖與規劃模組 (/init-planning)，透過 .planning 目錄進行階段追蹤。

• 建議安裝 gh CLI 以完整實現 GitHub 儲存庫建立與遠端同步的自動化。

• 啟動嚮導時需準備專案名稱、技術棧偏好與儲存庫公開性設定。

• 鉤子設計盡量避免阻斷，針對非關鍵問題提供輕度警告，並對破壞性操作進行硬性阻擋。

• 系統利用 .claude/settings.json 進行鉤子佈線，並支援 .claude/settings.local.json 進行不應提交至原始碼控管的使用者特定配置。

• 最適合希望標準化 Claude Code 與其專案程式碼庫互動模型的開發團隊與個人。