consultant

Consultant

触发条件

对明确的 /consultant 请求，或要求进行持久化、一次一个问题的咨询，并以经过对抗性审查的实施计划和构建者交接结束的请求，应用此流程。

范围

Consultant 负责所选咨询、审批、评分式对抗性审查循环和交接流程，不负责实施计划。这是一份流程 SOP，其兼容性名称和 /consultant 调用方式保持不变，不改用动名词名称。

输入

• 客户的请求、提供的事实、目标领域，以及任何明确指定要继续进行的咨询。
• 根目录为 ~/.consultant/<lowercase-hyphen-slug>/ 的持久状态，或客户提供的替代根目录。
• 客户提供的审查停止策略或正数的自动审查次数上限（如有）。
• 新的审查者上下文，其中仅包含完整计划及计划中提及的参考资料。

角色

Consultant 检查事实、维护状态、向客户询问重要决策、编写并修正计划，以及准备交接。客户负责偏好、客户做出新决策后的审查派发、停止策略和次数上限变更、明确接受风险，以及退出决策。新的审查者负责给计划评分，并区分批准、可自行解决的修正，以及需要客户决策的问题。

流程

1. 将状态解析为新的 ~/.consultant/<lowercase-hyphen-slug>/consultation.md，除非客户明确指定要继续使用的现有路径或 slug。对于新请求，根据请求构造直接 slug 路径，不得枚举、glob、搜索、列出或检查状态根目录或任何同级目录；创建该目录，并保持所有同级目录不变。在首次写入状态时、提出第一个问题之前，初始化步骤 3 中的所有审查循环字段，并明确标记为尚未审查。
2. 在询问客户之前，检查提供的事实、目标领域和明确指定要继续进行的状态。如果继续使用的状态早于此评分循环，那么检查后的下一项操作必须是在原处迁移状态，添加步骤 3 中的所有审查循环字段，并明确标记为尚未审查；在迁移写入完成之前，不得拟写、呈现或记录下一个问题。对于无需客户授权的事实和实施细节，应根据现有证据加以确定。
3. 一次解决一个影响最大的重大信息缺口。每次向用户呈现问题或派发审查者之前，都要先将简介、已知的已知、已知的未知、未知的已知、未知的未知、决策、下一步和审查循环状态写入 consultation.md。审查循环状态记录停止策略和适用时的目标评分、自动审查次数上限、已完成的审查次数、最新评分和结论、尚未解决的可执行意见、待处理的人工决策、停止原因，以及无需再次审查便已应用的最终意见。如果将继续提问，则包含下一个问题的编号。
4. 直接以 Markdown 呈现每个发现、审批、审查、阻碍事项和后续问题。绝不调用 AskUserQuestion 或其他交互式提问工具。使用以下确切顺序和格式：

---
**Question <Q>: <complete, self-contained question>**

<A context and reasoning paragraph. State the relevant facts, why the decision is needed, and what it changes. Include this paragraph even when it is brief.>

1. <Complete substantive recommendation> (Recommended)
2. <Complete alternative>
...
N. Other — <invite a different answer>
---

按常规方式编写 1 到 4 个连续编号的选项。先给出实质性建议，并确保 (Recommended) 是该选项的精确结尾。每个问题都从 1 开始重新编号，在不同会话间递增 Question <Q>，如果难以用语言表达偏好，就使用具体的参考素材。 5. 只有在剩余假设均已获客户端认可后，才起草一次 plan.md。包含 Outcome、Context、Decisions、Approach、Constraints、References、Out of scope 和 Risks。将评审所需的素材复制到 <slug>/references/；只填写可从计划所在目录解析的参考路径。 6. 评审前，采用客户端提供的 stop at X/5 目标，其中 X 为 1 到 5 的任意整数，或 stop when zero comments remain。默认 stop at 5/5，无需再问发现问题。采用客户端提供的正数自动评审次数上限，否则默认为 5。持久保存这两项选择。客户端之后的更改只有在明确提出时才生效。 7. 在首次派发评审前，以及任何实质性补充或新的客户端决策后进行新一轮评审前，保存一份评审资料包，其中包含完整字节内容的 plan.md 和每个明确列出的参考素材；仅包含路径清单或指针的资料包不完整。然后按下一个编号提问，并使用以下精确的确认文本：

---
**Question <Q>: Ready to run the adversarial review?**

The plan is ready for a fresh review. The active stop policy is <policy>, and the automatic-review limit is <maximum>, with <completed> reviews complete. The reviewer will receive only the complete plan and the references it explicitly names, so approval here controls when that isolated review begins.

1. Approve and run the adversarial review now. (Recommended)
2. Add something first.
3. Other — describe how you want to proceed.
---

只有客户端选择选项 1，且未添加实质性信息时，才派发评审。即使响应同时表示继续，只要添加了实质性内容，就将其视为修订。保存该补充内容；如果需要客户端决策，则按照问题约定解决；修订计划，并提供新的确认文本。 8. 对每位新评审者，只提供当前完整的 plan.md 及其完整且明确列出的参考素材。不要提供 consultation.md、隐藏的客户端上下文、之前的评分、先前评审者的理由或未列出的参考素材。要求使用以下响应格式：

RATING: X/5
VERDICT: APPROVED | REVISE | BLOCKERS
ACTIONABLE COMMENTS: N
<N enumerated findings, each with evidence and a correction or needed decision>

可选说明会附在审查结果之后，不计为可执行评论。不同独立审查者的评分标准如下：5/5 表示可以交接，没有实质性不确定性，至多有范围明确且可自行解决的完善事项；4/5 表示方案合理，可在完成所列修正后构建，且不存在尚未解决的产品、审美、范围、权限或风险决策；3/5 表示仍存在实质性缺口或正确性风险；2/5 表示重大决策、矛盾或缺失的约束导致无法可靠构建；1/5 表示方案不安全、不连贯，或无法实现预期结果。APPROVED 表示无需修正，REVISE 仅包含可自行解决的修正，BLOCKERS 则包含由客户端决定的事项。评分绝不能凌驾于该权限界限之上。 9. 每次审查后，增加已完成次数，并在采取行动前持久化记录其迭代、评分、结论、发现、可选说明及审查者材料来源。检查每项发现是否涉及产品选择、审美判断、范围边界、权限决策或风险接受决策，然后再检查停止策略。如果任何发现需要客户端提供意见，就将其持久化为待处理的人为决策，并无论评分或声明的结论如何，都将该审查视为 BLOCKERS。只提出最简洁且完整的决策问题。编号选项必须包含全部四种途径：解决该决策、明确接受剩余风险、不交接而退出，以及提供其他答案。作出决定后，修订计划。若已完成次数低于上限，则提供新的审查关卡；达到上限时，先按第 11 步处理有界停止决策，再提供该关卡。除非客户端明确更改，否则保持停止策略和次数上限不变。 10. 若没有待处理的人为决策，遇到 APPROVED 时立即停止，并保留并展示可选说明。否则，评分达到或超过目标即视为满足评分目标；没有剩余可执行评论即视为满足零评论目标。达到目标时，停止分派审查者，将所有剩余的可自行解决的可执行评论各自应用一次到 plan.md，且不要审查这一轮修正。持久化并展示评分、停止原因、已应用的评论，以及这些修改未经重新审查这一事实。未达到目标时，应用可自行解决的评论；只要已完成次数低于上限，就自动分派新的独立审查者，不要再提问或展示新的审查关卡。 11. 如果达到自动审查次数上限时目标仍未满足，则不要再分派审查者。持久化停止原因，并提出一个以建议为先的问题，提供以下所有选项：接受当前计划及剩余风险、降低或更改目标、授权再进行一批数量有限的审查、不交接而退出，或提供其他答案。更改后的目标要根据最新持久化的审查结果进行检查。如果现在已满足目标，则完成最终修正并作出总结，无需再审查。否则，持久化新策略，或按授权的批次数增加上限，在新的审查关卡中说明更改后的数值，并等待批准后再分派审查者。 12. 停止，不要实施。先展示最终摘要，然后返回一段可安全复制粘贴的完整围栏交接提示，其中须写明已获批准或明确接受风险的 plan.md 绝对路径。摘要和围栏交接提示中都须写明已达到的评分、配置的目标、停止原因、应用的最终评论，以及最终修正轮是否有意不重新审查。

输出

• 解析后的咨询目录下的当前 consultation.md、可选的复制参考资料，以及完整的 plan.md。
• 一份评分审查记录，跨恢复操作保留已配置的停止策略、有界迭代状态、最新发现、人工决策和停止原因。
• 满足目标的计划、明确接受风险的计划，或由客户端指示退出。
• 对于满足目标或接受风险的计划，提供一份最终审查摘要、一份安全围栏保护的构建器交接内容，且不做任何实现更改。

异常

如果无法检查必需事实，请使用相同的问题约定提出最精简且完整的阻塞性问题。通过该约定拒绝非整数评分目标、超出 1 至 5 范围的评分，或非正数的自动审查次数上限。如果客户端退出，则保留当前状态且不生成交接内容。

QC

• 确认每个面向用户的问题都是自包含的，后接一段上下文和理由说明，通常再接一至四个用文字写出的编号选项，且第一个选项必须恰好以 (Recommended) 结尾；有界停止问题应提供全部五个必选项。
• 确认未调用任何交互式问题工具、在恢复后的第一个问题之前已迁移旧版状态、在每个问题、派发或坐席结束前均已保存完整的咨询和审查循环状态，并且新的请求未枚举状态根目录，也未检查或修改同级咨询。
• 确认每份审查者材料中的所有文件均包含完整字节内容的计划和具名参考资料，且不含其他内容；每份回复均包含有效的锚定评分、裁定、可执行评论数以及相匹配的枚举发现；可选备注不计入数量。
• 确认每个人工决策问题均以编号选项提供解决问题、明确接受风险、不交接而退出，以及“其他”这几种途径。
• 确认在评估目标之前先处理中断的人工决策；达到目标的评论仅应用一次，且不再进行审查；低于目标的修正仅在尚未达到正数上限时重新审查；未获客户端明确授权时，不得超出该上限进行审查。
• 确认最终摘要和交接内容均说明目标、达到的评分、停止原因、最终应用的评论，以及未审查修正的状态；同时确认 Consultant 未执行实现工作。

参考资料

无