SuperAPI AI 工具集

dynamic-workflow-mode

智能体与模型

查看项目

更新于 10-15 08:35

技能介绍

Dynamic Workflow Mode 是一个面向编码智能体的技能,适用于智能体能够生成或调整任务本地的临时框架(task-local harness),而不仅仅是遵循静态命令流的场景。其目标是把动态工作流模式变成有纪律的系统:为一次性工作使用临时 harness,为重复性工作抽取共享技能,并为团队提供可观察的控制台检查点。

何时启用

当用户提到动态工作流、自定义 harness、每任务 harness(harness-per-task)、自适应工作流,或 Claude Code 动态工作流模式时启用。

当任务需要自定义循环、评估器、爬虫、fixture 生成器、watcher 或本地仪表盘时启用。

当多个智能体需要同一套可重复流程,但该流程尚未被捕获为共享技能时启用。

当工作流在合并前需要持久化的交接产物、评估证据或操作者批准时启用。

核心约定(Core Contract)

动态工作流模式只有在 harness 比手动执行相同步骤更便宜、更安全时,才应生成任务本地 harness。harness 必须具备:

  • 目标(Objective):它负责的成果,以及它明确不负责的成果。
  • 输入(Inputs):文件、URL、提示词、数据源、凭据策略和用户提供的约束。
  • 输出(Outputs):提交、报告、截图、状态文件或控制台快照。
  • 评估(Eval):至少一个与任务挂钩的通过/失败检查,而不只是「它跑起来了」。
  • 交接(Handoff):一份简短产物,告诉下一位操作者发生了什么、被什么阻塞、如何继续。

动态 Harness 决策树

  • 一次性任务:保持内联,不要凭空发明 harness。
  • 输入会变化的重复任务:创建任务本地 harness,并把它放在临时或项目本地工作区中。
  • 跨团队成员或跨仓库的重复任务:把模式抽取为共享技能。
  • 涉及外部状态、排队或审批的任务:在增加更多自动化之前,先加入控制台可见性。
  • 有安全风险的任务:在自主执行之前加入评估门和人工合并门。

任务本地 Harness 模板

在写代码之前使用以下结构:

# Dynamic Workflow Harness

Objective:
- Ship:
- Do not ship:

Inputs:
- Repo or workspace:
- External systems:
- Credentials policy:

Loop:
1. Discover current state.
2. Generate or update the smallest useful artifact.
3. Run eval checks.
4. Record status and handoff.
5. Stop on failed gate, unclear ownership, or unsafe external action.

Eval:
- Command:
- Expected pass signal:
- Failure owner:

Handoff:
- Status:
- Evidence:
- Next action:

共享技能抽取

只有当以下条件至少满足两项时,才把任务本地 harness 提升为共享技能:

  • 同一工作流出现在多个会话、仓库、团队或发布中。
  • 工作流需要特定的语言、工具或安全执行顺序。
  • 失败反复出现,因为操作者跳过了某个门或丢失了上下文。
  • 工作流具有稳定的输入/输出契约。
  • 工作流能从控制台、状态看板或团队交接中获益。

抽取时,先在 skills/<name>/SKILL.md 中编写技能。只有在仍需要旧式斜杠入口时,才添加命令 shim。

控制台检查点(Control Pane Checkpoints)

当任务跨越多个会话时,动态工作流模式才能变得可供团队使用,因为它暴露了状态。此时应记录以下检查点:

  • 计划(Plan):目标、负责人、验收标准,以及有风险的外部系统。
  • 队列(Queue):工作项、分配的智能体角色、分支/工作树,以及依赖边。
  • 运行(Run):活跃 harness、当前循环步骤、最近的评估结果,以及可用的 token/成本信号。
  • 门(Gate):测试结果、浏览器截图、安全审查和合并就绪度。
  • 交接(Handoff):已完成什么、失败什么、需要人工决策什么。

如果仓库启用了 ECC2 状态,优先通过 ECC 控制台或基于状态存储的脚本添加或读取检查点,而不是散落未跟踪的笔记。

评估门(Eval Gates)

每个动态 harness 都需要一个任务特定的评估。选择最便宜的可靠门:

工作类型 评估门
代码功能 聚焦测试、lint、覆盖率,以及一条集成路径
UI/控制台 浏览器冒烟测试,含截图和溢出/错误检查
智能体工作流 Fixture 记录或带预期路由的种子工作项
研究/内容 来源中立的简报、主张清单,以及可发布大纲
集成 干跑命令、配置校验,以及无密钥扫描

在评估能被另一位团队成员重新运行之前,不要声称某个动态工作流是可复用的。

反模式(Anti-Patterns)

  • 生成对操作者隐藏真实决策逻辑的脚本。
  • 把动态工作流模式当作跳过测试的许可。
  • 当共享技能或状态产物才是真正产物时,却创建一次性文档。
  • 在缺少负责人、合并门或冲突策略的情况下运行多个智能体。
  • 让原始私密研究数据泄漏到公开文档中。

输出标准

结束时给出:

  • harness 或技能路径。
  • 评估命令和结果。
  • 控制台或交接产物路径。
  • 下一个可复用抽取候选。

限制

资料未提供该技能的收费、价格、平台兼容范围或量化效果数据。