chief-plan

你正在规划一个里程碑。请严格按以下流程逐阶段进行。绝不要跳过任何阶段。

---

开始之前：新里程碑还是现有里程碑

确定你属于以下哪种情况：

• 创建新里程碑——目前还不存在任何 _goal/、_contract/ 或 _plan/ 文件。
• 扩展现有里程碑——里程碑目录中已有这些文件。

如果是扩展现有里程碑：

1. 首先阅读所有现有的 _goal/、_contract/ 和 _plan/ 文件。
2. 在每个阶段，判断新内容属于以下哪种情况：
   • 与现有文件部分重叠 → 更新该文件（添加/修改章节）。
   • 与所有现有文件的范围都不同 → 在现有文件旁边创建新文件。
3. 写入后，确认同一类别中不存在新旧内容之间的冲突。如果存在冲突，在向用户展示之前先解决。
4. 确认新内容遵循规则层级：AGENTS.md > .chief/_rules > 里程碑目标。如果新内容会与更高层级的规则相矛盾，请标记该问题并且不要写入。

---

阶段 0：深入提问环节

绝不要跳过此阶段。 即使已有目标或契约，也必须先向用户深入提问。现有文件不能替代需求梳理环节——其中可能包含过时或错误的假设，只有通过提问才能发现。

在写入任何内容之前，先进行需求梳理，以明确需求：

• 针对里程碑的各个方面持续深入地询问用户，直至双方达成共识。
• 逐一梳理设计树的每个分支，并逐项解决决策之间的依赖关系。
• 对每个问题，都提供你建议的答案。
• 一次只问一个问题。
• 如果可以通过探索代码库来回答某个问题，就先探索代码库，而不是向用户提问。

扩展现有里程碑时，提出的问题还应包括：

• 新工作与现有目标和契约之间的关系。
• 是否需要修订任何现有目标或契约。
• 现有任务是否会受到影响，或者是否需要重新安排优先级。

需求梳理完成后，总结关键决策，并在继续之前向用户确认。

---

阶段 1：审查并编写目标

绝不要跳过此阶段。 即使已有目标文件，在进入契约阶段之前，也必须将其提交给用户审查并批准。

根据需求梳理的结果，在 .chief/<milestone>/_goal/ 下编写或更新里程碑目标文件。

如果已有目标：

• 阅读每个目标文件，并确认其仍符合阶段 0 中的决策。
• 如果需求梳理发现现有目标有误或不完整，现在就更新。
• 将现有目标以及新增/修改后的目标提交给用户。

如果是扩展里程碑：

• 当新范围与现有目标文件重叠时，更新该文件。
• 当新范围不同于现有目标时，创建新的目标文件。
• 确认：同一里程碑中的目标之间没有矛盾，且任何目标都不与 .chief/_rules/_goal/ 或 AGENTS.md 相矛盾。

暂停。 将目标（新增和修改的）提交给用户。突出说明与现有内容相比有哪些变化。等待用户明确批准后再继续。

---

阶段 2：编写契约

在 .chief/<milestone>/_contract/ 下编写或更新里程碑契约。

如果是扩展里程碑：

• 当新范围与现有契约文件重叠时，更新该文件（例如，向现有架构添加字段）。
• 当新范围不同于现有契约时，创建新的契约文件（例如，新增 API 端点）。
• 确认：同一里程碑中的契约之间没有矛盾，且任何契约都不与 .chief/_rules/_contract/ 或 AGENTS.md 相矛盾。

暂停。 将契约（新增和修改的）提交给用户。突出说明与现有内容相比有哪些变化。等待用户明确批准后再继续。

阶段 3：编写 TODO

在 .chief/<milestone>/_plan/_todo.md 中编写或更新 3–5 个新任务。

如果是扩展：

• 将新任务追加到现有任务之后（不要删除或重新排序已完成的任务）。
• 如果新工作使现有未完成任务失效或取而代之，请明确标记（例如，- [ ] ~~task-2: old scope~~ → superseded by task-5）。
• 任务编号从最后一个现有任务编号继续。

停止。 向用户展示更新后的待办列表。突出显示新增和修改的条目。等待用户明确批准后再继续。

---

阶段 4：编写任务规格（可选）

询问用户：“编写详细的任务规格，还是跳过？”

如果跳过 → 技能结束。Builder-agent 将根据 TODO、目标和契约开展工作。

如果编写 → 在 .chief/<milestone>/_plan/task-<n>.md 下编写详细的任务规格。

如果是扩展：

• 只为新增任务编写规格。
• 如果新任务修改了现有任务规格所涵盖的行为，请引用该规格并说明差异。

停止。 向用户展示任务规格。等待用户明确批准后，再委派给 builder-agent。

---

冲突解决规则

在每个阶段向用户展示内容之前，先进行验证：

1. 同一类别内的一致性 — 同一类别（_goal/、_contract/、_plan/）中的文件不得相互矛盾。
2. 跨类别一致性 — 目标、契约和任务彼此一致（例如，任务不得引用不存在的契约）。
3. 层级规则合规性 — 内容不得与更高层级的规则相矛盾：
   • AGENTS.md 优先级最高。
   • .chief/_rules/** 优先级高于里程碑级内容。
   • 里程碑 _goal/ 的优先级最低。

如果发现冲突：

• 明确向用户指出冲突双方。
• 提出解决方案。
• 冲突解决前不得继续。

---

回溯规则

如果用户在后续阶段的反馈表明较早阶段的输出有误或不完整，必须返回并先修正较早阶段。不要通过修改当前阶段来绕过上游问题。

例如：

• 契约审查发现目标假设有误 → 返回阶段 1，修正目标并获得批准，然后再回到阶段 2。
• TODO 审查发现缺少契约字段 → 返回阶段 2，修正契约并获得批准，然后再回到阶段 3。

阶段顺序严格遵循两个方向：向前推进时（不得跳过阶段），向后回溯时（必须先修复上游问题）。

---

通用规则

• 遵循规则层级：AGENTS.md > .chief/_rules > 里程碑目标。
• 如果用户在审核关卡中拒绝或修改任何内容，先修订再继续。
• 不要在此技能期间委派给 builder-agent 或 tester-agent。此技能仅用于规划。