subagent-prompt

子 Agent 编排提示词

生成一份完整、独立的提示词，供用户粘贴到新的 Agent 会话中（该会话支持子 Agent），以执行本次对话中讨论的工作。新的会话是编排器：它会为每项任务派遣一个子 Agent，并且只综合结果——不会自行编写代码。

目标

将当前会话的工作移交给一个全新的上下文窗口，确保：

• 无需用户逐步看护即可完成全部工作
• 每项任务都使用一个子 Agent，让每项任务拥有独立的上下文窗口
• 要求每个子 Agent 在汇报前验证自己的工作
• 为编排器提供足够的材料，以便最终确认整个任务确实可用

阶段门槛

按顺序完成。满足通过条件之前，不得进入下一步。

1. 已确定源材料 — **通过条件：**你能指出此提示词将移交的具体材料（计划文件、检查清单、用户描述的更改列表等）。如果对话中只有模糊意图，应先询问用户该提示词应涵盖哪些内容，再开始起草。
2. 已明确拆分任务 — **通过条件：**你有一份编号任务列表（或能指出磁盘上已有的任务列表），其中每项任务都足够小，可由一个子 Agent 独立负责并端到端完成。如果工作过于庞大，应先拆分，再起草提示词。
3. 已为每项任务指定验证方法 — **通过条件：**你已为每项任务指定子 Agent 汇报前必须运行的具体检查（类型检查命令、测试命令、lint、文件检查等）。「验证它能正常工作」不算通过。
4. 已起草完整提示词 — **通过条件：**即使新 Agent 会话对本次对话毫无记忆，这份提示词也能让它理解任务；提示词应注明路径、工具、验证命令和成功条件。

生成的提示词必须包含

将移交提示词写成一个供用户复制的独立代码块，并按以下顺序包含这些内容：

1. 角色声明 — “你是编排器。每项任务派遣一个子 Agent。不要自行编写代码。”
2. 上下文 — 说明工作内容、源材料所在位置（计划路径、规范路径、仓库路径）以及任何不明显的约束。使用绝对路径引用文件，确保新会话能直接找到并读取文件。
3. 任务列表 — 每项任务都应编号，并包含：标题、输入材料（路径/章节）、要使用的子 Agent 类型，以及该子 Agent 汇报前必须运行并通过的具体验证步骤。
4. 验证约定 — 明确要求每个子 Agent 只有在验证通过后才能汇报，并在汇报中说明：修改内容、运行的验证命令，以及验证输出（最后几行；若输出较短，则提供完整输出）。
5. 持续执行条款 — “持续派遣任务，直到所有任务都已完成。如果子 Agent 汇报验证失败，则派遣后续子 Agent 排查并修复，再继续下一项任务。除非最终集成检查通过，否则不得停止。”
6. 最终集成检查 — 所有任务完成后，由编排器运行的单条命令（或简短命令序列），用于确认整个项目正常工作（项目类型检查、完整测试套件、lint、冒烟测试）。具体写出该命令。
7. 失败处理策略 — 如果子 Agent 在同一步骤上连续两次受阻，应如何处理（升级给用户，不得悄悄缩小任务范围）。

起草规范

• 仅使用绝对路径。 新会话无法根据当前会话的工作目录解析相对路径。
• 仅使用具体命令。 “运行测试”不是命令。cargo test --package osprey-core 才是。
• 注明子代理类型。 如果目标运行环境提供通用子代理，请明确说明。如果适合使用专用代理（例如仅用于搜索的探索代理），请使用目标环境中的术语注明。不要让编排器猜测。
• 不要用“自行判断”作为退路。 如果任务需要判断，请预先明确判断标准。如果无法做到，说明任务尚未准备好交接，并在起草前告知用户。
• 保持唯一事实来源。 如果磁盘上已有计划文件，提示词应指示编排器查看该文件，而不是重新复述计划。复述容易产生偏差；以文件为准。

工作流程

1. 确认源材料（关卡 1）。如果存在 .beagle/concepts/<slug>/plan.md 或同等文件，就以此为主干；如果不存在，请询问用户提示词应以什么为依据。
2. 确认任务分解（关卡 2）。如果源材料已经列出任务，则沿用原编号；否则先提出任务分解，并在起草前与用户确认。
3. 为每项任务定义验证检查（关卡 3）。根据项目实际使用的工具来确定——阅读项目约定文件（例如 AGENTS.md 或 CLAUDE.md）以及任何 Makefile/package.json/Cargo.toml，以找到正确的命令。
4. 将提示词起草为单个围栏代码块（关卡 4）。包含 生成的提示词必须包含的内容 检查清单中的所有内容。
5. 在聊天中展示起草好的提示词。告知用户开启新会话并粘贴该提示词。
6. 可以选择提出后续修改：如果用户发现缺少约束、路径错误或验证计划有疏漏，可进行完善。

此技能不适用的情况

• 工作可在一个会话和一个上下文窗口内完成——直接处理即可。
• 工作具有探索性或实验性，且用户明确希望参与其中——繁重的编排交接没有必要。
• 尚无可供交接的具体产物——先引导用户使用 brainstorm-beagle 或 write-plan 技能，生成本技能要交接的规范和计划。