bootstrap

Bootstrap

价值： 沟通——在开始任何工作之前，建立对环境、能力和工作流的共同理解。

目的

在任何 harness 上配置 SDLC 工作流的单一入口。检测项目环境和 harness 能力，配置 TDD 模式（引导式或自动化），生成适用于 harness 的指令文件，并推荐技能。绝不会在未告知的情况下安装或修改任何内容。

实践

第 1 步：检测环境

提问前，静默收集项目上下文：

!test -f package.json && echo "js" || true
!test -f Cargo.toml && echo "rust" || true
!test -f pyproject.toml && echo "python" || true
!test -f go.mod && echo "go" || true
!test -f mix.exs && echo "elixir" || true
!git rev-parse --is-inside-work-tree 2>/dev/null && echo "git" || true
!ls skills/*/SKILL.md 2>/dev/null | sed 's|skills/||;s|/SKILL.md||' || true

记录：检测到的语言、git 是否可用、已安装的技能。如果未找到语言文件，记为“无”，并在第 5 步询问用户。

第 2 步：检测 Harness 能力

探测委派原语（参见 references/capability-detection.md）： 检查 Agent 工具和技能链式调用（始终可用）。

第 3 步：检测 Harness 类型

识别 harness，以生成正确的指令文件：

信号	Harness
CLAUDE.md 约定、Claude Code 工具	Claude Code
AGENTS.md 约定、Codex 工具	Codex
.cursor/rules 目录	Cursor / Windsurf
以上都不符合	通用（仅 AGENTS.md）

第 4 步：配置 TDD 模式

根据检测到的能力匹配策略：

检测到的能力	策略	默认模式
Agent 工具	子 Agent	自动化
两者都没有	链式调用	自动化

链式调用始终可用，并会在单一上下文中按顺序运行所有 TDD 阶段。引导模式（/tdd red、/tdd green 等）始终可用，作为由用户控制的替代方案。允许用户更改选择。

如果检测到 Claude Code，且用户希望最大程度地强制执行规范，则可提出安装可选的钩子模板，路径为 skills/tdd/references/hooks/。

第 4b 步：检测工厂模式

检查是否已安装 pipeline 技能（skills/pipeline/SKILL.md 是否存在）。如果检测到，则可使用工厂流水线模式，并在第 5 步增加一个问题。

第 5 步：询问用户

问题 1：你想做什么？

• “启动新项目”——推荐 Understand + Decide + Build 阶段
• “添加功能或修复错误”——推荐 Build + Ship 阶段
• “设置团队工作流”——推荐所有阶段以及 ensemble 团队

问题 2：需要多大程度的流程规范？

• “最低限度”——推荐 tdd、domain-modeling
• “标准”——推荐核心技能 + ship 技能
• “完整”——推荐所有技能（检测到 pipeline 时，包含工厂流水线技能）

问题 3（仅在检测到 pipeline 时）：自主程度如何？ 保守 / 标准 / 完整。使用选定的级别生成 .factory/config.yaml。技能列表参见 references/skill-recommendations.md。

第 6 步：任务跟踪约定

在生成的指令文件中说明，Agent 应使用任务列表（TaskCreate、TaskList 或等效的 harness 工具）跟踪工作，即使是看起来很简单的任务也应如此。简单任务往往会暴露子任务，而可见的任务列表有助于清晰展示进度并避免遗漏步骤。

此约定应写入 AGENTS.md 的“约定”部分（参见 references/agents-md.md）。如果已安装 task-management 技能，请引用它；否则，直接写入基本约定。

步骤 7：收集各技能对 AGENTS.md 的贡献

部分已安装技能会附带 references/agents-md-setup.md 文件，其中指定了要添加到 AGENTS.md 的内容。扫描所有已安装的技能，查找此文件：

!for skill in skills/*/; do
  test -f "${skill}references/agents-md-setup.md" && echo "${skill}"
done

对于找到此文件的每个技能，读取其 agents-md-setup.md，并使用该技能的托管标记（``）将指定内容纳入 AGENTS.md。设置文件会说明要添加或追加到哪个章节，并提供内容模板。

**大小预算：**AGENTS.md 的总大小必须小于 32 KiB。各技能的贡献应简洁——几条项目符号或一个简短章节即可。如果合并后的内容会超出预算，请进行概述，并指向相关技能以获取详细信息，而不是加入完整内容。

步骤 8：生成指令文件

生成适用于相应 harness 的文件。对于 Claude Code，CLAUDE.md 使用 @AGENTS.md 引用，而不是符号链接或嵌入内容，以保持单一事实来源并避免重复。AGENTS.md 的最佳实践（精简的路由文档、渐进式披露、托管标记）请参阅 references/agents-md.md；各 harness 专属的生成规则请参阅 references/harness-files.md。

步骤 9：可选的 Ensemble 团队

如果用户选择了“设置团队工作流”或“完整”，请提供包含三种预设（solo-plus、lean、full）的 ensemble-team 技能。

步骤 10：提交并展示

暂存生成的文件，使用描述性消息提交，并展示：

• 配置内容（harness、TDD 模式、推荐的技能）
• 后续步骤（使用 /tdd 开始一个 TDD 周期，或使用特定阶段的命令）
• 如果配置了 ensemble 团队，说明所选预设和成员数量

强制执行说明

所有模式下均为建议性操作。Bootstrap 会检测并提供建议；绝不会在用户不知情的情况下进行修改。未经用户明确确认 [H]，不会安装任何技能或设置。

约束

• “绝不静默安装” [H]：“覆盖”意味着用户明确表示“是，安装 X”，而不是根据上下文推断用户已授权。
• AGENTS.md 32 KiB 预算：这是硬性上限，而非目标。请进行概述以符合限制。

验证

• 在提问前已检测环境
• 已探测 harness 的功能（而非自行假定）
• 提问不超过 2-3 个
• TDD 策略与检测到的功能相符（参见步骤 4 的表格）
• 生成的文件使用托管标记，确保可以安全地重新运行
• 生成的 AGENTS.md 中包含任务跟踪约定
• 已收集并纳入各技能对 AGENTS.md 的贡献
• 未经用户确认未安装任何内容

依赖项

此技能可独立运行。它会推荐其他技能，但不要求安装。它会生成引用 tdd 技能进行 TDD 工作流的配置。