交接难题
当你开启一个新的 Claude Code 会话时,所有上下文都没了。你得重新解释你在做什么、哪些文件重要、还剩什么没做。
/note-context 解决了这个问题 — 它创建一张蓝色置顶笔记,装下一个会话需要的一切。
输出部分
| 部分 | 内容 |
|---|---|
| 头部 | 项目 @ 分支 | N 处未提交改动 |
| 正在做 | 当前任务,具体而清晰 |
| 关键文件 | 3-5 个最重要的文件,配 5 个词的注释 |
| 状态 | 分支用途、未提交摘要、loop 进度 |
| 关键决策 | 仅本次会话做的决策 |
| 未解决的问题 | 没解决的项和未知点 |
| 从这里继续 | 给下一个会话的确切指令 |
关键文件格式
每个文件都配一段简短注释:
src/auth.ts — JWT 校验中间件(重构中)
src/api/users.ts — 新端点,需要测试
tests/auth.test.ts — 3 个测试在 refresh 上失败
最多 5 个文件。只列最相关的。
「从这里继续」部分
这是关键的部分。质量标准:
只读「从这里继续」,就该让一个新会话清楚知道下一步要做什么。
好的:
从这里继续:修复 src/auth.ts:45 的 refresh token 流程。
validateToken 函数需要检查 token 是否过期,
并在返回 401 之前调用 refreshToken()。
用这个跑测试:npm test -- auth
差的:
从这里继续:继续做 auth。
始终置顶
上下文笔记始终是:
- 蓝色
- 置顶在所有窗口之上
- 不到 3 小时就更新,否则新建一张笔记
同一时间只有一张活动的上下文笔记 — 永远是最新的快照。
非 git 模式
没有 git 仓库也能用。跳过 git 相关部分(分支、未提交改动),专注于笔记状态和你提供的上下文。
时间戳
每张上下文笔记都包含确切时间:
上下文 2026 年 2 月 19 日 23:15