用途:这是工作流配方的“元路由器”,用于在个人层 ~/.claude/workflows/ 与当前仓库 .claude/workflows/ 之间选择并调用合适配方,并在配方返回后继续推动闭环,而不是停在原始输出。项目层同名配方会遮蔽个人层。
安装:技能自带完整配方集,可独立部署:bash <skill-dir>/scripts/install.sh(部署到 ~/.claude/workflows/),或 bash <skill-dir>/scripts/install.sh /path/to/repo/.claude/workflows 共享给团队。脚本遇内容不同的文件会拒绝覆盖,需先审阅 diff 再用 --force。权威来源是 tmux-agent-tools 仓库的 .claude/workflows/,此处为部署快照,不应就地修改。
使用方式:先“现场发现”而非凭记忆复述——列出当前实际存在的配方(遍历 ~/.claude/workflows/.workflow.js 与 .claude/workflows/.workflow.js 并提取 meta 中的 name/description)。运行候选配方前先读其头部注释,注释块即参数契约,不要猜参数。若未安装任何配方,先执行上述安装脚本。路由依靠决策树(如文档/设计与代码漂移走 docs-vs-code-audit 或 design-vs-code-audit,根因排查走 root-cause-deep-dive-audit,审计产出走 findings-triage,有简版 PRD 全量构建走 feature-lifecycle-auto 等),但当配方的 description/whenToUse 与之冲突时以现场字段为准。参数自动填充:cli 为对抗式评审类配方必需且无默认,取值顺序为用户原话→仓库 CLAUDE.md 偏好→询问一次;context 自行组织;repoPath/paths 默认当前仓库。优先用名称调用,scriptPath 可能丢参数(症状:aborted: missing arg)。
闭环:审计确认发现后自动接 findings-triage;其 askUser 项须原样呈给人、绝不自动决定意图;briefs 逐条调 feature-lifecycle-auto;directFix 走分区修复。修复/构建后以相同参数重跑原始审计:confirmed==0 表示收敛,可报告并停止;否则回到分类。限制:workflow() 嵌套上限 1 层,只能在顶层串联;codex-consensus-gate 为遗留 shim,仅顶层可用;对任何配方的行为层编辑须先过 consensus-gate,措辞/文档类可直接改。可选附加:若已安装 codex-dynamic-workflows 技能,可在目标仓库同时遵循其运行记录约定(.workflow/<slug>/ 放 plan.md、state.json、final-report.md);注意 .workflow/ 是运行产物目录,.claude/workflows/ 才是配方目录。详细参数见附带的 workflows/README.md,教程见 docs/workflow-usage-guide.md,驱动第二模型 CLI 的机制见 tmux-agent-tools 技能。