tutorial

/ouroboros:tutorial

通过动手实践，交互式学习 Ouroboros。

用法

ooo tutorial
/ouroboros:tutorial

原则

1. 在前 30 秒内展示有用的内容。
2. 边做边学：用户回答有关自己想法的问题。
3. 逐步展示功能。
4. 每个阶段结束时，始终给出一个具体的下一步行动。
5. 匹配受众：面向技术用户，介绍 run、evaluate 和 evolve 的细节；面向非技术用户，则采用访谈和通俗易懂的表达。

流程（约 5 分钟）

1. 引入。 承诺在 5 分钟内将他们模糊的想法变成明确的规格，然后询问他们想构建什么。如果他们还没有想法，就以任务管理 CLI 为例。

2. 访谈。 围绕他们的想法提出 3-4 个苏格拉底式问题（它要解决的问题、主要用户、让它当下就有用的那项功能）。指出每个回答都揭示了他们之前未明确说出的一个假设。

3. 迷你 Seed。 用 Seed 术语总结他们的回答：

   Goal: <their goal, refined>
   Constraints: <2-3 constraints they named>
   Acceptance criteria: <2-3 checkable outcomes>
   

   不要编造模糊度分数。说明 ooo interview 会评估模糊度，并持续进行，直到模糊度足够低，可以冻结一个真正的 Seed。

4. 工作流。 Interview → Seed → Execute → Evaluate，评估结果会反馈到下一次 Seed 生成中：

   ooo interview "your idea"   # expose assumptions
   ooo seed                    # freeze the Seed
   ooo run                     # execute it
   ooo evaluate                # verify against the acceptance criteria
   ooo status                  # check drift
   

   遇到阻碍时，ooo unstuck 可以提供帮助。run、evaluate、evolve 和 status 需要 Ouroboros MCP 服务（ooo setup）。

5. 下一步。 提供以下选项：启动真实项目（ooo interview "your actual project idea"）、查阅完整参考文档（ooo help），或进行设置（ooo setup）。

如果用户询问这与直接向 AI 助手输入提示词有何不同：没有规格时，助手会自行猜测，你则不断改写提示词，直到结果符合预期；使用 Ouroboros 时，访谈会先揭示隐藏的假设，因此构建工作从双方达成一致的 Seed 开始。如果觉得流程太复杂，三个命令就能满足大多数需求：ooo interview、ooo seed、ooo run。

当用户已经体验过访谈、理解 Seed 是什么，并且选定了下一步时，教程就完成了。

RFC #1392 状态线索页脚

在最终回复末尾，以且仅以一行 ◆ <current state> → next: <recommended action> 收尾。当 ouroboros_session_status 可用时，根据实时会话状态确定当前状态；否则，根据此技能的实际结果确定。切勿使用线性的 Step N of M 页脚；如果下一步有多个实际选项，请列出 2-3 个选项。