# Codex MCP Skill

一个通过标准 MCP 工具调用接口，协作 Codex 处理复杂技术任务的 Claude Code 技能。

## 快速入门

### 何时使用
当您遇到以下场景时，此技能会自动激活：

| 场景 | 示例触发词 |
|------|-----------|
| **复杂算法设计** | "设计一个并发数据处理算法..." |
| **性能优化** | "优化这个状态机，p99 延迟需要 < 100ms" |
| **架构评审** | "分析系统架构，支持 10x 扩展" |
| **代码审查** | "审查这段代码的线程安全问题" |

### 核心触发词
- "深度分析"、"复杂逻辑"、"算法设计"
- ">10行核心代码"、"状态机"
- "架构优化"、"性能瓶颈"

### 典型示例

#### 算法设计
```markdown
我需要设计一个限流算法：
- 处理 10K requests/sec
- 每用户限制：100 req/min
- 全局限制：10K req/sec
- 延迟：<1ms 开销
当前滑动窗口方案在大规模下太慢。
推荐什么算法？
```

#### 架构评审
```markdown
请评审我们的微服务架构，从 1K 扩展到 10K req/sec：

当前：API Gateway → 5个服务 → PostgreSQL + Redis

挑战：
- 数据库在 p99 成为瓶颈
- 服务紧耦合
- 缺乏明确的缓存策略

建议哪些改进？
```

#### 代码审查
```markdown
审查这个并发数据处理器，关注：
- 线程安全问题
- 性能瓶颈
- 内存泄漏
- 更好的设计模式

[代码]

担心热路径中的互斥锁使用。
```

## 使用流程

### 1. 描述您的任务
直接用自然语言描述复杂技术问题，包含：
- 问题的背景和上下文
- 具体的约束（性能、规模、安全等）
- 您已经尝试过的方法

### 2. 提供必要信息
确保包含：
- **约束条件**：时间/空间复杂度、性能要求
- **测试用例**：边界情况、预期行为
- **现有代码**：相关实现（如果有）
- **上下文**：使用场景、依赖关系

### 3. 接收 Codex 分析
Claude 会将您的请求格式化并传递给 Codex，Codex 将提供：
- 设计文档或伪代码
- 实现策略和最佳实践
- 测试用例建议
- 性能分析和优化建议

### 4. 验证和实施
使用 [REFERENCE.md](REFERENCE.md) 中的集成指南验证建议：
- 检查逻辑正确性
- 验证性能声明
- 测试与现有代码的兼容性

## 关键特性

### ✅ MCP 工具调用
- **工具名称**：
  - 开启会话：`mcp__codex-mcp-tool__codex`
  - 继续对话：`mcp__codex-mcp-tool__codex-reply`
- **会话管理**：返回的 `conversationId` 用于后续对话
- **灵活配置**：支持模型选择、沙盒模式、审批策略等参数
- **详细说明**：查看 [SKILL.md](SKILL.md) 获取完整的工具调用示例

### ✅ 协作模板
内置标准模板：
- 标准任务交接
- 算法设计请求
- 架构评审请求

### ✅ 最佳实践指导
- 完整的上下文准备
- 有效的问题提问
- 安全的集成策略

## 文件结构

```
codex-mcp/
├── SKILL.md                    # 主要技能定义
├── README.md                   # 快速入门（本文件）
├── REFERENCE.md               # 完整参考指南
└── HANDOFF_CHECKLIST.md       # 交接检查清单
```

## 成功技巧

### 快速激活
使用明确的触发词：
- "需要深度分析..."
- "设计复杂算法..."
- "审查这段代码..."
- "架构优化建议..."

### 提供上下文
- ✅ 具体约束（"p99 < 100ms"）
- ✅ 现有代码示例
- ✅ 测试用例
- ❌ 模糊描述（"代码很慢"）

### 有效提问
- 问具体问题，避免"怎么优化？"这类宽泛问题
- 提供成功标准（"如何达到 <500ms？"）
- 说明优先级（"准确性 > 性能"）

## 故障排除

**技能未激活？**
- 添加触发词："深度分析"、"算法设计"
- 明确规模：">10 行逻辑"、"复杂状态机"
- 直接说明："我需要 Codex 的帮助..."

**响应不适用？**
- 检查是否传达了所有约束
- 验证上下文假设
- 请求替代方案或澄清

**集成问题？**
- 遵循 REFERENCE.md 中的集成指南
- 先在隔离环境测试
- 准备回滚计划

## 版本历史

- **v2.0** (2025-11-05): 精简重构
  - 大幅减少文档冗余
  - 明确 MCP 工具调用方法
  - 优化使用体验
- **v1.0** (2025-11-05): 初始发布

## 许可证

CCode 技能插件的一部分。