dsh-resume-brief

> 给 DeepSeek Harness 的“交接班表”技能：续接项目前，先写一页 brief，再开工。

English TL;DR

为什么需要它

这不是拍脑袋做的。作者用自己的 DSH 会话计数做了一次本地聚合（不读聊天正文、不读工作区名、不读密钥），看到了一个很具体的浪费：

• 136 个会话，26 个活跃日（2026-08-19 → 2026-09-28）。
• 最重的几个会话是读 HANDOVER / 继续昨晚的项目，26–118 轮。
• 0/136 个会话有 active plan，只有 21/136 有 todos。
• 7 个会话上下文压力超过 50%，最高 72.6%。
• 平均每轮输出 12,233 tokens；缓存命中 99.5%。

关键结论：问题不是“上下文没缓存”——缓存已经用得很好；问题是长项目续接时反复找状态、重复解释、轮次太多。
所以这个技能不压缩上下文，也不换模型；它只做一件事：在续接前，把项目压成一页纸。

> 这是单用户观察，不是 benchmark；你的数字会不同。仓库里不包含作者的聊天记录、工作区名或密钥。

它做什么

当你准备跨天、跨会话、或连续做超过 10 轮时，模型先生成一页 交接班表：

project:
updated:
目标：
现状：
下一步（最多 3 件）：
未决：
证据：

然后问你一句：“这样理解对吗？确认后我按这个开工。”
你确认后，新会话只读当前工作区的 CHECKPOINT.md，不再回放旧聊天记录。

快速开始

方式 A：手动 patch（已测试，最稳）

git clone https://github.com/Tinzlu/dsh-resume-brief.git

在 profile 的 cordis.patch.yml 里加一条（把路径换成你的实际路径）：

- insert:
- id: resume-brief
name: '/absolute/path/to/dsh-resume-brief/lib/index.js'

然后 touch 这个 patch 文件触发热加载；如果技能目录没出现 resume-brief，重启 DSH。

> DSH 的 loader 对裸包名（bare name）有解析限制；本地插件用绝对路径最稳。

方式 B：作为 bundle 安装（可选）

dsh plugin --profile  add github:Tinzlu/dsh-resume-brief

这个包带 dsh.bundle，理想情况下会把自己挂进 profile。
如果你的 DSH 版本没有自动挂载，回退到方式 A。

没有依赖，不需要 npm install。

用法

收尾时：

checkpoint：用 resume-brief 出交接班表，存到当前工作区的 CHECKPOINT.md。

新会话第一条：

续接项目：读当前工作区的 CHECKPOINT.md，用 resume-brief 技能。
先确认，再开工；不要重读旧聊天记录。

触发词：续接项目、继续昨晚的项目、接着上次做、交接、checkpoint、收尾、存档、handover、resume project。

短任务不要用：1–2 轮就能完成的事，直接开新会话说就行。

文件放哪

• 入口：当前工作区根目录的 CHECKPOINT.md，每个工作区一份；路径本身就是项目标识。
• 历史：checkpoints/YYYY-MM-DD-HHMM-主题.md。
• 不要写到桌面根、共享目录或别的项目目录；跨工作区引用时用绝对路径。
• 文件头写 project: / updated:；正文保持五行，不要越写越长。

示例：examples/CHECKPOINT.md。

设计原则

1. 一页：超过一屏就压缩，证据只留路径。
2. 当前事实，不是计划书：不写 20 步大计划，下一步最多 3 件。
3. 先确认，再动手：未确认前不改代码。
4. 不重读长文：用标题、git diff、grep 定位，不整篇读 HANDOVER。
5. 不写密钥：secret / key / token 永不进 brief。
6. 短任务豁免：不给 1–2 轮的任务加仪式。

它不是什么

• 不是 MCP server，不联网，没有运行时依赖。
• 不会自动压缩上下文，也不换模型；它改变的是交接方式。
• 它是 Skill，不是硬门控；模型可以选择不用。要硬约束，得写插件钩子。

兼容性

• DeepSeek Harness 0.2.x（在 0.2.1-rc.2 / macOS 上测试）。
• Node.js >= 20。
• 需要 DSH 的 skills 服务（ctx.skills.register）。

开发

node --test

测试只校验 skill 的元数据和关键文案（CHECKPOINT.md、checkpoints/、五行格式），不需要 DSH 运行时。

License

MIT © 2026 Tinzlu