用途:该技能用于在 Codex 作为主要实现方的前提下,把 Claude Code CLI 当作协作者,用于获取第二意见、评审补丁以及多轮讨论。若本身运行在 Claude Code 内,不应再桥接 Claude Code,应改用自身能力或其他协作者技能。
主要能力:提供轻量桥接脚本 scripts/claude_bridge.py,输出结构化 JSON,支持通过 SESSION_ID 进行多轮会话。可请求 Claude 提出或评审统一 diff(Unified Diff Patch),但不能让其直接修改文件。适合用于设计取舍、边界情况、缺失测试、UI/UX 与可读性反馈、补丁风险排查等场景。不适用于琐碎一次性任务、需要权威事实与引用来源的任务,也不应粘贴敏感数据(密钥、私钥、生产日志)。
使用方式:不要直接调用 claude,必须使用桥接脚本以保持输出与会话处理一致。使用前可先执行 python3 .codex/skills/collaborating-with-claude/scripts/claude_bridge.py --help 查看参数。运行桥接时用 --cd 设为仓库根目录,需访问其他目录时用 --add-dir。请求代码改动时,在提示中要求“OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.”。默认型号建议 sonnet,复杂任务再用 opus。模型可用别名如 --model sonnet / --model opus;省略时使用 Claude Code 配置的默认模型。确保 Claude Code 已登录后再运行无头命令。流式 JSON 需 --verbose,桥接脚本会自动启用。多轮会话需捕获 SESSION_ID 并在后续调用中复用;--SESSION_ID、--continue、--session-id 互斥。
示例命令:PROMPT="$(cat <<'EOF'\nReview src/auth.py around login() and propose fixes.\nOUTPUT: Unified Diff Patch ONLY.\nEOF\n)" 然后运行 python3 .codex/skills/collaborating-with-claude/scripts/claude_bridge.py --cd "." --model sonnet --PROMPT "$PROMPT" --output-format stream-json。后续用 --SESSION_ID "<SESSION_ID>" 继续。若提示含反引号,不要直接放在 --PROMPT "..." 中,应使用 heredoc,详见 references/shell-quoting.md。
限制:Claude 输出仅作建议,最终结果由你负责,必须本地验证(测试、lint、构建)后才能合并。Claude 可能会猜测事实,且不直接编辑文件。输出格式为 text 时不会包含新会话 ID,需用 stream-json/json 获取。协作期间建议维护简短的 Collaboration State Capsule。参考资料包括 assets/prompt-template.md 与 references/shell-quoting.md。
风险说明:禁止在提示中粘贴任何密钥或敏感信息;代码改动要求 diff 并自行应用。