mcpField
C
codex-debugging

codex-debugging

github.com/steipete開発7.4k104 回インストール1 週間前に更新
リポジトリ

codex-debugging について

codex-debuggingは、Codex CLIやアプリの動作、設定、ツール、プロンプト、MCP連携、実行時の不具合を調べるスキルです。関連するローカルソースとテストから分析し、推測よりも絞り込んだ再現を優先します。

主な機能

  1. 01Codexのコンポーネント別に問題を分類
  2. 02関連するソースモジュールとテストを調査
  3. 03ソースの仕様に照らしてローカル設定を確認
  4. 04絞り込んだ再現やテストを実施
  5. 05ソースで不十分な場合に公式ドキュメントを参照

活用シーン

  1. 01Codex 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／アプリの連携、ランタイムのバグを調査する際に使用します。

ソースを優先する

Web／ドキュメントより先に、ローカルのソースを確認します。

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 対応