CK Skill（Context Keeper）是 Everything Claude Code 的核心 Skill，专为 AI 编程助手打造跨会话、跨分支的每项目持久化记忆系统。它自动追踪 git 活动与会话进度，结构化保存项目目标、决策、下一步等关键信息，并在新会话自动加载，确保 AI 助手始终理解当前项目状态。通过 /ck:init、/ck:save、/ck:resume 等命令，开发者可高效管理多项目上下文，彻底解决 AI 编程助手遗忘历史、上下文割裂等痛点。

Everything Claude Code CK Skill：跨会话追踪 git 活动的每项目持久化记忆系统

在使用 Claude Code、Codex、Cursor 等 AI 编程助手时，最大痛点之一是上下文遗忘：AI 无法记住你在不同会话、分支、甚至不同天的开发进度、目标和决策。CK Skill（Context Keeper）正是为此而生，它为每个项目构建持久化记忆体系，自动追踪 git 活动，记录每次会话的核心进展、决策、阻塞与下一步计划，并在新会话自动注入最相关的上下文，让 AI 助手真正实现“记得住、接得上、能协作”。

CK Skill 适用于所有基于 Everything Claude Code 插件体系的 AI 编程助手，支持 Node.js 环境，行为在不同 LLM/模型版本间完全一致。它通过一套标准命令和自动化 Hook，帮助开发者无缝切换项目、恢复历史进度、避免重复劳动，是提升 AI 辅助编程效率的基础设施。关于 Everything Claude Code 的整体架构与组件体系，可参考完全指南。

一、CK Skill 解决了什么问题？

传统 AI 编程助手的痛点：

• 每次新会话都要重复介绍项目背景、目标、进度，效率极低
• 多项目/多分支切换时，AI 无法区分和记忆不同项目状态
• 决策、阻塞、下一步等信息易丢失，协作和追溯困难
• git 活动与 AI 会话割裂，无法自动关联

使用 CK Skill 后的变化：

• 每个项目自动建立独立的持久化上下文，跨会话自动加载
• 会话进度、决策、阻塞、下一步等结构化保存，随时回溯
• 自动检测 git 活动，提醒保存未同步的进展
• 支持多项目快速切换、归档与恢复，极大提升协作效率

二、CK Skill 的核心工作机制

1. 数据结构与存储布局

CK Skill 所有数据均保存在本地用户目录下，结构如下：

~/.claude/ck/
├── projects.json              # 所有项目的索引与元数据
└── contexts/<name>/
    ├── context.json           # 单一真源，结构化存储项目上下文
    └── CONTEXT.md             # 自动生成的可读视图（勿手动编辑）

所有操作均通过 Node.js 脚本实现，绝不直接编辑 JSON 或 MD 文件，保证一致性与可追溯。

2. 自动化加载与会话追踪

在 ~/.claude/settings.json 注册 SessionStart Hook：

{
  "hooks": {
    "SessionStart": [
      { "hooks": [{ "type": "command", "command": "node \"$HOME/.claude/skills/ck/hooks/session-start.mjs\"" }] }
    ]
  }
}

每次新会话自动注入该项目的 5 行精简摘要（约 100 tokens），并检测：

• 是否有未保存的会话进展
• git 活动与上次保存点是否有差异
• 项目目标是否与 CLAUDE.md 不一致

如有异常，AI 会主动提醒保存或更新上下文。

三、CK Skill 的完整使用流程（Step by Step）

Step 1：项目初始化（/ck:init）

首次在新项目目录下运行：

/ck:init

AI 会自动检测并输出草稿信息：

Here's what I found — confirm or edit anything:
Project:     my-cool-app
Description: Next.js + TypeScript web app
Stack:       Next.js, TypeScript, TailwindCSS
Goal:        实现用户登录与仪表盘
Do-nots:     禁止使用 any 类型
Repo:        https://github.com/your-org/my-cool-app

你可以直接确认，也可以编辑任何字段。确认后，AI 会保存为结构化 JSON，成为该项目的记忆基线。

Step 2：保存会话进度（/ck:save）

每次完成一个开发阶段、做出重要决策、遇到阻塞或准备切换任务时，运行：

/ck:save

AI 会自动分析当前会话内容，生成结构化总结草稿：

{
  "summary": "完成登录页 UI 与表单校验",
  "leftOff": "实现登录 API 与错误处理",
  "nextSteps": [
    "完成登录 API",
    "集成后端认证",
    "编写登录单元测试"
  ],
  "decisions": [
    { "what": "采用 NextAuth.js", "why": "兼容多平台登录，社区活跃" }
  ],
  "blockers": []
}

AI 会询问你是否保存（可编辑），确认后写入本地 context.json，并输出保存成功提示。

Step 3：恢复/快速回顾项目状态（/ck:resume、/ck:info、/ck:list）

• /ck:resume [name|number]
  获取完整项目进度 briefing，并询问是否继续或有变更（如有变更可直接 /ck:save）：

  项目：my-cool-app
  上次进度：完成登录页 UI 与表单校验
  当前任务：实现登录 API 与错误处理
  下一步：完成登录 API → 集成后端认证 → 编写单元测试
  决策：采用 NextAuth.js（兼容多平台登录，社区活跃）
  阻塞：无
  Continue from here? Or has anything changed?

• /ck:info [name|number]
  快速输出项目摘要，无需后续交互。

• /ck:list
  查看所有已注册项目（带编号/名称），可直接通过编号或名称 resume 任何项目。

Step 4：归档/删除项目（/ck:forget）

如需彻底删除某项目的全部上下文：

/ck:forget my-cool-app

AI 会二次确认是否永久删除，确认后清理对应数据。

Step 5：数据迁移与版本升级（/ck:migrate）

如需要从 v1 升级到 v2 格式，支持 dry-run 预览：

/ck:migrate --dry-run

正式迁移：

/ck:migrate

所有原始数据均自动备份，无数据丢失风险。

四、输出示例

保存会话进度：

/ck:save

AI 输出：

Session: '完成登录页 UI 与表单校验' — save this? (yes / edit)

确认后：

Saved session for 'my-cool-app' at 2024-06-10 14:52.

恢复项目 briefing：

/ck:resume my-cool-app

输出：

Project: my-cool-app
Last summary: 完成登录页 UI 与表单校验
Left off: 实现登录 API 与错误处理
Next steps:
  1. 完成登录 API
  2. 集成后端认证
  3. 编写登录单元测试
Decisions:
  - what: 采用 NextAuth.js
    why: 兼容多平台登录，社区活跃
Blockers: none
Continue from here? Or has anything changed?

五、常见配套 Agent 与 Skill 协作

• 与 Blueprint Skill 配合：可将蓝图生成器输出的多会话计划，结构化注入 CK Skill，保证长期任务分解与追踪。
• 与 Verification Loop Skill 协同：在端到端验证循环中，CK Skill 记录每轮验证结果与决策，便于回溯与持续改进。
• 与 Plankton Code Quality Skill 搭配：代码质量自动修复与会话进度同步，CK Skill 记录每次 Lint/修复的决策与阻塞。
• 与 Hooks/Rules 体系联动：通过自动化 Hook和项目级规则实现会话开始、分支切换等自动上下文加载与一致性检查。

六、注意事项与最佳实践

• 所有操作务必通过命令，不要手动编辑 context.json/CONTEXT.md
• 命令大小写不敏感，如 /CK:SAVE、/ck:save 均可
• 多项目/多分支开发时，建议每次切换都 resume 并及时 save
• 如遇 projects.json 损坏，AI 会自动提示修复或重置
• 升级数据格式时先 dry-run，确保无误后再正式迁移

FAQ

Q: CK Skill 支持哪些 AI 编程助手？ A: 只要集成 Everything Claude Code 插件体系、支持 Node.js 的 AI 编程助手（如 Claude Code、Codex、Cursor）均可使用。

Q: 会话内容和 git 活动如何自动关联？ A: CK Skill 在会话开始时检测 git 变更与未保存进度，并主动提醒用户保存，确保上下文与代码进度同步。

Q: 项目上下文会被不同模型或 AI 版本遗忘吗？ A: 不会。CK Skill 的数据全部本地持久化，所有命令行为在不同模型/版本间完全一致，确保记忆不丢失。

---