mcpField
C
codex-debugging

codex-debugging

github.com/steipete开发7.4k104 次安装1 周前更新
代码仓库

关于 codex-debugging

codex-debugging 是用于排查 Codex CLI 和应用行为、配置、工具、提示词、MCP 接线及运行时错误的技能。它引导从相关本地源码和测试入手，并优先使用聚焦复现而非猜测。

主要功能

  1. 01按 Codex 组件归类问题
  2. 02检查相关源码模块和测试
  3. 03结合源码行为核对本地配置
  4. 04使用针对性复现或测试
  5. 05源码不足时查阅官方文档

适用场景

  1. 01调查 Codex CLI 或应用行为
  2. 02追踪配置解析或工具问题
  3. 03排查提示词及 MCP 或应用接线
  4. 04提出改动前复现运行时错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/steipete/agent-scripts --skill codex-debugging

安装后在 Claude Code 中输入/codex-debugging确认已加载。

详细介绍

Codex 调试

适用于调查 Codex CLI/应用的行为、配置解析、工具行为、提示词、MCP/应用接线或运行时错误。

源码优先

优先查看本地源码，再查网页/文档：

cd ~/Projects/codex
sed -n '1,220p' codex-rs/AGENTS.md

然后搜索相关区域：

rg "<symbol|setting|error|feature>" codex-rs/{core,tui,exec,cli,app-server,app-server-protocol,config}

工作流

  1. 确定相关行为属于 CLI、TUI、应用服务器、协议、配置还是执行/工具。
  2. 提出更改建议前，先阅读所属模块及其相邻测试。
  3. 理解源码约定后，再检查 ~/.codex/config.toml 中的本地配置。
  4. 优先采用小型复现或有针对性的测试，避免宽泛猜测。

备注

  • 对于 OpenAI API/产品文档，仅当源码信息不足时才使用官方文档路径。
  • 对于 CLI 中的本地浏览器自动化，请使用 $browser-use；捆绑的 Browser 插件仅适用于 Codex 应用。

评论

支持 Markdown