name: 智能体工作流
description: “提供智能体协作工作流方法，整合 AGENTS.md 执行流程、.qwen/agents/ 角色分工与任务编排，用于多阶段、多模块、多文件协同交付。”
version: “2.3.0”
author: “system”
archetype: “policy”
智能体工作流
概述
本技能用于指导复杂任务的拆解、并行执行、结果汇总与质量验证，目标是用更少返工完成可验证交付。
适用场景
- 多文件批量改造
- 跨模块流程梳理与联动更新
- 先检索再实现的复杂需求
- 需要多轮验证与回滚预案的任务
一、执行总流程
graph LR
A[分析用户目标] --> B[确定产物与边界]
B --> C[拆解并编排任务]
C --> D[执行与汇总]
D --> E[统一验证]
E --> F[指标检查与收尾]
决策顺序
- 先确认输入是否完整（目标、范围、限制、验收口径）。
- 再判断是否可并行（文件、数据、资源三类冲突）。
- 能并行则阶段内并行，不能并行则按依赖串行。
- 每阶段结束必须统一验证，失败回到对应子任务修复。
- 全部通过后再输出交付报告与后续建议。
二、任务拆解模型
概念层次
- 用户目标：最终业务结果
- 阶段：按依赖顺序推进的串行单元
- 任务：阶段内可管理的主题工作包
- 子任务：可独立验收与回滚的最小执行单元
子任务最小字段
name：动词开头，能验收goal：一句话目标inputs：上下文、约束、参考信息outputs：固定输出结构touched_files：允许修改范围depends_on：前置依赖validation：最小验证项rollback：失败恢复点
三、任务调用模板（统一字段）
必填字段
所有任务调用示例统一使用以下字段：
descriptionquerysubagent_typeresponse_language
禁止使用未在当前工具定义中的字段名。
单任务模板
{
"description": "定位鉴权入口",
"query": "定位鉴权中间件与路由保护入口，输出关键文件、核心函数与最短阅读路径，不要编造不存在内容。",
"subagent_type": "search",
"response_language": "中文"
}
并行任务模板
[
{
"description": "定位调用链",
"query": "定位登录到鉴权校验的调用链，按执行顺序列出关键文件与函数。",
"subagent_type": "search",
"response_language": "中文"
},
{
"description": "盘点改动影响面",
"query": "若新增权限点，列出需要修改的文件清单、风险点与兼容注意事项。",
"subagent_type": "search",
"response_language": "中文"
},
{
"description": "生成验证清单",
"query": "生成改动后的验证清单，按必须、推荐、可选分组。",
"subagent_type": "search",
"response_language": "中文"
}
]
阶段化执行模板
workflow:
name: "复杂需求执行流"
phases:
- phase: "阶段一：检索与方案"
tasks:
- "定位入口"
- "盘点影响面"
validation:
- "结论可追溯"
- phase: "阶段二：实现与修复"
tasks:
- "按文件集执行改动"
validation:
- "构建通过"
- "关键流程回归通过"
- phase: "阶段三：验收与交付"
tasks:
- "输出结果摘要"
validation:
- "验收项全部满足"
四、角色与能力说明
项目角色
- 项目内角色以
.qwen/agents/实际目录为准。 - 涉及角色清单时，必须与目录内容保持一致，避免命名漂移。
代理能力
- 代理能力以当前运行环境的可用列表为准，不写死数量。
- 使用前先确认目标能力是否可用，再决定委托或主控直接执行。
不可用回退策略
- 目标代理不可用：回退到通用检索能力完成信息收集。
- 仍无法覆盖：由主控按阶段拆解后串行执行。
- 记录限制项：在交付报告中明确“已降级处理”与影响范围。
五、并行与失败处理
并行前检查
- [ ] 无数据依赖
- [ ] 无文件写冲突
- [ ] 无资源冲突（端口、服务、迁移）
- [ ] 结果可独立合并
失败处理原则
| 场景 | 处理策略 |
|---|---|
| 核心任务失败 | 回滚相关阶段并优先修复 |
| 辅助任务失败 | 记录影响，继续主路径 |
| 独立任务失败 | 隔离处理，不阻塞其他子任务 |
回滚触发条件
- 核心验收项不通过
- 关键流程回归失败
- 失败任务占比超过阈值并影响主目标
六、验证与交付
执行前清单
- [ ] 目标、范围、验收口径已明确
- [ ] 子任务边界与依赖已声明
- [ ] 每个子任务有最小验证项
- [ ] 每个子任务有回滚点
交付验收清单
- [ ] 输出结构完整（改动点、风险点、验证结果、后续建议）
- [ ] 关键结论可追溯到输入与执行过程
- [ ] 验证结果可复现
- [ ] 失败处理与限制项已记录
七、维护规范
出现以下任一情况，必须同步更新本技能文档：
- 任务调用字段或工具接口发生变化。
- 可用代理能力列表发生变化。
- 阶段化流程或验收口径发生变化。
- 规则文档引用路径或名称发生变化。
八、相关技能
九、相关文件
- 执行流程基线： AGENTS.md
- 项目角色定义： .qwen/agents/
十、版本历史
| 版本 | 日期 | 变更 |
|---|---|---|
| 2.3.0 | 2026-03-11 | 收敛结构、统一任务字段、改为动态能力描述、补齐执行闭环 |
| 2.2.0 | 2026-03-10 | 新增代理子能力章节与调用模板 |
| 2.1.1 | 2026-03-09 | 补齐子任务规范，去重并校正章节编号 |
| 2.1.0 | 2026-03-09 | 增强多任务模板与并行实践，补齐角色清单 |
| 2.0.0 | 2026-03-07 | 整合 AGENTS.md、.qwen/agents/ 与任务模式 |
