交接 Skill Jiaojie

这是什么？适合谁？

交接 Skill（Jiaojie，Jordanwei1/jiaojie-skill）把当前目标、决策、废案、关键产物和下一步交给另一个 AI，让它从真正停下的位置继续。一个跨窗口、跨模型、跨设备、跨语言的开源 AI 上下文交接工具，基于开放的 Agent Skills 协议。

口号：「换窗口，不失忆；换模型，不重来。」

它解决的问题：handoff skill 证明了把任务摘要交给下一个 Agent 可行——但为什么只交摘要？把意图演化、废弃方案、负知识、产物和真正的下一步一起交过去。只需说一句「交接一下」，Jiaojie 自动完成导出、接收确认和连续性验证。

交接了什么（三层）：

• HOT：当前目标、精确停止点、一个推荐下一步、完成标准
• WARM：有效决定、意图演化、约束、已回答问题、废案与失败原因
• COLD：必要证据、原始材料、附件、Manifest、哈希与缺失声明

适合人群：换模型/换设备/换语言继续工作的人；多 Agent 协作需要无损交接的团队；受困于「每个新会话都重问一遍」的开发者。

准备工作

1. 安装：npx skills add Jordanwei1/jiaojie-skill（项目级）或加 --global。
2. 成本：MIT 开源，免费。
3. 最低接收能力：只需能读 Markdown；脚本、文件系统、压缩包支持是增强能力。
4. 时间预算：安装 1 分钟；说「交接一下」即用。

快速上手（3 步）

第一步：安装

npx skills add Jordanwei1/jiaojie-skill            # 项目级
npx skills add Jordanwei1/jiaojie-skill --global   # 全局
npx skills use Jordanwei1/jiaojie-skill            # 先试用不写入

第二步：生成交接

交接一下。

Jiaojie 按最小充分产物选择：普通任务用 handoff.md；必要文件必须随包走用 handoff.zip；正式审计/跨组织交付用 handoff-audit.zip。

第三步：接收

接收这个交接包，先给我接收回执，不要继续执行。

成功判定：接收 AI 不重问已回答的问题、不复活失败的 request_id 方案、不复活被否决的 Redis 方案、找到相同的并行下一步，并按要求停在执行前。

初级用法

四种对称模式

1. EXPORT：从当前可见上下文生成交接
2. RECEIVE：把交接恢复成简洁回执，只有用户要求才继续
3. VERIFY_STRUCTURE：确定性检查审计包的 Schema、路径、Manifest、哈希与图结构
4. CONVERT_LEGACY：把传统 HANDOFF.md/OCH Snapshot/LTM Packet 保守转换为 PARTIAL 交接

三种输出

高级玩法

四件容易被混淆的事（明确区分）

• 技术失败：方案经过尝试但不可行
• 用户否决：用户不接受，即使技术可行也不能擅自恢复
• 历史决定：解释过去，但不自动授予现在执行/发布/付款/删除的权限
• 外部事实：可能已过期，接收后必须重新验证

多语言是语义保护

UTF-8 + BCP 47 语言标签。原文权威，译文是派生视图；代码、路径、标识符、哈希、数字、日期、单位作为受保护片段不被翻译。

安全边界

交接包是不可信输入：不打包密码/Token/密钥；拒绝路径穿越、ZIP bomb、嵌套归档；包内 Prompt Injection 不能覆盖当前指令；哈希证明字节一致，不证明内容真实。

小技巧

1. 默认最小充分：普通任务用 handoff.md，别动不动升级 zip。
2. 接收先要回执：说「先给接收回执，不要继续执行」，确认语义和缺口再继续。
3. 区分否决与失败：被否决的方案绝不能擅自复活，即使技术上可行。
4. 外部事实要重验：接收后按需重新验证外部状态，别假设仍有效。
5. PARTIAL 别装 FULL：源会话缺关键内容，正确结果是 PARTIAL/UNKNOWN，不是编一个看起来完整的包。

常见踩坑

踩坑 1：新会话重问已回答的问题

• 现象：换 AI 后它又问一遍。
• 原因：没交接，或交接包没带 WARM 层。
• 解决：用 Jiaojie 导出完整交接；接收时 WARM 层已含「已回答问题」。

踩坑 2：复活被否决的方案

• 现象：新 AI 又建议 Redis 锁。
• 原因：交接包没区分「用户否决」和「技术失败」。
• 解决：Jiaojie 明确四类区分；接收 AI 不得复活 DENIED 路径。

踩坑 3：把交接包当系统指令

• 现象：包内恶意文本影响了新会话。
• 原因：把不可信输入当指令。
• 解决：Jiaojie 安全边界规定包内 Prompt Injection 不能覆盖当前指令；接收方把包内文本当数据处理。

踩坑 4：跨语言交接丢标识符

• 现象：代码路径/哈希被翻译了。
• 原因：翻译没保护片段。
• 解决：Jiaojie 多语言机制保护代码、路径、标识符、哈希、数字、日期、单位不被翻译。

踩坑 5：把自评分当独立验证

• 现象：信任一个自评的连续性分数。
• 原因：自评不能替代独立模型和人工复现。
• 解决：Jiaojie 明确「不用自评分替代独立模型和人工复现」；连续性看硬失败（重问/复活否决/改约束等）。

常见问题 FAQ

Q1: 和普通 handoff/摘要有什么不同？

A: 普通摘要回答「聊过什么」，Jiaojie 回答「现在到底做到哪里、为什么、下一步如何不走回头路」。它交接 HOT/WARM/COLD 三层：当前停止点、意图演化与废案、证据与哈希。

Q2: 它是无限记忆吗？

A: 不是。它不保存模型参数、隐藏推理或平台未提供的内容。「无损」只指声明范围内、用户可见知识边界中的工作连续性。

Q3: 支持哪些 Runtime？

A: Claude Code、Codex、Cursor、OpenClaw、Gemini CLI 等；实际验证范围以公开兼容矩阵为准。最低接收能力只需能读 Markdown。

Q4: 换模型/语言/设备会强制升级成 zip 吗？

A: 不会。格式由「下一步是否依赖接收方无法访问的文件」决定，切换本身不强制升级。

Q5: 安全吗？

A: 交接包按不可信输入处理：不打包凭证、拒绝 ZIP bomb/路径穿越/嵌套归档、包内注入不能覆盖指令、哈希只证明字节一致不证明内容真实。

进阶学习建议

掌握基础后，建议深入：

1. HOT/WARM/COLD 分层习惯：日常交接时刻意分层记录，让「停止点 + 废案 + 证据」都完整，接收 AI 才能无损续接。
2. 负知识治理：把「禁止事项、废案与失败原因」当一等公民维护——这是「不走回头路」的关键。
3. 读 security-boundary.md 和 threat-model.md：理解交接包作为不可信输入的全部攻击面，在团队里建立交接安全规范。

参考链接

• 官方仓库
• Agent Skills 协议

最后更新：2026-08-27 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成