Codex Collaborator Skill

Purpose

标准化与 Codex MCP 的四阶段协作，确保：

• 需求分析充分且经过验证
• 代码原型以安全的 unified diff 形式提供
• 实现过程有明确的基线参考
• 代码审查全面且经过批判性思考

When to Use（决策树）

基于影响范围/风险判断，而非文件数量：

不适用：简单的单次代码生成（直接使用 Codex MCP 工具即可）

状态机与回退规则

┌─────┐     ┌─────┐     ┌─────┐     ┌─────┐
│  A  │ ──→ │  B  │ ──→ │  C  │ ──→ │  D  │ ──→ 完成
└──┬──┘     └──┬──┘     └──┬──┘     └──┬──┘
   │           │           │           │
   │           │           │           ↓
   │           │           │      D→C (功能缺陷)
   │           │           ↓
   │           │      C→B (原型不足)
   │           ↓
   │      B→A (需求变更)
   ↓
  终止 (需求不成立)

回退限制：每个方向最多回退 1 次，超出需复盘/拆分任务或终止

阶段快照

核心约束

只读安全

• 所有 Codex 调用：sandbox="read-only"
• 阶段 B 只能要求 unified diff 格式
• 拒收任何写命令、脚本或非 diff 输出；指出违规并重试

批判性质询

• 每阶段至少 1 个具体质疑，拒绝模糊回答
• 记录问答，作为决策依据
• 质询维度：需求遗漏/假设、设计完整性、安全与性能、回滚与代价

SESSION_ID 管理

• 首次调用自动生成，后续调用全程复用
• 在 TodoWrite 中显式记录
• 阶段结束时复述确认

快速上手示例

场景：用户要求"为 Android 应用添加分享功能"

## 1. 判断流程
新功能模块 + 跨模块影响 → 使用全流程 A→B→C→D

## 2. 阶段 A - 需求分析
调用 Codex（sandbox="read-only"）：
- PROMPT: "分析分享功能需求，补全边界场景和风险..."
- 获取 SESSION_ID: 019aabca-a9f3-7783-8343-3deca9526275
- 质询: "是否考虑了离线模式？"
- 记录确认需求

## 3. 阶段 B - 原型获取
调用 Codex（同一 SESSION_ID）：
- PROMPT: "生成 unified diff 原型，包含 ViewModel、Repository..."
- 验证格式（无写入命令）
- 质询: "是否遗漏了 FileProvider 配置？"
- 归档原型

## 4. 阶段 C - 实现
- 基于原型重写生产级代码
- 记录偏差: "添加了 Logger 日志记录"
- 运行测试

## 5. 阶段 D - 审查
调用 Codex 审查 → 质询审查结论 → 通过/返回修复

一页清单

• 决策树选流程；声明只读；收集/复述 SESSION_ID
• A：需求清单 + 风险 + 至少 1 质询
• B：unified diff + 设计说明 + 质询；格式/安全检查
• C：实现 + 偏差说明 + 测试；必要时仅一次回 B
• D：审查 + 质询；如需回 C 仅一次；残留风险与经验复盘

参考文档

• 详细流程与质询技巧：references/flow.md
• PROMPT 模板库：references/templates.md
• 完整示例：examples.md