智能体研发工作流
使用这个自包含的技能包,在当前工作空间中自动化一个以Markdown优先的多智能体实验室工作流。
这是Agent Laboratory模式的一个通用适配版:独立的证据审查、协作计划制定、任务执行或调研、结果分析、质量审查以及最终报告撰写。它不限于科学研究;同样的实验室工作流可应用于产品、商业、技术、战略、法务、合规、安全、用户体验、市场及运营等使用场景。
专为具备文件系统访问权限、技能兼容的编码智能体设计。只要环境支持,优先使用真正的并行子智能体;只有当真实子智能体不可用时,才使用隔离的模拟子智能体。
包内容
SKILL.md:激活规则和核心操作指令。references/generalized-lab-model.md:通用Agent Laboratory模型及用例映射。references/workflow.md:完整的阶段序列和审批门。references/agent-roles.md:专家角色选择指南。references/quality-rules.md:证据、不确定性、审查和安全标准。references/implementation-notes.md:安装、脚手架、子智能体和文件处理说明。references/example-run.md:一个紧凑的端到端示例,展示预期的文件轨迹和输出质量。assets/templates/:所有工作流文件的Markdown模板。scripts/init-rd-workflow.mjs:可选的脚手架脚本。scripts/validate-skill.mjs:公共技能包的仓库验证脚本。
第一步操作
- 在当前工作空间寻找
project-brief.md。 - 如果存在,在任何其他工作流步骤之前完整读取它。
- 如果不存在且用户提供了足够的上下文,则使用
assets/templates/project-brief.md创建它。 - 如果缺少关键上下文,仅询问最少量的阻塞性问题。
- 在项目概要存在后,无需在正常工作流阶段之间请求许可即可继续执行。
运行 scripts/init-rd-workflow.mjs 来搭建 project-brief.md 和所需的 work/ 文件。该脚本不得创建 work/06-final-output.md。
必需输出
在活动工作空间中创建并使用以下结构:
work/
├── 00-lab-notes.md
├── 01-orchestration-plan.md
├── 02-specialist-outputs/
├── 03-team-collaboration.md
├── 04-cross-review-notes.md
├── 05-stage-gate-review.md
└── 06-final-output.md
每个工作流阶段映射到一个特定的输出路径。编号的实验室阶段(证据审查、计划制定、执行、结果分析)不是单独的文件:它们体现为 work/02-specialist-outputs/ 中每个专家对应的一个文件。
| 阶段 | 输出路径 |
|---|---|
| 实验室设置 | work/00-lab-notes.md |
| 编排 | work/01-orchestration-plan.md |
| 证据审查、计划、执行、结果(每个专家一个文件) | work/02-specialist-outputs/NN-<role>.md |
| 团队协作(由编排器合并) | work/03-team-collaboration.md |
| 交叉审查 | work/04-cross-review-notes.md |
| 阶段门审查 | work/05-stage-gate-review.md |
| 最终综合 | work/06-final-output.md |
在 work/05-stage-gate-review.md 显示“已批准”之前,不要创建或写入 work/06-final-output.md。
工作流
- 阅读
references/workflow.md了解规范的阶段序列。 - 阅读
references/generalized-lab-model.md将用户的使用场景映射到实验室阶段。 - 在选择专家之前阅读
references/agent-roles.md。 - 在交叉审查、阶段门审查和最终综合之前阅读
references/quality-rules.md。 - 使用
references/implementation-notes.md了解脚本使用、子智能体行为和文件处理细节。 - 使用
assets/templates/中的模板生成工作流文件。 - 当不确定预期输出质量时,查阅
references/example-run.md获取一个完整的端到端示例。
按需调整规模
使工作流的权重与项目概要相匹配。不要为一个小问题运行完整的多人多轮实验室。
- 简单项目概要:编排器可以执行一次单线通过,无需子智能体。将证据、假设和风险记录在
work/00-lab-notes.md中,编写简短的work/05-stage-gate-review.md自检,然后输出work/06-final-output.md。在该级别下,中间的专家输出、协作和交叉审查文件是可选的。阶段门规则仍然适用:在05-stage-gate-review.md显示“已批准”之前,不要写入06-final-output.md。 - 小型或范围狭窄的项目概要:使用一到两个专家,运行单轮次,并将协作内容折叠到编排器的笔记中,而不是分开的交流。将交叉审查、阶段门审查和最终综合各作为一个快速通道。
- 中型项目概要:使用几个专家,进行一到两轮,辅以轻量级的团队协作步骤。
- 大型或受监管的项目概要:使用完整的阶段序列、多轮次、明确的团队协作以及相关的审查角色。
无论规模大小,始终保持最小的强制步骤:证据/上下文审查、计划制定、执行或调研、结果分析、风险/假设覆盖,以及在最终综合之前的阶段门质量关卡。其他所有内容都是可选的,仅当它们实质上改变交付物时才添加。详见 references/generalized-lab-model.md 的扩展细节。
执行规则
- 选择能够充分覆盖项目概要的最少数量的专家角色。
- 始终包含证据/上下文审查、计划制定、执行或调研、结果分析以及风险/假设覆盖。
- 优先使用真正的并行子智能体。它们是此技能的主要执行模型,而非可选的增强功能。
- 在每个阶段,同时启动所有独立的专家,然后再等待结果。当并行子智能体可用时,不要逐个运行独立的专家。
- 否则,将专家模拟为隔离的通过。每次通过必须仅读取项目概要、编排计划及其分配的范围,然后写入自己的文件。
- 切勿将专家分析、交叉审查、阶段门审查和最终综合合并到一个响应中。
- 并行化独立的专家工作,但保持依赖关卡的顺序:审查在计划之前,计划在执行之前,执行在结果分析之前,审查在最终报告之前。
- 当来源可用时,对于事实性主张要求提供引用或来源说明。
- 将无依据的主张标记为假设或推断。
- 保留不确定性和受监管领域的审查边界。
协作团队协议
- 将子智能体视为一个协作团队,而非独立的报告撰写者。
- 主编排器在
work/01-orchestration-plan.md中定义团队角色、所有权、依赖关系和协作规则。 - 每个子智能体仅写入自己的专家输出文件,并将其问题、依赖关系、分歧和交接说明返回给编排器(在其结果中体现,而非编辑共享文件)。
- 编排器将这些返回的说明合并到
work/03-team-collaboration.md中。切勿让多个子智能体同时写入同一个文件。 - 团队必须在交叉审查之前协调好共享假设。
- 交叉审评估专家输出和团队协作记录。
- 最终综合必须体现已解决的一致意见、未解决的分歧以及重要的少数派观点。
停止条件
仅在以下情况下停止并向用户询问:
- 无法识别主题或目标。
- 无法推断出所需的输出。
- 关键约束条件冲突。
- 所需的外部数据、凭据、私有系统、付费工具或不可用的网络访问阻碍了工作。
- 法律、医疗、财务、合规、安全或关键安全性建议无法保持在安全的信息边界之内。
完成
当工作流完成时,告知用户创建了哪些文件,以及阶段门是否批准了最终综合。保持完成消息简洁。