_{🌐 中文 · English}

Showcase

左边是 Codex 单独做出来的——功能正确但视觉上没什么记忆点。右边是同一个 Claude Code 会话接回来做 UI polish 后的结果，右下角 session: reused ✓ 说明没有新开 Claude 会话。

30 秒装上

最省事的方式，是直接把这个仓库链接发给你的 Agent：

请安装搭子.skill：https://github.com/LearnPrompt/partner-skill

也可以用 npx：

npx skills add LearnPrompt/partner-skill -g

本地开发或手动安装：

git clone https://github.com/LearnPrompt/partner-skill.git
cd partner-skill
bash install.sh --target codex
bash install.sh --target claude

一句话用起来

搭子，用同一个 Claude Code 会话先规划；我让 Codex 实现后，
你再把 diff 交回同会话做 UI polish 和 /codex:review，
最后给我 Partner Session Receipt，看有没有新开 claude -p。

更短一点：

搭子，Claude 计划，Codex 实现，同会话 review，最后出 receipt。

成本压力模型

Partner 的省钱逻辑不是“少用 Claude”，而是别让 Claude 反复冷启动。最贵的浪费通常不是那一次 polish，而是 Codex 改完之后又开一个全新的 Claude review，让它重新读项目、重新理解目标、重新建立上下文。

当前 README 用的是 showcase workload model，不是 API billing telemetry。没有可靠数据支撑时，我们不声称能省多少 token。这张表由 scripts/showcase-cost-ledger.py 生成，源数据在 examples/showcase-cost-ledger.json。

三种模式可以这样看：

标准收尾小票：

[Partner session receipt]
phase: final fix
claude_session: 9836fe7e-4aca-47a6-83b5-69086b8db275
claude_session_reused: yes
new_claude_p_sessions: 0
codex_passes: 2
checks: bash scripts/check-skill-repo.sh .; jq schema check; git diff --check
anomalies: none
monitoring_level: full

没有可靠 telemetry 时，Partner 只报告能验证的事实：是否复用同一个 Claude 会话，是否新开 claude -p，检查是否通过，有没有异常。

它解决什么

你可能已经在 Codex 和 Claude Code 之间来回切了。真正麻烦的不是“它们能不能协作”，而是协作经常散掉：

• Claude Code 适合计划、UI 口味和 review，但让它包办所有机械改动很贵。
• Codex 适合长上下文实现、跑检查、修细节，但 UI polish 和最终审查需要另一个视角。
• 最浪费的是 Codex 实现完之后又新开 Claude，会话上下文全丢，Claude 重新读项目。
• 用户只听到“我用了 Claude”，但看不到到底有没有省钱。

Partner 把这件事变成固定协议：

Claude Code same session:
  plan -> polish -> /codex:review

Codex:
  implement -> verify -> monitor -> fix -> receipt

触发方式

搭子
搭子，帮我规划一下这个任务。
用 Claude Code goal 先规划，你 Codex 来实现。
同一个 Claude Code 对话里先出 plan，你实现后再让它 polish 和 /codex:review。
让 Claude skip 做完这个 UI 交互优化，你监控它。
Claude 里跑 Codex Review 验收当前 diff，发现问题你来修。
搭子，恢复上次任务，接着做。

它会交付什么

• 清晰分工：Claude Code 负责计划、polish、review；Codex 负责实现、监控、验证、修复。
• 省预算默认策略：小中型任务尽量复用同一个 Claude Code 会话。
• Bounded handoff：只把 Claude 需要的计划、diff stat、检查结果和风险交回去。
• 监控清单：PTY、claude agents --json、transcript、task files、git diff/test 五层证据，配 scripts/check-claude-cli.sh 能力探测和降级策略。
• Session Receipt：把是否复用会话、是否新开 claude -p、检查、异常和监控等级写清楚，可用 scripts/validate-receipt.py 机器校验。
• 配套工具：scripts/make-handoff.sh 自动生成 bounded handoff 并可持久化到 .partner/；references/failure-playbook.md 给每种异常固定恢复路径；references/scenarios.md 覆盖 review-only、debugging、非 UI、非 git、monorepo、跨天任务。
• Darwin-style 验证门：一次只改一个协作维度，过检查才保留。

文件结构

SKILL.md                         Runtime instructions for Codex/Claude-compatible agents
README.md                        中文入口
README.en.md                     English entrypoint
install.sh                       Local installer for Codex, Claude Code, Agents, or all targets
test-prompts.json                Trigger and behavior regression prompts
docs/showcase-cost-model.md      Showcase 成本压力模型与真实 token 记录字段
docs/receipt-schema.json         Partner Session Receipt 的 JSON schema (partner.receipt.v1)
examples/session-receipt.md      Minimal visible proof of same-session reuse
examples/showcase-cost-ledger.json
                                  三种模式的成本压力 ledger
references/monitoring.md         How Codex monitors Claude Code progress
references/handoff-template.md   Bounded context packet for Claude Code polish/review
references/failure-playbook.md   每种异常的固定恢复路径与 .partner/ 状态持久化
references/scenarios.md          Review-only、debugging、非 UI、非 git、monorepo、跨天任务的流程变体
references/darwin-ratchet.md     Validation-gated improvement rules
scripts/showcase-cost-ledger.py  Rebuilds the showcase cost-pressure ledger
scripts/check-readme-parity.py   检查中英文 README 章节和关键证据是否对齐
scripts/check-skill-repo.sh      Publish readiness smoke check
scripts/check-claude-cli.sh      探测 Claude Code CLI 监控能力，输出 MONITORING_LEVEL
scripts/make-handoff.sh          自动收集 repo 证据生成 bounded handoff，可存入 .partner/
scripts/make-receipt.py          生成并预校验 receipt，自动填 monitoring_level，可存入 .partner/
scripts/session-snapshot.sh      transcript 快照对比，让新开会话数成为可计算的事实
scripts/validate-receipt.py      校验 Partner Session Receipt 的字段与取值
scripts/run-test-prompts.py      行为回归 prompt 的静态检查与实验性 live 模式

安全边界

• /goal 只能在交互式 Claude Code 会话里用；不要用 claude -p "/goal ..."。
• skip / bypassPermissions 只在用户明确要求或隔离 worktree 里使用。
• skip 模式不等于允许 commit、push、deploy、publish、发外部消息或碰 secrets。
• 不默认新开 claude -p 做 final review；优先恢复同一个 Claude Code 会话。
• 不改 repo visibility、不打 tag、不发 registry、不公告，除非用户单独明确授权。
• 不用 git reset --hard 当默认回刀方案；优先用可审计 diff 或 revert。

验证

bash scripts/check-skill-repo.sh .
python3 scripts/check-readme-parity.py
jq -r '.[].id' test-prompts.json
SOURCE_DATE_EPOCH=1782921600 python3 scripts/showcase-cost-ledger.py

以上检查也会在每次 push 和 pull request 时由 GitHub Actions 自动运行（.github/workflows/checks.yml）。

License

MIT