用途
using-workflows 是一个工作流配方(recipe)路由器技能。它的职责不是自己执行工作,而是判断当前情境需要哪一份配方、填写参数、运行它,并保持闭环持续推进。资料明确说明:“你不是一份配方。”
它服务于循环形态的工作:包含多个阶段(stages)以及收敛条件(convergence condition),例如审计链、共识评审、计划→构建生命周期、发现项分诊等。全局的 Continuity 触发规则会在任务开始时把循环形态的工作路由到这里。
使用方式
BYPASS 检查(优先执行)
符合以下条件时直接执行,不进入配方流程:单个有界任务、单一上下文、无阶段划分、无收敛条件。可以直接内联完成,或通过 using-tmux-agent-tools 派一个 worker。此时不开 run dir。资料强调“拿不准就 bypass”,配方是为循环存在,不是为了仪式。
例外:跨多个来源或多轮次的研究(查找、比价、收集来源)不属于 bypass,应转到 haiku-research-round;单次工具调用即可完成的事实查询保持内联。
文档还列出若干“已被烧过的红旗”(例如凭记忆使用配方、事后补 run record、小改不做 gate),并规定:点名红旗后仍继续,必须给出书面理由。
子代理豁免:被委派的 worker 不进入此路由器;派发者已完成路由,worker 只需遵循其任务简报。
触发与运行时
到达后先通过 SELECT 环节,将触发词(audit / consensus verification / findings triage / root-cause deep-dive / plan→build)匹配到某份配方。
运行时分工:Claude 通过 Workflow 原生调用配方;Codex 则经由 references/codex-adapter.md(claude-workflow-runner)命令执行。写入职责:每份配方的产物/结果都落在调用方的 .workflow/<YYYYMMDDHHMM>-<slug>/ run 目录中,一个任务对应一个 run 目录,由约定与配方共享。
SELECT:实时发现配方
不得凭记忆背诵配方列表,须用命令实时发现:
ls ~/.claude/workflows/*.workflow.js .claude/workflows/*.workflow.js 2>/dev/null
内环(唯一的循环,不存在调度的外环,不要臆造)流程为:
- audit(docs-vs-code | design-vs-code | root-cause-deep-dive)
- → findings-triage(连接器 ①:askUser → 原文转交人工 · briefs → lifecycle · directFix → 分区运行)
- → feature-lifecycle-auto(薄外壳:feature-plan-consensus | plan-pipeline → 闸门 ✋(autoBuild=false 时由人阅读计划)→ spec-implement-dual-review-verify)
- → 以相同参数重跑原始 audit(连接器 ②:存在于“你”之中,而非代码中)
- → confirmed == 0 且无未验证/未审计(§9.2)→ 收敛并报告;否则回到 findings-triage / 重新检查
环外的入口点:怪异 bug → root-cause-deep-dive-audit;文档/设计漂移 → 对应的 audit;单个工件需要第二模型裁决 → consensus-gate(仅一轮,仅限不可逆/行为层改动,不是默认站点);“这个项目下一步该做什么” → project-direction-review;配方清单/机器漂移 → workflow-manifest;研究(事实、价格、来源,往往多轮)→ 每轮一个 haiku-research-round,由你继续担任指挥。
阶段配方(feature-plan-consensus、plan-pipeline、spec-implement-dual-review-verify)通常经由 feature-lifecycle-auto 抵达;仅当只想要该阶段时才直接调用。参数自动填充:cli 为可选(依据 2026-09-02 用户裁定,绝不依赖 codex)。任何已安装的 agent-tmux profile 都是有效评审闸门,须选择与实质作者不同的一个;省略它则每个阶段运行一个全新 Claude opus 评审者,在独立上下文中进行。不得硬编码名称,不得因外部 CLI 未安装而阻塞运行。context 为一行(仓库绝对路径 + 技术栈 + 范围)。优先使用名称调用而非 scriptPath。
工作流代理通过 mod 工具驱动 CLI worker:mcp__tmux-agent__assign(尚无 worker)或 tell(此前调用返回的 worker;consensus-gate 第 2 轮及以后必须作为 worker 传入,否则会启动新 worker),然后用 mcp__tmux-agent__await 直到得到终止结果。agent() 内的 runtime: tmux/<profile> 行不会被拦截。
主要约束
模型下限(2026-09-02 用户裁定)
除 worker、L1/TK 评审角色与机械席位(L0 runner 与 CLI 通道:sonnet medium)外,每个配方代理至少运行在 opus effort low;默认 worker 为 opus effort medium,评审者为 high。规划、综合、修订和裁决绝不在 sonnet 或 haiku 上运行——由二者写出的计划不算计划。sonnet 5.5+ 可运行评审阶梯的 L1 预过滤(2026-10-09 用户裁定)。其余情况下,sonnet/haiku 5.5+ 可依指挥者裁定运行实现与只读数据收集(2026-10-10 用户裁定)。
顾问闸门(2026-09-02 用户裁定)
配方不能调用工具;闸门存在于“你”这位指挥者身上。当 advisor 工具可用时,在以下时点为强制:首次 Workflow 启动之前(简报、配方、参数、模型下限、cli 省略或说明理由、轮次上限、硬性时限);配方返回的每个人工闸门处(计划本身、其规模、是否构建);任何中止后恢复/重启之前。无顾问裁决则不得启动、恢复或构建。
跨运行时执行
两种运行时都通过此路由器运行配方,只是执行载体不同。Claude Code 用 Workflow() 原生执行 .workflow.js。Codex 经由 ADAPTED: claude-workflow-runner 执行,约束包括:分派恰好一个 Claude runner 前必须冻结配方名、参数、验收标准、作者运行时与评审 profile;runner 必须恰好调用一个原生 Workflow(...),把返回值保留在 recipe_result 下,写出 schema-v1 result.json 后停止;后续异常必须把嵌套上限设为 2、声明子 profile/轮次上限、使用唯一会话与等待型结果,并禁止子级再生成;人工闸门必须返回 status: paused 加 next_action,保留 recipe_result,停止 runner,且仅在获得新的显式批准调用后才恢复;证据必须注明“配方 <name> 通过 runner 在 Claude 运行时原生执行(由 Codex 指挥)”,适配器或子级失败绝不等于配方 PASS。
资料给出运行时矩阵:13 份配方在 Claude Code 全部为 NATIVE。Codex 列方面:3 个 audit、findings-triage、project-direction-review、workflow-manifest(6 个,内部无 tmux)为 ADAPTED: claude-workflow-runner;haiku-research-round 与 pr-review-triage-resolve 标记为 UNTESTED(目前仅在 Claude 上原生运行,须停止并报告);consensus-gate(仅简单裁决结果)为 ADAPTED: direct-claude-review;consensus-gate(作为配方)、lifecycle 及其 3 个阶段在 cli 已设置时(5 个,内部驱动 tmux-agent mod worker)为 UNAVAILABLE-NATIVE,直到嵌套 runner(深度 2)测试通过,须停止并报告,不得即兴发挥。
其他 DEFER 事项
仅从顶层链接配方——workflow() 嵌套上限为 1,而 lifecycle 外壳会耗尽它。run 目录仅在工作跨越数天、含 2 个以上阶段、或必须承受中断/交接时使用;聊天内的工作写一个结果文件,或什么都不写。配方编辑:行为层改动需先经 consensus-gate 一轮;措辞改动可直接进行。规范版本为 agent-scripts 仓库 bundle,部署到 ~/.claude/workflows/;机器侧的实时编辑必须在同一改动中折回 bundle。
NOT-FOUND 处理
没有配方匹配 → 该工作多半不是循环形态,应 bypass。若确实是新的循环形态 → 向用户提议新配方;绝不在行内即兴拼凑半份配方。
适用场景与限制
适用:需要多阶段、带收敛条件的智能体循环工作,如审计、共识评审、计划到构建、发现项分诊、多轮研究、项目方向评审、配方清单巡检。
限制:不适合单上下文、单次完成的有界任务;不适用于本身只是一次工具调用的事实查询(除跨来源多轮研究外);Codex 运行时存在多项 UNTESTED 与 UNAVAILABLE-NATIVE 限制,须停止并报告而非即兴发挥;依赖模型下限、顾问闸门与人工闸门的强制约束;嵌套上限为 1。
关于收费、价格、平台支持范围等具体信息,资料未提供。