智能体工作流v2.6.0

技巧分享
,
1

name: workflow
description: “智能体工作流，提供智能体协作工作流方法，整合 AGENTS.md 执行流程、.qwen/agents/ 角色分工与任务编排，用于多阶段、多模块、多文件协同交付。”
version: “2.6.0”
author: “system”
archetype: “policy”

workflow智能体工作流

概述

本技能用于将复杂任务转化为可执行、可验证、可回滚的闭环流程，统一智能体在多阶段、多模块、多文件场景下的执行口径。

适用场景

  • 多文件批量改造
  • 跨模块流程梳理与联动更新
  • 先检索再实现的复杂需求
  • 需要多轮验证与回滚预案的任务

一、执行总流程（六步闭环）

graph LR
    A[分析指令] --> B[制定方案]
    B --> C[执行任务]
    C --> D[验证结果]
    D --> E[交付结果]
    E --> F[复盘沉淀]

步骤 1：分析指令

  • 目标：确认任务目标、范围边界和限制条件
  • 触发条件：接收新任务或任务发生变更
  • 执行动作：
    • 提取目标、输入、输出、限制、优先级
    • 标注不确定信息并给出可执行假设
    • 判断是否存在冲突需求或缺失依赖
  • 输出产物：任务要点清单、约束清单、执行假设
  • 验收标准：目标可描述、范围可界定、限制可追溯

步骤 2：制定方案

  • 目标：形成可执行计划并定义验收口径
  • 触发条件：分析指令完成
  • 执行动作：
    • 拆分阶段与任务，声明依赖关系
    • 明确每个任务的输入、动作、输出、校验方式
    • 定义失败回滚点和重试条件
  • 输出产物：实施计划、阶段清单、验收口径
  • 验收标准：任务可执行、依赖清晰、验收可核对

步骤 3：执行任务

  • 目标：按计划完成产物构建
  • 触发条件：方案已确定
  • 执行动作：
    • 按依赖顺序执行任务
    • 记录关键决策与偏差处理
    • 对每个子任务执行超时监控，超时即进入重试或降级处置
    • 记录超时原因、任务标识、已完成进度与处置结果
    • 向阶段汇总节点回传任务状态（成功、超时重试中、降级中、失败）
    • 遇阻断问题立即切换修复分支
  • 输出产物：阶段结果、变更记录、偏差说明
  • 验收标准：产物符合计划，关键路径不中断

步骤 4：验证结果

  • 目标：确认结果满足任务要求与规范要求
  • 触发条件：阶段任务完成或全量任务完成
  • 执行动作：
    • 执行格式校验、内容校验、规则校验
    • 对照验收标准逐条核对
    • 记录未通过项与影响范围
  • 输出产物：验证报告、不通过项清单
  • 验收标准：核心必检项全部通过

步骤 5：交付结果

  • 目标：输出结构化交付结果，便于复核与复用
  • 触发条件：验证通过或说明例外
  • 执行动作：
    • 汇总改动内容、验证结论、风险与建议
    • 标注已解决项与待跟踪项
    • 保证交付内容与任务目标一一对应
  • 输出产物：交付说明、验收结论、后续建议
  • 验收标准：结论完整、结构清晰、可直接复核

步骤 6：复盘沉淀

  • 目标：将经验固化为可复用方法
  • 触发条件：交付完成
  • 执行动作：
    • 总结高频问题和有效处理路径
    • 抽取通用规则与禁错项
    • 标记需要更新的规范条目
  • 输出产物：经验清单、规范更新建议
  • 验收标准：至少形成一条可复用经验

二、指标检查与修复流程（六步闭环）

步骤 1：指标生成

  • 操作：基于任务目标生成功能、质量、完整性三类指标
  • 输出：指标目标值清单

步骤 2：清单生成

  • 操作：将指标映射为可执行检查条目
  • 输出：检查清单与优先级分组

步骤 3：自我检查

  • 操作：逐条检查结果是否满足目标值
  • 检查项：
    • 功能完整性
    • 结构一致性
    • 规则符合性
    • 风险可控性
  • 输出：通过项与未通过项清单

步骤 4：问题修复

  • 操作：针对未通过项执行修复闭环
  • 修复流程：
    • 识别不符合项
    • 定位根因
    • 制定修复动作
    • 执行修复并记录结果
  • 输出：修复记录与影响说明

步骤 5：再次检查

  • 操作：对修复项与关联项进行复检
  • 检查重点：
    • 修复项是否完全通过
    • 是否引入新增问题
    • 关联模块是否受影响
  • 输出：复检结果清单

步骤 6：结案确认

  • 操作：确认所有核心指标达标并归档
  • 结案条件：
    • 核心指标全部通过
    • 无高风险遗留项
    • 交付说明完整可追溯
  • 输出：结案记录与归档清单

三、任务拆解标准

概念层次

  • 用户目标：最终业务结果
  • 阶段：按依赖顺序推进的串行单元
  • 任务：阶段内可管理的主题工作包
  • 子任务：可独立验收与回滚的最小执行单元

子任务最小字段（必填）

  • name：动词开头，能够直接验收
  • goal：一句话说明预期结果
  • inputs：上下文、约束、依赖
  • outputs：明确交付物格式
  • validation：至少一条可执行检查
  • rollback：失败时可恢复位置

子任务扩展字段（推荐）

  • touched_files：允许修改范围
  • depends_on：前置依赖
  • priority：优先级标记
  • owner：责任角色

四、任务编排与并行规则

编排决策顺序

  1. 先确认输入完整性（目标、范围、限制、验收口径）
  2. 再判断并行可行性（文件、数据、资源三类冲突）
  3. 能并行则阶段内并行，不能并行则按依赖串行
  4. 每阶段结束统一验证，失败回到对应子任务修复
  5. 全部通过后输出交付报告与后续建议

并行前检查

- [ ] 无数据依赖
- [ ] 无文件写冲突
- [ ] 无资源冲突（端口、服务、迁移）
- [ ] 结果可独立合并

子代理调度与隔离策略

超时分级

等级 适用任务 单任务超时
快速级 单点定位、清单整理、只读检索 60 秒
标准级 调用链梳理、方案生成、影响面分析 180 秒
深度级 跨模块分析、复杂排障、长链路核验 420 秒

使用规则：

  1. 先按任务复杂度选择超时等级，再结合阶段截止时间收敛
  2. 阶段内并行任务采用“最小必要超时”，避免单任务拖垮整体阶段
  3. 达到超时即判定当前尝试失败，进入重试或降级路径

重试策略

失败类型 最大重试次数 重试间隔
短暂不可用（网络抖动、瞬时负载） 2 次 5 秒、15 秒
结果不完整（缺关键文件或关键结论） 1 次 10 秒
参数错误或约束冲突 0 次 不重试，立即修正参数

执行规则：

  1. 每次重试必须记录失败原因与修正动作
  2. 同一失败原因连续出现 2 次，直接触发降级，不再盲目重试
  3. 重试总耗时计入阶段预算，超过阶段预算直接转入降级
  4. 同一子任务达到最大重试次数仍超时，判定为连续超时并触发失败升级

降级策略

  1. 角色降级：目标子代理不可用时，降级到通用检索能力
  2. 并行降级：并行冲突无法消除时，降级为按依赖串行执行
  3. 目标降级：高风险阻断未消除时，先交付最小可验收结果并标注限制项

并行隔离策略

  1. 文件隔离：并行子任务不得写入同一文件集
  2. 资源隔离：并行子任务不得抢占同一端口、服务实例或迁移窗口
  3. 状态隔离：每个子任务使用独立上下文，不共享未验证中间结论
  4. 失败隔离：独立子任务失败不阻塞其他并行子任务，阶段统一汇总处理

超时监控与回传字段

每个子任务在执行阶段必须输出以下最小监控与回传字段：

  • task_id：任务唯一标识
  • timeout_tier：超时分级（快速级、标准级、深度级）
  • timeout_seconds：超时阈值（秒）
  • attempt_index：当前尝试序号
  • timeout_count：累计超时次数
  • timeout_reason：超时原因
  • progress_snapshot：超时时的已完成进度
  • disposition：处置结果（重试、降级、失败）
  • status_reported_at：状态回传时间

不可用回退策略

  1. 目标角色不可用：回退到通用检索能力完成信息收集
  2. 仍无法覆盖：由主控按阶段拆解后串行执行
  3. 记录限制项：在交付说明中明确“已降级处理”与影响范围

五、执行约束

  • 禁止输出与任务无关的额外产物
  • 禁止跳过验证直接交付
  • 禁止在关键依赖缺失时强行推进
  • 出现冲突需求时，必须先记录冲突再执行兼容方案
  • 关键结论必须可追溯到输入和验证结果

六、标准产出模板

文档类任务产出模板

  • 目标概述
  • 改动说明
  • 验证结果
  • 超时处置回传
  • 风险与建议

代码类任务产出模板

  • 需求对应关系
  • 关键变更点
  • 校验与测试结果
  • 超时影响范围与处置结果
  • 兼容性影响

测试类任务产出模板

  • 测试范围
  • 用例结果
  • 失败项分析
  • 超时观测指标与回传记录
  • 结论与建议

排障类任务产出模板

  • 现象描述
  • 根因定位
  • 修复动作
  • 连续超时触发链路与处置结果
  • 回归验证

七、阶段必检清单

执行前

  • 目标与范围已明确
  • 依赖与限制已确认
  • 验收口径已定义

执行中

  • 关键步骤有记录
  • 偏差处理有说明
  • 风险项有跟踪

交付前

  • 核心指标已通过
  • 输出结构完整
  • 结论可追溯

八、异常处理与回滚规则

常见异常与动作

  • 信息不足：先建立最小可执行假设并标注假设边界
  • 需求冲突：记录冲突点并采用影响最小的兼容路径
  • 验证失败：进入修复分支，修复后必须复检
  • 高风险变更：执行回滚，恢复到最近稳定状态

失败处理原则

场景 处理策略
核心任务失败 回滚相关阶段并优先修复
辅助任务失败 记录影响，继续主路径
独立任务失败 隔离处理，不阻塞其他子任务

回滚触发条件

  • 核心验收项未通过
  • 修复后出现连锁失败
  • 关键路径不可继续执行
  • 关键子任务连续超时且降级失败

九、任务调用模板（统一字段与调度参数）

必填字段

所有任务调用示例统一使用以下字段：

  • description
  • query
  • subagent_type
  • response_language

禁止使用未在当前工具定义中的字段名。

模板参数（调度元数据）

以下参数用于任务编排与调度决策，执行时必须先映射为当前工具支持的字段，不可直接透传未定义字段：

  • timeout_tier：超时分级（快速级、标准级、深度级）
  • timeout_seconds：单任务超时秒数
  • retry_max：最大重试次数
  • retry_backoff_seconds：重试间隔序列
  • degrade_to：降级目标（如 general-purpose、serial）
  • isolation_group：并行隔离分组标识
  • phase_budget_seconds：阶段总预算秒数

单任务模板

{
  "description": "定位鉴权入口",
  "query": "定位鉴权中间件与路由保护入口，输出关键文件、核心函数与最短阅读路径，不要编造不存在内容。",
  "subagent_type": "search",
  "response_language": "中文",
  "timeout_tier": "快速级",
  "timeout_seconds": 60,
  "retry_max": 1,
  "retry_backoff_seconds": [5],
  "degrade_to": "general-purpose",
  "isolation_group": "phase-1-readonly",
  "phase_budget_seconds": 300
}

并行任务模板

[
  {
    "description": "定位调用链",
    "query": "定位登录到鉴权校验的调用链，按执行顺序列出关键文件与函数。",
    "subagent_type": "search",
    "response_language": "中文",
    "timeout_tier": "标准级",
    "timeout_seconds": 180,
    "retry_max": 2,
    "retry_backoff_seconds": [5, 15],
    "degrade_to": "general-purpose",
    "isolation_group": "phase-1-analysis",
    "phase_budget_seconds": 900
  },
  {
    "description": "盘点改动影响面",
    "query": "若新增权限点，列出需要修改的文件清单、风险点与兼容注意事项。",
    "subagent_type": "search",
    "response_language": "中文",
    "timeout_tier": "标准级",
    "timeout_seconds": 180,
    "retry_max": 1,
    "retry_backoff_seconds": [10],
    "degrade_to": "serial",
    "isolation_group": "phase-1-analysis",
    "phase_budget_seconds": 900
  },
  {
    "description": "生成验证清单",
    "query": "生成改动后的验证清单，按必须、推荐、可选分组。",
    "subagent_type": "search",
    "response_language": "中文",
    "timeout_tier": "快速级",
    "timeout_seconds": 60,
    "retry_max": 1,
    "retry_backoff_seconds": [5],
    "degrade_to": "serial",
    "isolation_group": "phase-1-readonly",
    "phase_budget_seconds": 900
  }
]

阶段化执行模板

workflow:
  name: "复杂需求执行流"
  phases:
    - phase: "阶段一：检索与方案"
      tasks:
        - "定位入口"
        - "盘点影响面"
      validation:
        - "结论可追溯"
    - phase: "阶段二：实现与修复"
      tasks:
        - "按文件集执行改动"
      validation:
        - "构建通过"
        - "关键流程回归通过"
    - phase: "阶段三：验收与交付"
      tasks:
        - "输出结果摘要"
      validation:
        - "验收项全部满足"

十、验证与交付要求

执行前最小校验

- [ ] 目标、范围、验收口径已明确
- [ ] 子任务边界与依赖已声明
- [ ] 每个子任务有最小验证项
- [ ] 每个子任务有回滚点

交付验收清单

- [ ] 输出结构完整（改动点、风险点、验证结果、后续建议）
- [ ] 关键结论可追溯到输入与执行过程
- [ ] 验证结果可复现
- [ ] 失败处理与限制项已记录
- [ ] 超时监控回传、连续超时触发与处置结果已记录

十一、维护规范

出现以下任一情况，必须同步更新本技能文档：

  1. 执行流程发生变化
  2. 验收口径发生变化
  3. 任务模板发生变化
  4. 约束规则发生变化
  5. 任务调用字段或工具接口发生变化
  6. 规则文档引用路径或名称发生变化

十二、规则追溯

  • 执行流程、指标流程、拆解字段、约束、模板、清单、异常处理来源： AGENTS.md
  • 项目角色定义来源： .qwen/agents/

十三、相关技能

十四、版本历史

版本 日期 变更
2.6.0 2026-03-13 补齐执行阶段超时监控回传、连续超时触发升级规则与交付模板超时字段
2.5.0 2026-03-13 新增子代理超时分级、重试策略、降级策略、并行隔离策略与模板调度参数，统一术语口径
2.4.0 2026-03-12 对齐 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/ 与任务模式
2

ai文太复杂了 总结一下得 不然读不进去 得快速点明