Community寫作與編輯github.com

steipete/codex-debugging

Codex 除錯:用於調查 Codex CLI/應用行為、設定解析、工具行為、提示、MCP/應用接線或執行時期錯誤。

codex-debugging 是什麼?

此技能專為開發者與 AI 代理設計,用於高效除錯 Codex 專案(特別是 `codex-rs` 核心)。它提倡「原始碼優先」原則,引導使用者先閱讀本地專案文件(如 `codex-rs/AGENTS.md`),再透過 `rg` 指令精準搜尋 `core`、`tui`、`exec`、`cli`、`app-server` 等關鍵模組。技能提供標準化工作流程:先判斷問題類型(CLI、TUI、應用伺服器、協定、設定或執行/工具行為),接著閱讀對應模組與測試,最後才檢查本地設定檔。它強調以最小重現案例或焦點測試取代廣泛猜測,並提醒 OpenAI 官方文件僅在原始碼不足時才查閱。此技能支援所有可執行 `bash` 與 `rg`(ripgrep)的開發環境,尤其適用於本地開發中的 CLI 與應用伺服器除錯情境。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/codex-debugging

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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/產品文件,僅在原始碼不足時才使用 official-docs 路徑。
  • 若需在 CLI 中進行本地瀏覽器自動化,請使用 $browser-use;捆綁的 Browser 外掛僅限於 Codex 應用程式。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

相關技能