用途
Context Continuity - Claude Code 版是一套针对 Claude Code 优化的开发上下文转移技能。当开发工作需要在不同 Claude Code 会话之间转移时,它通过生成结构化工件,高保真地保留代码状态、Git 上下文与运行中的服务。
适用场景包括:在新的 Claude Code 会话中继续开发工作;将工作交接给其他开发者并保留 AI 上下文;上下文窗口被占满(180K+ token)后恢复;在不同的 Claude Code 实例之间切换;重大重构前记录当前状态;准备同行评审(Codex/Gemini 集成)。
不适用于:一般对话摘要(应使用基础 context-continuity 技能);非开发场景(写作、研究、分析);没有代码改动的简单任务交接。
主要能力
该技能使用单一面向开发工作流优化的模式(约 400-600 字),生成包含以下分区的上下文工件:
- 任务说明(MISSION)、状态(STATUS)、进度(PROGRESS)
- 代码上下文(CODE CONTEXT):正在处理的文件、修改的函数/类、代码状态(修改/新建/删除)
- Git 状态(GIT STATE):分支、基线、提交数、近期提交、已暂存/未暂存/未跟踪文件、合并状态
- 环境状态(ENVIRONMENT STATE):运行中的服务与端口、依赖、环境变量、终端状态
- 技术决策(TECHNICAL DECISIONS):决策及理由、被否决的替代方案、权衡、架构说明、同行评审集成
- 待办事项(OPEN LOOPS):下一步动作、阻塞项、待处理项、待解决的问题
- 测试与验证(TESTING & VALIDATION):测试状态、已完成的手动测试、仍需测试的内容
- 上下文备注(CONTEXT NOTES):关键洞察、开发者备注、链接与参考
使用方式
步骤 1:收集上下文
文件上下文可使用命令:
git status --short
git log --oneline -5
git branch -vv
git diff --stat
git diff --cached --stat
环境上下文可使用命令:
lsof -i -P -n | grep LISTEN
env | grep -E '(PATH|NODE_ENV|DATABASE|API|APP_)'
git log --oneline -10 package.json
同时记录活跃编辑的文件、被修改的关键函数/类,以及新建文件与已改文件的区别。
步骤 2:生成工件,系统化填写各分区。
步骤 3:呈现并完善,完整呈现工件,附加“§ TRANSFER READY—Review for accuracy before sharing.”,并询问“Before you transfer, are there any sections that need further detail or refinement?”
步骤 4:转移到新会话,可附加接收方提示词,要求接收方在阅读后给出握手确认,回述任务、代码状态、Git 状态、下一步动作与环境。
校验可使用 Python 校验器:
python context-continuity-code/scripts/validate_dev_transfer.py artifact.md
校验内容包括必需分区是否齐全、Git 状态是否完整、文件路径格式是否正确、是否泄漏密钥、同行评审集成(如适用)。
同行评审集成
在进行同行评审前,生成轻量上下文工件(仅代码、Git、技术决策分区),作为评审请求输入;评审后,将评审结果更新到“技术决策”分区,记录 Codex/Gemini 的建议、一致点、分歧点以及采纳的建议及原因,并纳入转移工件。
最佳实践
应该做:生成前运行 git status 与 git diff --stat;包含带行号的具体文件路径(file.py:123);注明运行中的服务及其端口;在技术决策分区记录同行评审洞察;原样包含错误信息或测试失败;将文件标记为“in-progress”或“completed”。
不应做:包含密钥、API key、凭证(需脱敏);粘贴整个文件内容(改用带行范围的文件链接);假设接收方智能体可访问相同环境;跳过 Git 状态;忘记记录运行中的服务。
适用场景
完整的功能开发交接、调查中途的 bug 修复转移、重构会话继续、代码评审准备、同行评审后的实现、紧急上下文捕获(示例参考 references/examples.md)。
设计原则
开发优先(为代码交接优化,而非一般对话);Git 感知(Git 状态为必需项);工具状态必需(环境与服务是核心上下文);同行评审集成(对 Codex/Gemini 咨询提供一等支持);单一模式(一个为开发工作流优化的格式,无 Minimal/Full 选择);反脆弱(关键信息优先:任务 → 代码 → Git → 环境)。
与基础 Context Continuity 的区别
| 特性 | 基础技能 | Claude Code 版 |
|---|---|---|
| 目标 | 一般对话 | 仅开发工作 |
| 模式 | Minimal + Full | 单一优化模式 |
| 工具状态 | 可选 [T] 标签 | 必需的 §§ 分区 |
| Git 上下文 | 不包含 | 必需 |
| 代码上下文 | 不包含 | 核心特性 |
| 同行评审 | 未提及 | 集成工作流 |
| 长度 | 200-1000 字 | 400-600 字 |
| 环境 | 任意 Claude 实例 | 仅 Claude Code |
限制
- 仅适用于 Claude Code 环境。
- 仅适用于开发工作,不适用于一般对话或非开发场景。
- 使用前需审查工件的准确性,检查 Git 状态与文件路径。