在 DeepSeek Harness 中，长项目往往死在聊天记录里。关键上下文会滚动消失、被压缩，或者属于已结束的会话。为了让下一个会话能够立即恢复工作，而不需要“考古”查找历史记录，需要建立一套交接纪律。Project Handoff 技能将这套纪律固化为可复用的流程。
这是一个记忆类技能，由 ChenneyZhuang 维护，开源协议为 MIT。它解决的核心问题是：如何将决策理由、潜规则和当前状态持久化地保存在项目内部，而不依赖临时的对话压缩。
核心功能¶
该技能在项目目录下生成一个持久化的 handoff.md 文件，内容包含三个核心部分：
- 当前状态：记录存在的实体、数量、路径和版本，仅包含可核验的声明。
- 决策与理由：记录“为什么选择 X 而不是 Y”，保留决策背后的逻辑，避免后续重开争议。
- 陷阱记录：严格采用“症状 → 原因 → 修复”的格式记录已知的坑，便于长期阅读和检索。
技能支持中英文双语，文件随项目版本控制，即使在没有对话产生时也存在。
安装与启用¶
通过 npm 命令安装：
npx skills add ChenneyZhuang/project-handoff
不同 agent 的具体安装路径请参考项目中的 COMPATIBILITY.md 文件。
典型用法¶
- 工作前核验：开始处理现有项目前，先阅读
handoff.md。对比文件中的声明与实际项目状态，修正过时的条目。 - 变更时立即更新：里程碑达成、做出关键决策或发现坑时，立即写入文件。不要等到一天结束时再整理，过时的交接文件就是谣言。
- 使用标准陷阱格式：记录问题时，必须按“症状 → 原因 → 修复”的顺序编写，确保文件在几周后仍具可读性。
- 保护敏感信息：不要在
handoff.md中直接写入凭证或个人隐私。将这些信息存储在专用存储中，并在交接文件中指向该位置。
适用场景与注意¶
- 适用场景：适用于跨会话工作、多人员协作的项目。单人短周期项目可能不需要这种严格的纪律。
- 局限说明：这是一个记忆层工具，不是版本控制（git）的替代品。代码历史归 git 管理，
handoff.md仅记录 git 无法存储的内容（如决策理由、未写明的规则）。 - 风险提示：过期的条目与缺失的条目一样会误导。由于文件记录的是写入时刻的事实，带有日期的条目需要读者在阅读时进行现实核验。对于日期早于最近大变更的条目应保持怀疑。
