project-bootstrap

Project Bootstrap

为新项目或已有项目建立精简的 AI-Human 协作框架。文档只记录代码里读不出来的决策，规则尽量由 hook 和 CI 强制执行。

用户输入： $ARGUMENTS

---

Phase 0: 判断模式

$ARGUMENTS 以 adopt 或 upgrade 开头时，使用指定模式。否则按以下顺序判断：

条件	模式
CLAUDE.md 含 <!-- project-bootstrap:2 -->	upgrade（只更新脚本）
存在 .claude/tech-spec-registry.md 或 .claude/sprint-plan.md	upgrade（迁移旧版结构）
已有提交或源代码	adopt
其他	new

---

Phase 1: 需求采集

目标： 理解项目的真实意图和边界。信息充足时快速确认，信息不足时多问几轮。不重复询问用户已经说过的内容。

adopt 模式先读取仓库：README、CLAUDE.md、依赖清单、CI 配置、git tag 和已有钩子。能从仓库得出的信息不再询问。

如果用户提供了文档路径，先读取文档并提取信息。然后向用户确认，并补充遗漏项。

必须明确的信息

只有这 4 项不够明确时才提问，一次问完：

1. 做什么 — 项目名称、解决什么问题、给谁用
2. 技术栈 — 语言、框架、数据库、部署方式
3. 团队规模 — 几个人开发，AI 占多大比重
4. 决策权 — 哪些事情由谁决定

其余内容不单独提问：

• 代号从项目名称得出。
• 交付阶段由你根据目标拟定，放进确认摘要。
• 约束、合规要求和文档语言，只记录用户提到或文档中写明的内容。
• 是否启用可选模块，根据以上信息判断。

确认

将收集到的信息整理成简要摘要，展示给用户确认，并说明拟定的交付阶段和将启用的可选模块。用户明确表示不用确认时，可跳过这一步。

进入 Phase 2 的条件： 以上 4 项都已明确。

---

Phase 2: 文件生成

生成规则

• 所有 {占位符} 都替换为实际内容。不适用的章节直接删除，不标注“不适用”。
• 只写用户提供或仓库中确认的事实。没有依据的性能指标、覆盖率等阈值不要写。
• 文档语言跟随用户的对话语言，用户另有指定时除外。
• 不覆盖已有文件。 已有 README.md、CLAUDE.md 时保留原内容，只追加缺失的部分。原有规则与模板冲突时，保留原有规则。
• .claude/ 是受保护目录。写入被拒绝时，继续完成其余文件，最后列出未写入的文件。不要换用其他工具绕过。

生成文件清单

生成每个文件前，先读取对应的模板：

1. 目录不是 git 仓库时，执行 git init
2. docs/architecture.md — 读取 references/architecture-template.md
3. docs/plan.md — 读取 references/plan-template.md
4. README.md — 面向人类阅读：项目名称、架构、模块、技术栈、目录结构、路线图。不放 AI 协作内部细节。
5. CLAUDE.md — 读取 references/claude-md-template.md
6. 可选模块 — 读取 references/optional-modules.md，只生成符合启用条件的模块

---

Phase 3: 自动化

读取 references/scripts-template.md，生成：

1. scripts/hooks/block-git-push.sh 和 scripts/hooks/verify-on-stop.sh — 把测试命令填入后者。测试还跑不起来时留空，并在 docs/plan.md 第一个 Sprint 加一条 P0 任务：搭建测试，把命令填入 TEST_CMD。
2. .claude/settings.json — 已存在时合并 hooks 字段
3. scripts/version.sh 和 scripts/release.sh — adopt 模式下，项目已有版本机制（VERSION、package.json、非 vX.Y.0 形式的 tag）时跳过，继续沿用
4. .gitignore — 不存在时创建，存在时追加缺失项（.idea/, node_modules/, pycache/, .env 等）
5. 执行 chmod +x scripts/*.sh scripts/hooks/*.sh