SuperAPI AI 工具集

dynamic-workflow

智能体与模型

查看项目

更新于 10-17 04:47

技能介绍

Dynamic Workflow 是 pchalasani/claude-code-tools 中的一项技能,用于编排多个无头 Codex 智能体完成可由 JavaScript 控制流表达的任务。

用途:它把控制流交给确定性的 JavaScript 程序,把推理与工具操作交给独立的 Codex 工作进程。运行时直接调用 codex exec --json,除正常的 Codex CLI 认证外不需要 MCP 或额外 API 密钥。

主要能力:支持创建、审查、运行、检查、暂停、恢复和取消持久化工作流;支持发现条目后分派并行工作进程再汇总、并行运行异构代理并合并结果、依据结构化输出分支或循环、后台长任务持久化进度、复用或移植已有工作流脚本。工作流脚本使用注入的全局变量、顶层 await 和顶层 return,可保存到 .codex/workflows/<name>.js。

使用方式:需 Node.js 20 或更新版本,提交的 bundle 无需 npm install。先定位 runner(SKILL.md 上两级目录中的 bin/workflow.mjs),验证 node、codex 版本并运行 help;阅读 references/workflow-api.md,可从 assets/workflow-template.js 起步;编写脚本后用 validate 校验语法;向用户展示源码并说明代理数量、并发、超时、沙箱模式和成本,获得明确启动批准后运行。运行命令示例:node "$RUNNER" run .codex/workflows/<name>.js --cwd "$PWD" --input '{"target":"src"}';长任务可加 --detach --json。状态、日志和等待分别用 status <run-id> --json、logs <run-id>、wait <run-id> --json。暂停、恢复、取消为协作式操作。

使用限制与注意事项:工作流代码没有注入文件系统、shell、进程或模块导入权限,此类工作交由沙箱代理完成;Node VM 只是能力边界,并非加固的恶意代码沙箱,运行前必须审查生成的代码。写入型工作流需显式授权(--allow-workspace-write),danger-full-access 需单独批准。结构化输出 schema 要求 additionalProperties: false,且每个属性都列入 required。回调通知需要 Codex CLI 0.136.0 或更新版本,app-server 与 remote TUI 接口仍标记为实验性。codex-dynamic 辅助命令来自 claude-code-tools Python 包,插件本身不依赖该包。