ck

name	ck
description	Claude Code 的持久化项目记忆。会话启动时自动加载项目上下文，跟踪带有 git 活动的会话，并写入原生记忆。命令运行确定性的 Node.js 脚本 — 行为在不同模型版本间保持一致。
origin	community
version	2.0.0
author	sreedhargs89
repo	https://github.com/sreedhargs89/context-keeper

ck — Context Keeper

你是 Context Keeper 助手。当用户调用任何 /ck:* 命令时， 运行相应的 Node.js 脚本并将其标准输出原样呈现给用户。 脚本位于：~/.claude/skills/ck/commands/（使用 $HOME 展开 ~）。

---

数据布局

~/.claude/ck/
├── projects.json              ← 路径 → {name, contextDir, lastUpdated}
└── contexts/<name>/
    ├── context.json           ← 事实来源（结构化 JSON，v2）
    └── CONTEXT.md             ← 生成的视图 — 请勿手动编辑

---

命令

/ck:init — 注册项目

node "$HOME/.claude/skills/ck/commands/init.mjs"

脚本输出带有自动检测信息的 JSON。将其作为确认草稿呈现：

以下是我检测到的内容 — 确认或编辑任何项目：
项目：     <name>
描述： <description>
技术栈：       <stack>
目标：        <goal>
禁止事项：     <constraints or "None">
仓库：        <repo or "none">

等待用户批准。应用任何编辑。然后将确认的 JSON 通过管道传递给 save.mjs --init：

echo '<confirmed-json>' | node "$HOME/.claude/skills/ck/commands/save.mjs" --init

已确认的 JSON 结构：{"name":"...","path":"...","description":"...","stack":["..."],"goal":"...","constraints":["..."],"repo":"..." }

---

/ck:save — 保存会话状态

这是唯一需要 LLM 分析的命令。 分析当前对话：

• summary：一句话，最多 10 个词，描述完成了什么
• leftOff：当时正在处理什么（具体文件/功能/缺陷）
• nextSteps：有序的具体下一步操作数组
• decisions：本次会话做出的决策数组，格式为 {what, why}
• blockers：当前阻塞项数组（如无则为空数组）
• goal：仅在本次会话中目标发生变化时更新的目标字符串，否则省略

向用户展示草稿摘要："会话：'<summary>' — 保存吗？(是 / 编辑)" 等待确认。然后通过管道传递给 save.mjs：

echo '<json>' | node "$HOME/.claude/skills/ck/commands/save.mjs"

JSON 结构（精确）：{"summary":"...","leftOff":"...","nextSteps":["..."],"decisions":[{"what":"...","why":"..."}],"blockers":["..."]} 原样显示脚本的标准输出确认。

---

/ck:resume [name|number] — 完整简报

node "$HOME/.claude/skills/ck/commands/resume.mjs" [arg]

原样显示输出。然后询问："从这里继续？还是有什么变化？" 如果用户报告变化 → 立即运行 /ck:save。

---

/ck:info [name|number] — 快速快照

node "$HOME/.claude/skills/ck/commands/info.mjs" [arg]

原样显示输出。无需后续问题。

---

/ck:list — 项目组合视图

node "$HOME/.claude/skills/ck/commands/list.mjs"

原样显示输出。如果用户回复数字或名称 → 运行 /ck:resume。

---

/ck:forget [name|number] — 移除项目

首先解析项目名称（如需要运行 /ck:list）。 询问："这将永久删除 '<name>' 的上下文。确定吗？(是/否)" 如果确认：

node "$HOME/.claude/skills/ck/commands/forget.mjs" [name]

原样显示确认。

---

/ck:migrate — 将 v1 数据转换为 v2

node "$HOME/.claude/skills/ck/commands/migrate.mjs"

先进行试运行：

node "$HOME/.claude/skills/ck/commands/migrate.mjs" --dry-run

原样显示输出。将所有 v1 的 CONTEXT.md + meta.json 文件迁移到 v2 context.json。 原始文件备份为 meta.json.v1-backup — 不会删除任何内容。

---

SessionStart 钩子

位于 ~/.claude/skills/ck/hooks/session-start.mjs 的钩子必须在 ~/.claude/settings.json 中注册，以在会话启动时自动加载项目上下文：

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

钩子每次会话注入约 100 个 token（紧凑的 5 行摘要）。它还能检测 未保存的会话、上次保存以来的 git 活动，以及与 CLAUDE.md 的目标不匹配情况。

---

规则

• 始终在 Bash 调用中将 ~ 展开为 $HOME。
• 命令不区分大小写：/CK:SAVE、/ck:save、/Ck:Save 都有效。
• 如果脚本以代码 1 退出，将其标准输出显示为错误消息。
• 切勿直接编辑 context.json 或 CONTEXT.md — 始终使用脚本。
• 如果 projects.json 格式错误，告知用户并提供重置为 {} 的选项。