Community写作与编辑github.com

steipete/codex-debugging

Codex 调试:用于调查 codex-rs 核心/TUI/执行/CLI/应用服务器/配置的问题。

codex-debugging 是什么?

这个技能专为开发者和 AI 代理设计,用于系统性地调试 Codex CLI 或应用的行为问题。它明确了排查流程:首选本地源码(如 `~/Projects/codex` 下的 `AGENTS.md` 和模块文件),再通过 `rg` 搜索相关区域(如核心、TUI、执行、配置等)。技能指导用户先确定问题属于哪个子系统(CLI、TUI、应用服务器、协议、配置或执行/工具),然后阅读对应模块及其测试文件,最后才检查本地配置 `~/.codex/config.toml`。它强调使用最小复现例或针对性测试,避免过度推测,并注意区分官方文档查询和浏览器自动化工具的适用范围。

兼容平台~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;捆绑的浏览器插件仅适用于 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.

相关技能