CEWP 是一个为 Codex CLI 设计的本地优先工程工作流工具包，支持 Coordinator Mode 多智能体协调、工作树隔离、受保护的执行分发和并行工作流。

• 原作者/维护者：SetraTheXX
• 来源平台：github
• 原始标题：Codex-Engineering-Workflow-Pack
• 原始链接：https://github.com/SetraTheXX/Codex-Engineering-Workflow-Pack
• 来源发布时间/更新时间：2026-06-07T22:15:26Z

Codex Engineering Workflow Pack：本地优先的多智能体工程工作流工具包\n\n在 AI 辅助编程工具日益普及的今天，如何有效组织多个 AI 智能体协同工作成为一个关键挑战。Codex Engineering Workflow Pack（CEWP）应运而生，它是一个专为 Codex CLI 设计的本地优先工程工作流工具包，通过结构化的多智能体协调机制，为开发者提供了一套完整的工程自动化解决方案。\n\n## 原作者与来源\n\n- 原作者/维护者：SetraTheXX\n- 来源平台：GitHub\n- 原始标题：Codex-Engineering-Workflow-Pack\n- 原始链接：https://github.com/SetraTheXX/Codex-Engineering-Workflow-Pack\n- 发布时间：2026年6月7日\n- 当前版本：0.2.0-beta.2\n- 许可证：MIT\n\n## 背景与动机\n\n随着 OpenAI Codex 等 AI 编程助手的兴起，开发者开始探索如何将这些工具整合到实际工程流程中。然而，单个 AI 会话往往难以处理复杂的工程任务，特别是在需要多人协作、代码审查和并行开发的场景下。CEWP 的设计初衷就是解决这一痛点，它借鉴了传统软件工程中的最佳实践，将其适配到 AI 驱动的开发环境中。\n\n该项目的核心理念是"本地优先"——所有操作都在用户的本地环境中执行，不会自动推送到远程仓库或自动合并代码。这种设计既保证了安全性，又给予开发者充分的控制权。\n\n## 核心功能概览\n\nCEWP 提供了一套完整的工具链，涵盖从项目初始化到多智能体协调的各个环节：\n\n### 1. 工程工作流技能集\n\nCEWP 内置了 10 个可复用的工程工作流技能，包括：\n\n- 项目初始化（init）：快速设置项目结构和配置文件\n- 诊断工具（doctor）：检查环境配置和依赖状态\n- 技能列表（list）：查看可用的工作流技能\n- 测试驱动开发（TDD）：支持测试优先的开发模式\n- 需求文档（PRD）：帮助编写产品需求文档\n- 任务拆分（issue slicing）：将大任务分解为可管理的子任务\n- 工作交接（handoff）：支持多开发者之间的上下文传递\n- 原型开发（prototyping）：快速验证想法\n- 架构评审（architecture review）：代码和架构审查支持\n- 上下文映射（context mapping）：管理项目上下文和依赖关系\n\n### 2. Coordinator Mode 协调器模式\n\n这是 CEWP 最具特色的功能。Coordinator Mode 提供了一个本地运行时环境，用于协调多个 AI 智能体协同工作：\n\n角色分工：\n- Manager（管理器）：负责任务规划和分配\n- Worker（工作者）：在隔离的工作树中执行具体任务\n- Reviewer（审查者）：验证工作成果并给出决策\n- Operator（操作员）：人类用户，拥有最终决策权\n\n典型工作流程：\n\nbash\n# 初始化一个包含2个工作者和1个审查者的运行\ncewp run init --workers 2 --reviewer\n\n# 创建隔离的工作树\ncewp run worktrees create --run <run-id>\n\n# 预览执行计划（干运行）\ncewp run dispatch pipeline --run <run-id> --adapter codex-exec --dry-run\n\n# 实际执行（并行模式）\ncewp run dispatch pipeline --run <run-id> --adapter codex-exec --yes --parallel --timeout 120\n\n# 审查和最终化\ncewp run finalize --run <run-id> --dry-run\ncewp run finalize --run <run-id>\n\n# 清理\ncewp run cleanup --run <run-id>\n\n\n### 3. 工作树隔离机制\n\nCEWP 使用 Git 工作树（worktree）实现真正的并行开发环境。每个 Worker 都在独立的工作树中工作，互不干扰。这种设计避免了传统单分支开发中的冲突问题，同时也便于审查者对比不同实现方案。\n\n### 4. 受保护的执行分发\n\n所有通过 codex-exec 适配器的执行都受到保护机制约束：\n\n- 作用域检查：验证工作树变更和分支提交\n- 基础提交对比：与注册的基础提交进行对比，防止意外修改\n- 操作员策略：支持三种权限模式——safe（安全）、trusted（信任）、full-authority（完全授权）\n\n### 5. 审查者决策机制\n\nReviewer 智能体可以做出明确的决策：\n- PASS：通过，可以合并\n- REQUEST_CHANGES：需要修改\n- BLOCK：阻止合并\n\n这种明确的决策机制避免了模糊的反馈，提高了协作效率。\n\n## 操作员策略模式\n\nCEWP 支持三种操作员策略，存储在 .cewp/policy.json 中：\n\n| 模式 | 描述 | 适用场景 |\n|------|------|----------|\n| safe | 默认模式，所有高风险操作需要确认 | 生产环境、新手用户 |\n| trusted | 减少确认提示，但仍保留关键检查 | 熟悉工具的用户 |\n| full-authority | 高级模式，但仍保留 CEWP 保护机制 | 专家用户、紧急修复 |\n\n值得注意的是，即使在 full-authority 模式下，CEWP 也不会自动执行推送、发布或创建发布版本等操作。这些操作始终需要显式授权。\n\n## 安全模型\n\nCEWP 的安全设计遵循以下原则：\n\n1. 本地优先：所有操作在本地执行，不涉及远程自动推送\n2. 审批门控：关键操作需要显式确认（--yes 标志）\n3. 干运行默认：cleanup 和 prune 等命令默认执行干运行\n4. 作用域验证：Worker 执行前检查工作树和分支状态\n5. 不可变基础提交：注册的基础提交作为变更对比的基准\n\n## 实际应用场景\n\n### 场景一：文档重构\n\n假设你需要重构项目文档，可以将任务拆分为：\n- Worker 1：更新 API 文档\n- Worker 2：重写入门指南\n- Reviewer：检查文档一致性和准确性\n\n\nUse CEWP Coordinator Mode to implement this docs-only change with two workers and a reviewer. Show me the plan before dispatch.\n\n\n### 场景二：功能并行开发\n\n对于新功能开发，可以分配多个 Worker 并行处理不同模块，Reviewer 统一审查后合并。\n\n### 场景三：代码审查自动化\n\n利用 CEWP 的审查技能，可以建立自动化的代码审查流程，Reviewer 智能体根据预设标准检查代码质量。\n\n## 技术实现细节\n\n### 文件结构\n\nCEWP 在项目中创建 .cewp/ 目录，结构如下：\n\n\n.cewp/\n├── policy.json # 操作员策略配置\n├── runs/ # 运行实例目录\n│ └── <run-id>/ # 单次运行的隔离空间\n│ ├── workers/ # 工作者工作树\n│ ├── review/ # 审查结果\n│ └── logs/ # 执行日志\n└── skills/ # 本地技能配置\n\n\n### 适配器机制\n\nCEWP 通过适配器机制与不同的 AI 执行环境集成。目前支持 codex-exec 适配器，未来可能扩展支持其他 AI 编程工具。\n\n### 提示词打包\n\nCEWP 使用"提示词打包"技术，将任务上下文、约束条件和预期输出格式打包成结构化提示，确保 AI 智能体理解任务要求。\n\n## 与现有工具的对比\n\n| 特性 | CEWP | 传统 CI/CD | 单会话 AI |\n|------|------|-----------|-----------|\n| 本地执行 | ✅ | ❌ | ✅ |\n| 多智能体协调 | ✅ | ❌ | ❌ |\n| 工作树隔离 | ✅ | ⚠️ | ❌ |\n| 人工审批门控 | ✅ | ⚠️ | ❌ |\n| 代码审查集成 | ✅ | ⚠️ | ❌ |\n| 并行开发 | ✅ | ✅ | ❌ |\n\n## 局限性与注意事项\n\n作为 Beta 软件（0.2.0-beta.2），CEWP 目前存在以下局限：\n\n1. 仅支持 Codex CLI：目前专为 OpenAI Codex 设计\n2. Beta 稳定性：可能存在未发现的 bug\n3. 学习曲线：需要理解多智能体协调的概念\n4. 手动集成：需要开发者主动集成到工作流中\n\n## 总结与展望\n\nCodex Engineering Workflow Pack 代表了 AI 辅助编程工具的演进方向——从单一会话到多智能体协作，从简单提示到结构化工作流。它的本地优先理念和严格的安全模型使其特别适合对代码质量有要求的工程团队。\n\n随着 AI 编程工具的普及，类似 CEWP 这样的工作流协调工具将成为开发者工具链的重要组成部分。它不仅提高了开发效率，更重要的是引入了工程化的最佳实践，让 AI 辅助开发更加可控、可审计、可复现。\n\n对于希望探索多智能体协作开发的团队，CEWP 提供了一个低门槛的入门方案。通过其丰富的文档和示例，开发者可以快速上手并根据自己的需求定制工作流。

原作者与来源

• 原作者/维护者：SetraTheXX
• 来源平台：github
• 原始标题：Codex-Engineering-Workflow-Pack
• 原始链接：https://github.com/SetraTheXX/Codex-Engineering-Workflow-Pack
• 来源发布时间/更新时间：2026-06-07T22:15:26Z Codex Engineering Workflow Pack：本地优先的多智能体工程工作流工具包\n\n在 AI 辅助编程工具日益普及的今天，如何有效组织多个 AI 智能体协同工作成为一个关键挑战。Codex Engineering Workflow Pack（CEWP）应运而生，它是一个专为 Codex CLI 设计的本地优先工程工作流工具包，通过结构化的多智能体协调机制，为开发者提供了一套完整的工程自动化解决方案。\n\n原作者与来源\n\n- 原作者/维护者：SetraTheXX\n- 来源平台：GitHub\n- 原始标题：Codex-Engineering-Workflow-Pack\n- 原始链接：https://github.com/SetraTheXX/Codex-Engineering-Workflow-Pack\n- 发布时间：2026年6月7日\n- 当前版本：0.2.0-beta.2\n- 许可证：MIT\n\n背景与动机\n\n随着 OpenAI Codex 等 AI 编程助手的兴起，开发者开始探索如何将这些工具整合到实际工程流程中。然而，单个 AI 会话往往难以处理复杂的工程任务，特别是在需要多人协作、代码审查和并行开发的场景下。CEWP 的设计初衷就是解决这一痛点，它借鉴了传统软件工程中的最佳实践，将其适配到 AI 驱动的开发环境中。\n\n该项目的核心理念是"本地优先"——所有操作都在用户的本地环境中执行，不会自动推送到远程仓库或自动合并代码。这种设计既保证了安全性，又给予开发者充分的控制权。\n\n核心功能概览\n\nCEWP 提供了一套完整的工具链，涵盖从项目初始化到多智能体协调的各个环节：\n\n1. 工程工作流技能集\n\nCEWP 内置了 10 个可复用的工程工作流技能，包括：\n\n- 项目初始化（init）：快速设置项目结构和配置文件\n- 诊断工具（doctor）：检查环境配置和依赖状态\n- 技能列表（list）：查看可用的工作流技能\n- 测试驱动开发（TDD）：支持测试优先的开发模式\n- 需求文档（PRD）：帮助编写产品需求文档\n- 任务拆分（issue slicing）：将大任务分解为可管理的子任务\n- 工作交接（handoff）：支持多开发者之间的上下文传递\n- 原型开发（prototyping）：快速验证想法\n- 架构评审（architecture review）：代码和架构审查支持\n- 上下文映射（context mapping）：管理项目上下文和依赖关系\n\n2. Coordinator Mode 协调器模式\n\n这是 CEWP 最具特色的功能。Coordinator Mode 提供了一个本地运行时环境，用于协调多个 AI 智能体协同工作：\n\n角色分工：\n- Manager（管理器）：负责任务规划和分配\n- Worker（工作者）：在隔离的工作树中执行具体任务\n- Reviewer（审查者）：验证工作成果并给出决策\n- Operator（操作员）：人类用户，拥有最终决策权\n\n典型工作流程：\n\nbash\n初始化一个包含2个工作者和1个审查者的运行\ncewp run init --workers 2 --reviewer\n\n创建隔离的工作树\ncewp run worktrees create --run <run-id>\n\n预览执行计划（干运行）\ncewp run dispatch pipeline --run <run-id> --adapter codex-exec --dry-run\n\n实际执行（并行模式）\ncewp run dispatch pipeline --run <run-id> --adapter codex-exec --yes --parallel --timeout 120\n\n审查和最终化\ncewp run finalize --run <run-id> --dry-run\ncewp run finalize --run <run-id>\n\n清理\ncewp run cleanup --run <run-id>\n\n\n3. 工作树隔离机制\n\nCEWP 使用 Git 工作树（worktree）实现真正的并行开发环境。每个 Worker 都在独立的工作树中工作，互不干扰。这种设计避免了传统单分支开发中的冲突问题，同时也便于审查者对比不同实现方案。\n\n4. 受保护的执行分发\n\n所有通过 codex-exec 适配器的执行都受到保护机制约束：\n\n- 作用域检查：验证工作树变更和分支提交\n- 基础提交对比：与注册的基础提交进行对比，防止意外修改\n- 操作员策略：支持三种权限模式——safe（安全）、trusted（信任）、full-authority（完全授权）\n\n5. 审查者决策机制\n\nReviewer 智能体可以做出明确的决策：\n- PASS：通过，可以合并\n- REQUEST_CHANGES：需要修改\n- BLOCK：阻止合并\n\n这种明确的决策机制避免了模糊的反馈，提高了协作效率。\n\n操作员策略模式\n\nCEWP 支持三种操作员策略，存储在 .cewp/policy.json 中：\n\n| 模式 | 描述 | 适用场景 |\n|------|------|----------|\n| safe | 默认模式，所有高风险操作需要确认 | 生产环境、新手用户 |\n| trusted | 减少确认提示，但仍保留关键检查 | 熟悉工具的用户 |\n| full-authority | 高级模式，但仍保留 CEWP 保护机制 | 专家用户、紧急修复 |\n\n值得注意的是，即使在 full-authority 模式下，CEWP 也不会自动执行推送、发布或创建发布版本等操作。这些操作始终需要显式授权。\n\n安全模型\n\nCEWP 的安全设计遵循以下原则：\n\n1. 本地优先：所有操作在本地执行，不涉及远程自动推送\n2. 审批门控：关键操作需要显式确认（--yes 标志）\n3. 干运行默认：cleanup 和 prune 等命令默认执行干运行\n4. 作用域验证：Worker 执行前检查工作树和分支状态\n5. 不可变基础提交：注册的基础提交作为变更对比的基准\n\n实际应用场景\n\n场景一：文档重构\n\n假设你需要重构项目文档，可以将任务拆分为：\n- Worker 1：更新 API 文档\n- Worker 2：重写入门指南\n- Reviewer：检查文档一致性和准确性\n\n\nUse CEWP Coordinator Mode to implement this docs-only change with two workers and a reviewer. Show me the plan before dispatch.\n\n\n场景二：功能并行开发\n\n对于新功能开发，可以分配多个 Worker 并行处理不同模块，Reviewer 统一审查后合并。\n\n场景三：代码审查自动化\n\n利用 CEWP 的审查技能，可以建立自动化的代码审查流程，Reviewer 智能体根据预设标准检查代码质量。\n\n技术实现细节\n\n文件结构\n\nCEWP 在项目中创建 .cewp/ 目录，结构如下：\n\n\n.cewp/\n├── policy.json 操作员策略配置\n├── runs/ 运行实例目录\n│ └── <run-id>/ 单次运行的隔离空间\n│ ├── workers/ 工作者工作树\n│ ├── review/ 审查结果\n│ └── logs/ 执行日志\n└── skills/ 本地技能配置\n\n\n适配器机制\n\nCEWP 通过适配器机制与不同的 AI 执行环境集成。目前支持 codex-exec 适配器，未来可能扩展支持其他 AI 编程工具。\n\n提示词打包\n\nCEWP 使用"提示词打包"技术，将任务上下文、约束条件和预期输出格式打包成结构化提示，确保 AI 智能体理解任务要求。\n\n与现有工具的对比\n\n| 特性 | CEWP | 传统 CI/CD | 单会话 AI |\n|------|------|-----------|-----------|\n| 本地执行 | ✅ | ❌ | ✅ |\n| 多智能体协调 | ✅ | ❌ | ❌ |\n| 工作树隔离 | ✅ | ⚠️ | ❌ |\n| 人工审批门控 | ✅ | ⚠️ | ❌ |\n| 代码审查集成 | ✅ | ⚠️ | ❌ |\n| 并行开发 | ✅ | ✅ | ❌ |\n\n局限性与注意事项\n\n作为 Beta 软件（0.2.0-beta.2），CEWP 目前存在以下局限：\n\n1. 仅支持 Codex CLI：目前专为 OpenAI Codex 设计\n2. Beta 稳定性：可能存在未发现的 bug\n3. 学习曲线：需要理解多智能体协调的概念\n4. 手动集成：需要开发者主动集成到工作流中\n\n总结与展望\n\nCodex Engineering Workflow Pack 代表了 AI 辅助编程工具的演进方向——从单一会话到多智能体协作，从简单提示到结构化工作流。它的本地优先理念和严格的安全模型使其特别适合对代码质量有要求的工程团队。\n\n随着 AI 编程工具的普及，类似 CEWP 这样的工作流协调工具将成为开发者工具链的重要组成部分。它不仅提高了开发效率，更重要的是引入了工程化的最佳实践，让 AI 辅助开发更加可控、可审计、可复现。\n\n对于希望探索多智能体协作开发的团队，CEWP 提供了一个低门槛的入门方案。通过其丰富的文档和示例，开发者可以快速上手并根据自己的需求定制工作流。