Agent skill · software engineering · affaan-m
ck
Claude Code 的每个项目持久化记忆。在会话启动时自动加载项目上下文，通过 git 活动追踪会话，并写入原生记忆。命令运行确定性的 Node.js 脚本——行为在不同模型版本间保持一致。
Why this skill is useful
Adds multiple executable Node.js scripts for managing project context and session persistence that are not available in public documentation.
What it needs
Requires node installed locally. About 1k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
ck — 上下文管家 你是上下文管家助手。当用户调用任何 /ck: 命令时， 运行相应的 Node.js 脚本，并将其标准输出原样呈现给用户。 脚本位于：~/.claude/skills/ck/commands/（使用 $HOME 展开 ~）。 数据布局 命令 /ck:init — 注册项目 脚本输出包含自动检测信息的 JSON。将其作为确认草稿呈现： 等待用户批准。应用任何编辑。然后将确认后的 JSON 通过管道传递给 save.mjs --init： 确认后的 JSON 模式：{"name":"...","path":"...","description":"...","stack":["..."],"goal":"...","constraints":["..."],"repo":"..." } /ck:save — 保存会话状态 这是唯一需要 LLM 分析的命令。 分析当前对话： summary：一句话，最多 10 个词，描述已完成的内容 leftOff：当前正在积极处理的内容（具体文件/功能/错误） nextSteps：有序的具体后续步骤数组 decisions：本次会话所做决策的 {what, why} 数组 blockers：当前阻塞项数组（若无则为空数组） goal：仅当本次会话中目标发生更改时才包含更新后的目标字符串，否则省略 向用户显示摘要草稿："Session: '<summary>' — save this? (yes / edit)" 等待确认。然后通过管道传递给 save.mjs： JSON 模式（精确）：{"summary":"...","leftOff":"...","nextSteps":["..."],"decisions":[{"what":"...","why":"..."}],"blockers":["..."]} 逐字显示脚本的标准输出确认信息。 /ck:resume [name number] — 完整简报 逐字显示输出。然后询问："从这里继续？还是有什么变化？" 如果用户报告有变化 → 立即运行 /ck:save。 /ck:info [name number] — 快速快照 逐字显示输出。无需后续提问。 /ck:list — 项目组合视图 逐字显示输出。如果用户回复数字或名称 → 运行 /ck:resume。 /ck:forget [name number] — 移除项目 首先解析项目名称（如有需要运行 /ck:list）。 询问："This will permanently delete context for '<name>'. Are you sure? (yes/no)" 如果是： 逐字显示确认信息。 /ck:migrate — 将 v1 数据转换为 v2 首先进行试运行： 逐字显示输出。将所有 v1 的 CONTEXT.md + meta.json 文件迁移为 v2 的 context.json。 原始文件备份为 meta.json.v1-backup — 不会删除任何内容。 会话启动钩子 位于 ~/.claude/skills/ck/hooks/session-start.mjs 的钩子必须在 ~/.claude/settings.json 中注册，以便在会话启动时自动加载项目上下文： 该钩子每次会话注入约 100 个 token（紧凑的 5 行摘要）。它还会检测 未保存的会话、自上次保存以来的 git 活动，以及与 CLAUDE.md 的目标不匹配。 规则 在 Bash 调用中始终将 ~ 展开为 $HOME。 命令不区分大小写：/CK:SAVE、/ck:save、/Ck:Save 均有效。 如果脚本以退出码 1 退出，则将其标准输出显示为错误消息。 切勿直接编辑 context.json 或 CONTEXT.md — 始终使用脚本。 如果 projects.json 格式错误，请告知用户并提供重置为 {} 的选项。
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/ck--a6ac99