SuperAPI AI 工具集

codex-handoff

智能体与模型

查看项目

更新于 10-16 06:19

技能介绍

用途:把 Claude Code 的结果、状态更新、决策或工作交接,作为一条带来源标注的消息,发送到某个已存在的 Codex Desktop 任务中。仅在当前对话中用户明确要求发送时才使用,不能因为粘贴了 Codex 链接、提到 Codex 或过去偏好就推断授权。

主要能力:解析并规范化目标,接受原始任务 UUID 或 codex://threads/<uuid> 深链接;通过捆绑脚本调用 codex queue 完成投递。消息采用紧凑结构,包含来源、来源说明、状态、结果、证据、请求动作和是否继续工作等字段,空字段可省略。

使用方式:脚本路径为 scripts/send_to_codex.py,相对于 SKILL.md 解析。多行文本建议用单引号 heredoc 防止 shell 展开,例如:python3 "$SKILL_DIR/scripts/send_to_codex.py" --thread 'codex://threads/123e4567-e89b-12d3-a456-426614174000' <<'CODEX_HANDOFF_EOF'。短文本可用 --message,已有 UTF-8 文件可用 --file <path>。加 --dry-run 可只检查规范化而不发送,但 dry run 不算成功交接。

限制:排队消息被视为对目标 Codex 任务的真实修改。必须解析出唯一目标,否则应询问用户,不能从最近会话、剪贴板、终端历史或环境变量猜测。禁止发送凭据、令牌、.env 内容、私有客户数据等秘密,应改为摘要或指向安全的本地文件。不要使用 codex exec resume、原始 App Server thread/inject_items 或自建守护进程请求。失败时报告确切错误,不声称消息已送达;结果不确定时不要自动重试,以免产生重复提交。成功时告知用户哪个 Codex 任务收到消息,并附上队列确认信息。