用途
Shape Up 是一个对话式软件需求挖掘技能，用于把模糊的产品想法转化为结构化的「成形规格」（shaped specification）。它会驱动一场结构化的启发式对话，最终产出一份计划模式（plan-mode）产物——成形规格。对话负责浮现意图，产物则把意图编码下来以供实现。
该技能受 Basecamp / Ryan Singer 的 Shape Up 方法影响：胃口优先（appetite-first）的框架、在元素层面给出解决方案、明确标注兔子洞（rabbit holes）与禁区（no-gos）。输出是一份 pitch——粗略、已解决、有边界——而不是一份详尽的 SRS（软件需求规格说明书）。
两大阶段
整个过程通过可用的任务跟踪工具在启发、门禁检查与规格化之间推进进度。
阶段一——启发（Elicitation）。 由 Claude 主导的开放式对话，进行合成、追问、用内联图示说明，并使用 AskUserQuestion 处理结构化权衡。通过自然对话遵循成形流程浮现六大要素：设定边界、寻找元素、处理风险、收敛。
阶段二——规格化（Specification）。 进入 plan 模式，将成形规格写为计划文件。阶段一中的任何内容都不会作为对话残留物存活下来，产物是独立自洽的。
上下文加载
仅在当前阶段需要时加载参考资料。
| 阶段 | 加载 | 不要加载 |
|---|---|---|
| 启发（开场） | references/elicitation-guide.md | 其它全部 |
| 启发（首次交流后） | references/audience-adaptation.md | gate-checklist、spec-production |
| 启发（复杂/模糊问题） | references/shaping-techniques.md | gate-checklist、spec-production |
| 启发（实体浮现） | references/domain-modeling.md | gate-checklist、spec-production |
| 门禁检查 | references/gate-checklist.md | elicitation-guide、spec-production |
| 规格化 | references/spec-production.md | elicitation-guide、gate-checklist |
随着对话演进，可以并发加载多个启发参考资料。只加载对话实际需要的内容。
阶段一：启发
加载 references/elicitation-guide.md 并遵循其协议。
启发式对话会浮现六大要素：
- 问题（Problem） —— 一个具体故事，展示当前坏掉的现状。谁受影响，没有这个系统今天会发生什么。
- 胃口（Appetite） —— 时间预算以及它对范围意味着什么。这不是估算，而是关于「这件事值多少」的有意选择。
- 解决方案（Solution） —— 带职责的具名元素。关键交互流程处于粗线条（fat-marker）级别——足够具体能据此构建，又足够粗略留有空间。
- 兔子洞（Rabbit Holes） —— 识别出的具体风险，并用前置决策打补丁。技术未知项标记为待 spike。
- 禁区（No-Gos） —— 明确排除项，防止构建过程中的范围蔓延。比「超出范围」更锋利。
- 边界（Boundaries） —— 非功能性约束、必备项与锦上添花项、以基线为参照衡量的成功标准。
利益相关者在「问题」中自然浮现。对于复杂问题，领域会按需通过 references/domain-modeling.md 加载。验收标准以内嵌于「边界」的方式呈现，即成功 vs. 基线。
受众校准
首次实质性交流后，加载 references/audience-adaptation.md。从用户的语言和框架判断其是客户、工程师还是 PM——而不是从他们的头衔判断。相应地调整词汇、可视化风格和重点。当信号变化时重新校准。
成形流程
- 开场 —— 理解原始想法：什么坏了、谁在意、是什么触发了这件事
- 设定边界 —— 尽早浮现胃口和禁区。胃口制约下游的一切。
- 寻找元素 —— 具名组件与交互流程，而不是功能清单。对于复杂或模糊的问题，加载 references/shaping-techniques.md。
- 处理风险 —— 主动探查兔子洞。当实体与不变量浮现时，加载 references/domain-modeling.md。
- 收敛 —— 当问题不再产生新信息时察觉它。明确陈述这一观察。
退出条件
按顺序应用全部三项：
- 收敛检测。 当回答是在确认而非增加信息时察觉它。明确陈述这一观察。
- 门禁检查。 加载 references/gate-checklist.md。验证每一道门禁。向用户呈现通过/失败。
- 明确批准。 在产出规格前停下并请求确认。未经用户「开始」绝不继续。
阶段二：规格化
加载 references/spec-production.md。
在进入 plan 模式之前，询问用户：「这份规格应保存到哪里？」记录目标路径。
进入 plan 模式。写入计划文件，包含一段执行前言（目标路径与动作指令）随后是规格内容。计划必须自洽——一个新会话读取它就知道确切的要做什么，无需启发上下文。
退出 plan 模式供用户审阅。
规模适配
- 小功能： 问题 + 胃口 + 解决方案 + 禁区。轻量边界。跳过领域。
- 中等项目： 完整模板。
- 大型系统： 完整模板，解决方案元素按领域分组。
规则
- 启发是对话，不是表单。去探索、反映、让用户纠正。不要用要素清单去盘问。
- 未经明确批准绝不产出规格。门禁清单是必要但不充分的。用户的确认才是硬性停止点。
- Claude 主导。去合成、提议、探查。不是问「还有什么？」，而是「基于 X，我认为是 Y——对吗？」
- 对话内容是短暂的。解释、图示、AskUserQuestion 交互都不会出现在规格产物中。
- 适应受众，而不是角色。从语言检测，当信号变化时重新校准。
- 不要在启发期间解决问题。浮现元素和流程，而不是架构。「处理 1 万用户」是边界。「使用 Redis」是解决方案。
- 让隐含变的显式。命名隐含的需求：「那意味着需要认证——我们应该纳入它，还是把它算作兔子洞？」
- 仅对结构化权衡使用 AskUserQuestion。胃口定档、优先级裁决、边界决策、风险打补丁。
- 胃口先于解决方案。永远在探索构建什么之前，先浮现这件事值多少。
附加资源
参考文件
- references/elicitation-guide.md —— 阶段一的对话协议：开场问题、六大要素、可视化模式、收敛检测、反模式
- references/audience-adaptation.md —— 从语言检测客户 vs. 工程师 vs. PM；调整词汇与重点
- references/shaping-techniques.md —— 分解与探查技术：结果倒推、一天生活、面包板（breadboarding）、兔子洞浮现等
- references/gate-checklist.md —— 在规格产出前验证启发完整性的八道门禁
- references/spec-production.md —— Pitch 风格规格模板、逐节产出指令、规模适配指引
- references/domain-modeling.md —— 通过对话进行的轻量领域建模：实体、关系、不变量