SuperAPI AI 工具集

codex-dynamic-workflows

智能体与模型

查看项目

更新于 10-16 05:01

技能介绍

用途:在支持技能(skills)的代理中,判断某个 Codex 任务是否需要动态工作流编排,并在触发条件确实成立时搭建并运行该工作流。有效工作流应包含明确成功契约、互不重叠的工作包、集成策略以及风险匹配的验证。

触发边界:当用户明确要求 swarm、子代理、并行代理、多智能体工作流、动态工作流、代理编排,或要求跨独立工作包组合研究、实现、审查与验证时才触发。普通代码审查或 PR 审查、仅规划讨论、单线程小修复、可单代理直接检查编辑验证的常规审计或迁移,以及没有分包编排需求的“大型”“审计”“迁移”等宽泛措辞,不触发本技能。若任务过小但被点名,应说明无需完整编排并直接进行。

决策规则:存在明确触发词,或至少具备两个独立工作流维度(研究/依赖调查、跨互斥文件的实现、专门审查、测试验证、文档交接、可复用工作流配方等)时可使用。风险可增强编排理由,但风险本身不是触发条件。

操作契约:先重述目标与通过/失败标准,决定是否编排,选择仓库本地产物路径,风险、昂贵、外部或破坏性步骤先请求批准,仅在用户明确要求持久目标模式时才进入目标模式,将工作拆分为互斥工作包,仅在环境暴露运行器且用户授权时派生子代理,无运行器时用隔离工作包笔记模拟,显式集成结果并做与影响范围匹配的验证。

工作流产物:先检查仓库既有规划惯例与忽略规则,优先使用现有规划位置(如 .planning/、task_plan.md、progress.md、findings.md)或用户指定路径,最后才考虑 .workflow/<slug>/。可用 scripts/new_workflow.py 搭建结构,例如:python .\skills\development-workflows\codex-dynamic-workflows\scripts/new_workflow.py "Task title";Windows 回退可用 py -3。路径含空格时加引号。

工作包与子代理:每个工作包需自包含,包含 Packet ID、目标、上下文、文件/来源、归属、做什么、不做什么、预期输出与验证。无子代理运行器或未授权时,不得声称运行了 swarm,应自行执行安全本地轮次并仅在结果分离后集成。

集成与验证:集成时汇总接受、拒绝、冲突、决策、最终变更与剩余风险。可用 scripts/collect_results.py 生成集成清单,用 scripts/verify_workflow.py 检查产物就绪度。验证级别依次为 structure、ready、complete。跳过检查需如实报告。

限制:本地脚本不能声称可调用子代理工具,除非当前环境确实暴露此类运行器;目标模式不可在无 OMX/运行时目标的 Codex App 或非 tmux 环境中假装启动;不要为隐藏 .workflow/ 而修改 .gitignore;不要保存转录、密钥、凭据或敏感个人信息。部分细节(如具体支持的运行器列表、完整参考文件内容)暂未提供。