省略标志以使用用户的配置默认值。

上下文深度

最小：特定文件/函数 → 仅 git 状态 中等：功能/多文件 → 添加近期更改 完整：调查/不明确 → 添加会话摘要

收集上下文

始终执行：

pwd && git rev-parse --show-toplevel 2>/dev/null || echo "Not a git repo"
git branch --show-current 2>/dev/null && git status --short 2>/dev/null | head -20

中等/完整：

git diff --stat 2>/dev/null | tail -20
git log --oneline -5 --since="4 hours ago" 2>/dev/null

仅完整： 会话摘要（已完成的工作、决策、阻碍）

提示结构

使用 CTCO 格式（上下文 → 任务 → 约束 → 输出）：

<context>
工作目录：{cwd}
仓库：{repo_name}
分支：{branch}
{git_status}
{recent_changes if medium/full}
{session_summary if full}
</context>

<task>
{来自参数的任务}
</task>

<constraints>
- 严格实现所请求的内容
- 修改前先读取文件
- 运行测试/linter 进行验证
- 如果存在歧义，请说明解释
</constraints>

<output>
摘要（≤5 个要点）：
- **更改内容**：文件和变更
- **位置**：文件:行号 引用
- **验证**：运行的测试/linter
- **风险**：需要注意的边缘情况
- **后续步骤**：跟进事项或“无”
</output>

执行

设置：

mkdir -p ~/.claude/codex/${CLAUDE_SESSION_ID}
git rev-parse --show-toplevel 2>/dev/null && IN_GIT=true || IN_GIT=false

运行：

codex exec --json \
  -o ~/.claude/codex/${CLAUDE_SESSION_ID}/summary-{timestamp}.txt \
  {--skip-git-repo-check if not in git} \
  {--full-auto OR --sandbox <mode>} \
  {-m <model> if requested} \
  - <<'CODEX_PROMPT'
{prompt}
CODEX_PROMPT > ~/.claude/codex/${CLAUDE_SESSION_ID}/progress-{timestamp}.jsonl

标志：

• 不在 git 中：添加 --skip-git-repo-check
• 默认：--full-auto（workspace-write + 自动批准）
• 用户请求：--sandbox <mode> 或 -m <model>

后台任务与前台任务

后台任务（预计 >30 秒）：

• 多文件更改、调查、测试、功能工作
• 使用 run_in_background: true → 返回 task_id

前台任务（<30 秒）：

• 单行修复、简单查询

监控后台任务

令牌高效方法：

1. 使用 TaskOutput(task_id, block=true) 等待完成
2. 忽略 TaskOutput 的内容（stdout 已重定向到进度文件）
3. 直接读取摘要文件：cat ~/.claude/codex/${CLAUDE_SESSION_ID}/summary-*.txt

摘要文件仅包含 Codex 的最终消息（令牌高效）。

进度检查（如需在完成前查看）：

• TaskOutput(task_id, block=false) - 检查是否仍在运行
• tail -n 3 ~/.claude/codex/${CLAUDE_SESSION_ID}/progress-*.jsonl - 仅最后 3 个事件

请勿读取整个进度文件或使用 tail -f。

报告结果

读取摘要：

cat ~/.claude/codex/${CLAUDE_SESSION_ID}/summary-*.txt

报告格式（≤5 个要点）：

**状态：** {success/error/partial}
**更改：** {文件和变更}
**验证：** {测试/linter}
**风险：** {如果有的话}
**后续：** {跟进事项或“无”}

示例

# 简单修复
/codex fix the null pointer in utils/parser.ts line 42

# 功能工作
/codex add rate limiting to the /api/submit endpoint

# 调查（后台）
/codex investigate why the CI build fails on arm64

# 模型覆盖
/codex --model o3 design a caching strategy

# 只读模式
/codex --sandbox read-only review the auth implementation

每周安装量

67

仓库

0xbigboss/claude-code

GitHub 星标数

36

首次出现

2026年1月26日

安全审计

Gen Agent Trust HubWarnSocketWarnSnykPass

安装于

codex58

gemini-cli57

opencode56

claude-code55

github-copilot52

cursor50

Omit flags to use user's config defaults.

Context Depth

Minimal : Specific file/function → git state only Medium : Feature/multi-file → add recent changes Full : Investigation/unclear → add session summary

Gather Context

Always:

pwd && git rev-parse --show-toplevel 2>/dev/null || echo "Not a git repo"
git branch --show-current 2>/dev/null && git status --short 2>/dev/null | head -20

Medium/Full:

git diff --stat 2>/dev/null | tail -20
git log --oneline -5 --since="4 hours ago" 2>/dev/null

Full only: Session summary (work done, decisions, blockers)

Prompt Structure

Use CTCO format (Context → Task → Constraints → Output):

<context>
Working directory: {cwd}
Repository: {repo_name}
Branch: {branch}
{git_status}
{recent_changes if medium/full}
{session_summary if full}
</context>

<task>
{task from arguments}
</task>

<constraints>
- Implement EXACTLY what is requested
- Read files before changing
- Run tests/linters to validate
- State interpretation if ambiguous
</constraints>

<output>
Summary (≤5 bullets):
- **What changed**: Files and changes
- **Where**: file:line references
- **Validation**: Tests/linters run
- **Risks**: Edge cases to watch
- **Next steps**: Follow-up or "None"
</output>

Execute

Setup:

mkdir -p ~/.claude/codex/${CLAUDE_SESSION_ID}
git rev-parse --show-toplevel 2>/dev/null && IN_GIT=true || IN_GIT=false

Run:

codex exec --json \
  -o ~/.claude/codex/${CLAUDE_SESSION_ID}/summary-{timestamp}.txt \
  {--skip-git-repo-check if not in git} \
  {--full-auto OR --sandbox <mode>} \
  {-m <model> if requested} \
  - <<'CODEX_PROMPT'
{prompt}
CODEX_PROMPT > ~/.claude/codex/${CLAUDE_SESSION_ID}/progress-{timestamp}.jsonl

Flags:

• Not in git: add --skip-git-repo-check
• Default: --full-auto (workspace-write + auto-approval)
• User-requested: --sandbox <mode> or -m <model>

Background vs Foreground

Background tasks (>30 seconds expected):

• Multi-file changes, investigations, tests, feature work
• Use run_in_background: true → returns task_id

Foreground tasks (<30 seconds):

• Single-line fixes, simple queries

Monitoring Background Tasks

Token-efficient approach:

1. Use TaskOutput(task_id, block=true) to wait for completion
2. Ignore TaskOutput's content (stdout redirected to progress file)
3. Read summary file directly: cat ~/.claude/codex/${CLAUDE_SESSION_ID}/summary-*.txt

The summary file contains only Codex's final message (token-efficient).

Progress checks (if needed before completion):

• TaskOutput(task_id, block=false) - check if still running
• tail -n 3 ~/.claude/codex/${CLAUDE_SESSION_ID}/progress-*.jsonl - last 3 events only

Do NOT read entire progress files or use tail -f.

Report Result

Read summary:

cat ~/.claude/codex/${CLAUDE_SESSION_ID}/summary-*.txt

Report format (≤5 bullets):

**Status:** {success/error/partial}
**Changed:** {files and changes}
**Validation:** {tests/linters}
**Risks:** {if any}
**Next:** {follow-up or "None"}

Examples

# Simple fix
/codex fix the null pointer in utils/parser.ts line 42

# Feature work
/codex add rate limiting to the /api/submit endpoint

# Investigation (background)
/codex investigate why the CI build fails on arm64

# Model override
/codex --model o3 design a caching strategy

# Read-only
/codex --sandbox read-only review the auth implementation

Weekly Installs

67

Repository

0xbigboss/claude-code

GitHub Stars

36

First Seen

Jan 26, 2026

Security Audits

Gen Agent Trust HubWarnSocketWarnSnykPass

Installed on

codex58

gemini-cli57

opencode56

claude-code55

github-copilot52

cursor50

AI新闻播客制作技能：实时新闻转对话式播客脚本与音频生成

1,200 周安装