SuperAPI AI 工具集

orchestration-patterns

智能体与模型

查看项目

更新于 10-15 20:09

技能介绍

用途:将基于证据的交付与迭代式智能体循环固化为可复用模式,用于编排复杂、长时间运行的任务,确保进度可验证并能智能升级。适用场景包括多步骤实现任务、跨多个子智能体协调工作、需要检查点的长会话、合并前准备 PR(强制 QAS 门禁)以及团队交接。

核心方法:Simon Willison 的智能体循环,理念为“迭代直到成功或被阻塞,然后升级”。流程为:目标定义(来自票据的明确验收标准)→ 模式发现(检索代码库、文档与历史会话,模式发现技能自动调用)→ 迭代执行循环(实现方案、运行验证命令 {{CI_VALIDATE_COMMAND}},通过则进入证据环节,失败则分析错误并调整重试,被阻塞则携带上下文升级给 TDM)→ 证据附加(提交到票据系统)→ QAS 门禁(合并前强制,调用 QAS 子智能体独立评审)。

基于证据的交付:原则是“所有工作都需要可验证证据”。证据类型包括测试结果({{CI_VALIDATE_COMMAND}} 输出)、截图(前后对比)、命令输出(构建或迁移日志)、QAS 报告与 Session ID 审计线索。各阶段证据要求:开发阶段需测试结果与命令输出;预发布阶段需 UAT 验证或说明 N/A 原因;完成阶段需 QAS 报告与合并确认。QAS 报告统一输出到 docs/agent-outputs/qa-validations/{{TICKET_PREFIX}}-{number}-qa-validation.md。

QAS 合并前门禁为强制项,理由是职责分离(QAS 验证但不写产品代码)、独立验证、避免偏见,并将最终证据与结论回帖到票据系统。升级模式:阻塞超 4 小时升级 TDM 并附完整上下文与已尝试方案;架构不明确升级 ARCHitect 并附选项与权衡;跨团队依赖升级 TDM 说明涉及团队与受阻点;安全问题升级 SecEng 并附具体风险与证据。升级模板包含受阻点、已尝试步骤、上下文(票据与阻塞时长)与具体请求。

长时间任务检查点:每 10-15 次工具调用更新待办列表;接近上下文上限时总结状态;需要交接时提供续接上下文。会话边界处总结已完成工作、列出剩余项、记录阻塞并附加证据。状态保存模板含已完成、进行中(标注步骤)、剩余、阻塞与下一步动作。

限制与注意事项:该技能使用 {{PLACEHOLDER}} 模板标记,使用前须替换为项目实际值;未提供具体命令内容、分类之外的平台或收费信息。应避免的反模式:跳过 QAS 评审、票据中无证据、忽略 CI 失败、未经检查强推(应用 --force-with-lease)、被阻塞仍继续推进。权威参考包括 AGENTS.md、docs/sop/AGENT_WORKFLOW_SOP.md、CONTRIBUTING.md 与 linear-sop 技能。