Codex-AI 协作技能

通过 MCP 工具调用 Codex CLI,处理复杂技术任务。

使用场景

触发此技能当用户提到:

• 代码审查: review、code review、审查代码
• 算法设计: 复杂算法（>10行核心逻辑）
• 架构分析: 架构评审、系统设计、扩展性分析
• 性能优化: 瓶颈分析、性能调优

何时不使用

• 简单任务（<10行代码、基本语法）
• 文档查询（使用 Context7）
• 简单调试（日志分析）
• 代码生成（直接生成即可）

工作流程

1. 识别任务类型: 代码审查/算法设计/架构分析/性能优化
2. 选择模型: 简单任务 → gpt-5.2-codex, 复杂任务 → gpt-5.2
3. 准备上下文: 收集 git diff、代码片段、约束条件
4. 调用 Codex: 使用 mcp__plugin_codex-mcp-tool_codex-mcp-tool__codex
5. 格式化输出: 展示分析结果和下一步行动

输出格式:

📊 分析结果
- 任务类型: <类型>
- 使用模型: <模型>

📝 Codex 建议
<分析结果>

💡 下一步行动
<实施建议>

MCP 工具调用

使用 mcp__plugin_codex-mcp-tool_codex-mcp-tool__codex 发起新会话:

{
  "name": "mcp__plugin_codex-mcp-tool_codex-mcp-tool__codex",
  "parameters": {
    "prompt": "<任务描述>",
    "model": "gpt-5.2-codex",
    "config": {"model_reasoning_effort": "xhigh"}
  }
}

使用 mcp__plugin_codex-mcp-tool_codex-mcp-tool__codex-reply 继续会话。

完整参数说明和示例: 查看 REFERENCE.md#MCP工具完整参考

模型选择

• gpt-5.2-codex: 简单任务（代码审查、简单重构、单一目标算法）
• gpt-5.2: 复杂任务（复杂算法、架构评审、性能优化、多约束权衡）

详细决策标准: 查看 REFERENCE.md#模型选择详解

错误处理

常见问题：

• 工具调用失败: 检查 Codex CLI 安装和配置
• 输出不符合预期: 使用 AskUserQuestion 补充信息
• 模型选择不当: 重新评估任务复杂度

完整故障排查指南: 查看 REFERENCE.md#错误处理完整指南

详细文档

• 使用场景和示例: 查看 README.md
• 完整命令参考: 查看 REFERENCE.md

Git Commit 技能

智能化的 Git 提交工作流，集成代码审查、历史分析和规范化提交信息生成。

🎯 使用场景

触发条件

• 用户明确请求创建 Git 提交
• 关键词：提交、commit、git commit、提交代码
• 用户完成代码修改后需要提交变更

典型示例

用户: "帮我提交这些代码"
用户: "审查并提交当前的修改"
用户: "创建一个 commit"
用户: "把这些改动提交到 git"

📋 工作流程

1. 检查暂存区状态

# 检查暂存区
git status --porcelain
git diff --cached --stat

# 如果暂存区为空，列出工作区文件
git status --short
git diff --name-status

决策逻辑：

• 暂存区非空 → 直接使用暂存区文件
• 暂存区为空 → 列出工作区修改文件，询问用户确认提交范围

2. 用户确认（暂存区为空时）

列出工作区文件：

# 获取所有修改、新增、删除的文件
git status --short
# 输出格式：
#  M src/main.rs        (修改)
#  A src/config.rs      (新增)
#  D old/legacy.rs      (删除)
# ?? untracked.txt      (未跟踪)

使用 AskUserQuestion 工具询问：

• 提交所有修改的文件？
• 提交特定文件？（展示上述文件清单供选择）
• 取消提交？

根据用户选择执行 git add 操作。

3. 简单代码审查

检查项：

• 语法错误（通过 cargo check、npm run lint 等）
• 明显的逻辑问题
• 调试代码残留（console.log、println!、TODO 等）
• 敏感信息泄露（密钥、令牌、凭证）

不执行深度审查（不调用 Codex MCP），保持快速反馈。

4. 分析提交历史

git log --oneline -10
git log --format="%s" -20

分析目标：

• 识别项目的提交信息风格
• 提取常用的 type 和 scope
• 保持提交风格一致性

5. 读取项目提交规范

从 Memory 中查找项目级提交规范：

# 使用项目级精确查询，避免跨项目污染
mcp__memory__search_nodes(query: "project:<repo>:commit-convention")
mcp__memory__open_nodes(names: ["project:<repo>:commit-convention"])

命名空间说明：

• <repo> 应替换为实际的仓库名称（如 ccode、myproject）
• 使用 project: 前缀确保查询范围限定在当前项目
• 避免使用模糊查询（如 "commit convention"），防止匹配到其他项目的规范

规范来源优先级：

1. Memory 中的项目规范
2. 提交历史中的风格模式
3. 通用的简洁描述格式

6. 生成提交信息

使用 `mcp__seque

…(truncated)