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 与其项目代码库互动模型的开发团队与个人。