codex-dynamic-workflows

AI Agent 动态工作流

使用此技能，将大型任务转化为受监督的 AI Agent 工作流：起草编排文档；在用户要求持续执行时进入目标模式；条件允许时将互不重叠的工作委派给子 Agent；整合结果；验证成果；并保存可复用的工作流文档。

此技能适用于支持技能的 Agent。除非当前环境提供相应的运行器，否则不要声称本地脚本可以调用子 Agent 工具。如果没有可编程的运行器，请创建可供人阅读的编排脚本，并通过可用的 Agent 工具执行。

决策规则

用户要求动态编排时使用此技能。仅任务复杂、风险较高或存在并行工作线，并不足以触发此技能。在获准的工作流中，只选择能产出具体独立成果的委派方式。

操作约定

使用此技能时：

1. 重述目标和成功标准。
2. 委派任务前，创建或更新工作流文档。
3. 对照下方的界限检查重大操作是否获准；对于范围内已获授权的操作，不要再次询问。
4. 仅在用户或系统／开发者指令明确要求时才创建目标；普通的多轮工作并不代表获准创建目标。
5. 将工作拆分为互不重叠的任务包，并明确各自负责人。
6. 仅当当前环境支持且用户已授权委派或并行 Agent 工作时，才启动子 Agent。
7. 如果没有子 Agent 运行器，则在本地进行独立检查，并将其标记为主 Agent 工作，而非子 Agent 的结果。
8. 明确整合结果；不要将子 Agent 的原始输出直接粘贴为最终答案。
9. 根据任务的影响范围，执行相应检查进行验证。
10. 仅在有助于未来工作时保存可复用的文档。

工作流文档

优先创建本地运行目录：

.workflow/<slug>/
|-- plan.md
|-- state.json
|-- orchestration.md
|-- packets/
|-- results/
`-- final-report.md

使用 scripts/new_workflow.py 搭建此结构：

python3 /path/to/codex-dynamic-workflows/scripts/new_workflow.py "Task title"

让 plan.md 保持易读。使用 state.json 记录状态、任务包 ID、审批状态和验证状态。将 orchestration.md 作为可执行的思维模型：记录 Agent 将遵循的步骤、分支规则和任务包提示词。

编排计划

起草一份简洁的计划，包含：

Goal:
Success criteria:
Current context:
Constraints:
Risks:
Approval required:
Workflow artifact path:
Work packets:
Integration policy:
Verification:
Reusable artifacts:

不要为显而易见的工作过度规划。计划应详细到足以指导任务委派和验证，但不能取代实际执行。

审批关卡

进行重大操作前，先取得缺失的授权：向指定目的地发布或发送内容、修改生产环境、执行破坏性删除或重写历史记录、更改凭证／账户／安全设置，或执行成本显著的工作负载。已有的明确授权在其适用范围内持续有效。一般性的实现请求并不授权无关的外部操作。可以继续进行已获授权的本地编辑（包括作为所请求变更的一部分替换文件内容），以及相关的一次性测试夹具检查。准备好具体成果后，再就任何缺失的授权征求确认。在重大操作等待审批期间，继续进行独立的准备和修复工作。

如果无法确定某项操作是否已获授权，请参阅 risk-gates.md。

目标模式

仅当用户或系统／开发者指令明确要求，且当前工具约定支持时，才创建目标。要求运行工作流、连续工作数轮或继续实施，本身并不代表要求创建受跟踪的目标。保留任何已获授权目标的完整目标内容。

工作包

每个工作包都必须是自包含的：

Packet ID:
Objective:
Context:
Files / sources:
Ownership:
Do:
Do not:
Expected output:
Verification:

优先选择归属范围互不重叠的工作包：

• 代码库探索
• 依赖或 API 调研
• 实现切片
• 测试和固定数据
• 文档和示例
• UX 或产品评审
• 安全或风险评审
• 最终验证

对于代码编辑工作包，分配互不重叠的文件或模块。告知工作者，代码库中还有其他人参与；不得撤销他人的修改，并且必须适应并发变更。

子 Agent

有子 Agent 运行器时：

• 只启动具体、有明确边界且确实有用的子任务。
• 将眼下的阻塞性工作留在本地处理。
• 委派可与主 Agent 工作并行进行的辅助工作。
• 避免多个 Agent 重复工作。
• 只有在写入范围清晰且互不重叠时，才让工作者直接编辑文件。
• 只有在需要子 Agent 的结果来推进关键路径的下一步时，才等待其完成。

没有子 Agent 运行器时：

• 在本地分批执行互相独立的工作包，并标记为主 Agent 工作。
• 每轮只读取与当前工作包相关的文件。
• 将工作包笔记写入 results/。
• 只有在各工作包的产出分别保存后，才进行整合。

整合

所有工作包完成后，综合整理：

Accepted:
Rejected:
Conflicts:
Decisions:
Final changes:
Remaining risks:

明确解决冲突。如果两个工作包的结论不一致，请检查权威来源后再作选择。

使用 scripts/collect_results.py 根据结果文件生成整合检查清单：

python3 /path/to/codex-dynamic-workflows/scripts/collect_results.py .workflow/<slug>

验证

先运行范围最小且可靠的检查，再根据风险逐步扩大范围：

• 针对修改代码的单元测试
• 类型检查或 lint
• 构建
• 浏览器或 UI 冒烟测试
• 脚本试运行
• 源代码引用检查
• 迁移试运行
• 非代码工作的手动检查清单

使用 scripts/verify_workflow.py 检查工作流产物是否完整：

python3 /path/to/codex-dynamic-workflows/scripts/verify_workflow.py .workflow/<slug>

如实报告跳过的检查。只有在证据证明已满足原始成功标准后，才能将工作流视为完成。

可复用方案

如果某次运行产生了实用的模式，请将其保存为简明方案，放在适合项目的位置，例如 .workflow/recipes/<name>.md 或仓库文档目录。内容包括：

• 触发条件
• 计划结构
• 工作包列表
• 验证检查清单
• 已知风险

不要保存对话记录、机密信息、冗长日志、凭证或敏感个人信息。

参考资料

• 当机器可读的工作流计划有用时，阅读 references/plan-schema.md。
• 执行高风险或有歧义的操作前，阅读 references/risk-gates.md。
• 在前向测试或改进此技能时，阅读 references/validation-examples.md。