阶段 1：Bootstrap - 结构化产品想法

Bootstrap 是 Agent App Factory 流水线的第一个阶段，负责将你模糊的产品想法整理成清晰的 input/idea.md 文档。这是后续 PRD、UI、Tech 等所有阶段的起点，决定了整个项目的方向和质量。

学完你能做什么

• 将模糊的产品想法整理为符合标准模板的 input/idea.md 文档
• 理解 Bootstrap Agent 的职责边界（只收集信息，不创造需求）
• 知道如何使用 superpowers:brainstorm 技能深入挖掘产品想法
• 能够判断什么信息应该包含在 Bootstrap 阶段，什么不该包含

你现在的困境

你可能有一个产品想法，但描述得很模糊：

• "我想做一个健身应用"（太泛）
• "做一个像小红书一样的应用"（没说差异化）
• "用户需要一个更好的任务管理工具"（没说具体问题）

这种模糊的描述会导致后续阶段（PRD、UI、Tech）缺乏明确的输入，最终生成的应用可能完全偏离你的预期。

什么时候用这一招

当你准备好启动流水线，并且满足以下条件时：

1. 有一个初步的产品想法（哪怕只是一句话）
2. 还没开始写需求文档（PRD 在后续阶段）
3. 还没决定技术栈或 UI 风格（这些在后续阶段）
4. 希望控制产品范围，避免过度设计（Bootstrap 阶段会明确非目标）

🎒 开始前的准备

前置条件

在开始 Bootstrap 阶段前，请确保：

• ✅ 已完成 项目初始化
• ✅ 已了解 7 阶段流水线概览
• ✅ 已安装并配置好 AI 助手（推荐 Claude Code）
• ✅ 已准备好你的产品想法（哪怕是模糊的）

核心思路

什么是 Bootstrap 阶段？

Bootstrap 是整个流水线的起点，它的唯一职责是将碎片化的产品想法整理为结构化的文档。

不是产品经理

Bootstrap Agent 不是产品经理，它不会替你创造需求或设计功能。它的任务是：

• 收集你已经提供的信息
• 梳理并组织这些信息
• 按照标准模板呈现

它不会决定"应该有什么功能"，只会帮你把"你想要什么"说清楚。

为什么要结构化？

想象一下，你告诉厨师："我想吃点好吃的"

• ❌ 模糊的描述：厨师只能猜测，可能做出你完全不想吃的菜
• ✅ 结构化的描述："我想要一道辣的、不放香菜的川菜，希望能下饭"

Bootstrap 阶段就是把"我想吃点好吃的"变成"辣的、不放香菜的川菜"。

输出文档结构

Bootstrap 阶段会生成 input/idea.md，包含以下章节：

章节	内容	示例
简要描述	1-2 句话概括产品	"一个移动端记账应用，帮助年轻人快速记录日常支出"
问题 (Problem)	用户遇到的核心痛点	"年轻人月底发现超支，但不知道钱花在哪"
目标用户 (Target User)	具体的人群画像	"18-30 岁刚工作的年轻人，技术能力中等"
核心价值 (Core Value)	为什么有价值	"3 秒记账，比手动查询节省 80% 时间"
假设 (Assumptions)	2-4 条可验证的假设	"用户愿意花 2 分钟学习应用，如果能控制预算"
非目标 (Non‑Goals)	明确不做什么	"不做预算规划和财务建议"

跟我操作

第 1 步：准备你的产品想法

在开始流水线前，先想清楚你的产品想法。可以是一个完整的描述，也可以只是一个简单的想法。

示例：

我想做一个健身应用，帮助健身新手记录训练，包括运动类型、时长、卡路里，还能查看本周统计。

想法可以很粗糙

哪怕只是一句话也没关系，Bootstrap Agent 会通过 superpowers:brainstorm 技能帮你补充完整信息。

第 2 步：启动流水线到 Bootstrap 阶段

在 Factory 项目目录中执行：

# 启动流水线（如果还没启动）
factory run

# 或直接指定从 bootstrap 开始
factory run bootstrap

CLI 会显示当前状态和可用阶段。

第 3 步：AI 助手读取 Bootstrap Agent 定义

AI 助手（如 Claude Code）会自动读取 agents/bootstrap.agent.md，了解其职责和约束。

Agent 职责

Bootstrap Agent 只能：

• 读取用户在对话中提供的产品想法
• 写入 input/idea.md

它不能：

• 读取其他文件
• 写入其他目录
• 创造新需求

第 4 步：强制使用 superpowers:brainstorm 技能

这是 Bootstrap 阶段的关键步骤。AI 助手必须先调用 superpowers:brainstorm 技能，即使你认为信息已经很完整。

brainstorm 技能的作用：

1. 深入挖掘问题本质：通过结构化提问发现你描述中的盲点
2. 明确目标用户画像：帮你想清楚"到底卖给谁"
3. 验证核心价值：通过对比竞品找到差异化
4. 识别隐含假设：列出那些你默认但未经验证的假设
5. 控制产品范围：通过非目标明确边界

AI 助手会做什么：

• 调用 superpowers:brainstorm 技能
• 提供你的原始想法
• 通过技能生成的问题向你提问
• 收集你的回答并完善想法

跳过此步骤会被拒绝

Sisyphus 调度器会验证是否使用了 brainstorm 技能。如果没有，Bootstrap Agent 生成的产物会被拒绝，需要重新执行。

第 5 步：确认 idea.md 内容

Bootstrap Agent 完成后，会生成 input/idea.md。你需要仔细检查：

检查点 ✅：

1. 简要描述是否清晰？

   • ✅ 包含：做什么 + 为谁做 + 解决什么问题
   • ❌ 太泛："一个提高效率的工具"

2. 问题描述是否具体？

   • ✅ 包含：场景 + 困难 + 负面结果
   • ❌ 空泛："用户体验不好"

3. 目标用户是否明确？

   • ✅ 有具体画像（年龄/职业/技术能力）
   • ❌ 模糊："所有人"

4. 核心价值是否可量化？

   • ✅ 有具体收益（节省 80% 时间）
   • ❌ 空泛："提升效率"

5. 假设是否可验证？

   • ✅ 可通过用户调研验证
   • ❌ 主观判断："用户会喜欢"

6. 非目标是否充分？

   • ✅ 至少列出 3 项不做的功能
   • ❌ 缺失或太少

第 6 步：选择继续、重试或暂停

确认无误后，CLI 会显示选项：

请选择操作：
[1] 继续（进入 PRD 阶段）
[2] 重试（重新生成 idea.md）
[3] 暂停（稍后继续）

建议先在代码编辑器中查看

在 AI 助手中确认前，先用代码编辑器打开 input/idea.md，逐字检查。一旦进入 PRD 阶段，修改成本会更高。

踩坑提醒

坑 1：想法描述太模糊

错误示例：

我想做一个健身应用

后果：Bootstrap Agent 会通过 brainstorm 技能问很多问题，补充信息。

建议：一开始就描述清楚：

我想做一个移动端健身应用，帮助健身新手记录训练，包括运动类型、时长、卡路里，还能查看本周统计。

坑 2：包含技术实现细节

错误示例：

我希望使用 React Native 构建，后端用 Express，数据库是 Prisma...

后果：Bootstrap Agent 会拒绝这些内容（它只收集产品想法，技术栈在 Tech 阶段决定）。

建议：只说"做什么"，不说"怎么做"。

坑 3：目标用户描述太泛

错误示例：

所有需要健身的人

后果：后续阶段无法明确设计方向。

建议：明确画像：

18-30 岁健身新手，刚开始系统训练，技术能力中等，希望简单记录和查看统计。

坑 4：非目标缺失或太少

错误示例：

非目标：无

后果：后续 PRD 和 Code 阶段可能过度设计，增加技术复杂度。

建议：至少列出 3 项：

非目标：
- 团队协作和社交功能（MVP 聚焦个人）
- 复杂的数据分析和报表
- 与第三方健身设备集成

坑 5：假设不可验证

错误示例：

假设：用户会喜欢我们的设计

后果：无法通过用户调研验证，MVP 可能失败。

建议：写可验证的假设：

假设：用户愿意花 5 分钟学习应用，如果能帮助系统记录训练。

本课小结

Bootstrap 阶段的核心是结构化：

1. 输入：你模糊的产品想法
2. 过程：AI 助手通过 superpowers:brainstorm 技能深入挖掘
3. 输出：符合标准模板的 input/idea.md
4. 验证：检查描述是否具体、用户是否明确、价值是否可量化

关键原则

• ❌ 不做什么：不创造需求、不设计功能、不决定技术栈
• ✅ 只做什么：收集信息、梳理组织、按模板呈现

下一课预告

下一课我们学习 阶段 2：PRD - 生成产品需求文档。

你会学到：

• 如何将 idea.md 转化为 MVP 级 PRD
• PRD 包含哪些内容（用户故事、功能列表、非功能需求）
• 如何明确 MVP 范围和优先级
• 为什么 PRD 不能包含技术细节

---

附录：源码参考

点击展开查看源码位置

更新时间：2026-01-29

功能	文件路径	行号
Bootstrap Agent 定义	agents/bootstrap.agent.md	1-93
Bootstrap Skill	skills/bootstrap/skill.md	1-433
流水线定义（Bootstrap 阶段）	pipeline.yaml	8-18
调度器定义	agents/orchestrator.checkpoint.md	1-100+

关键约束：

• 强制使用 brainstorm 技能：bootstrap.agent.md:70-71
• 禁止技术细节：bootstrap.agent.md:47
• 禁止合并多个想法：bootstrap.agent.md:48
• 输出文件必须保存到 input/idea.md：bootstrap.agent.md:50

退出条件（pipeline.yaml:15-18）：

• idea.md 存在
• idea.md 描述了一个连贯的产品想法
• Agent 已使用 superpowers:brainstorm 技能进行深入挖掘

Skill 内容框架：

• 思维框架：提取 vs 创造、问题优先、具体化、假设验证
• 提问模板：关于问题、目标用户、核心价值、MVP 假设、非目标
• 信息提取技巧：从功能反推问题、从抱怨提取需求、识别隐含假设
• 质量检查清单：完整性、具体性、一致性、禁止项
• 决策原则：优先提问、问题导向、具体优于抽象、可验证性、范围控制
• 常见场景处理：用户只提供一句话、描述很多功能、描述竞品、想法矛盾
• 示例对比：不好的 idea.md vs 好的 idea.md