关于 notes
用于在 Doctrine 阶段和切片中记录实施进展与长期笔记的技能。它区分临时运行上下文、持久项目知识和后续工作。
主要功能
- 01按阶段记录笔记的指导
- 02区分临时与持久笔记
- 03提示记录风险、决策和验证
- 04指导保存记忆与待办
适用场景
- 01记录当前阶段的进展
- 02在切片结束时保存注意事项
- 03跟踪待验证事项与提交状态
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ davidlee/ doctrine --skill notes安装后在 Claude Code 中输入/notes确认已加载。
详细介绍
Notes
在推进过程中记录实现笔记。
执行期间,笔记应记录在当前运行阶段说明表
(state/.../phases/phase-NN.md)中,作为可丢弃的工作上下文。在阶段或切片
收尾时,将持久内容提取到 notes.md
(doctrine slice notes <ID> 会按需创建该文件)。遵守存储规则:实时进度保存在状态树中,绝不写入编写中的文件。
如果不确定这项工作属于哪个切片,请通过 doctrine slice list 查找。
请简明扼要,但要记录:
- 已完成的事项
- 以下任何内容:
- 遇到的意外或需要采取的调整
- 可能存在的粗糙之处、遗漏或后续重构
- 建议采取的后续行动
- 与已完成或即将开展的工作有关的待解决问题
- 应成为记忆的持久事实、模式或注意事项
- 相关提交哈希,或注明:尚未提交的工作
- 是否已按仓库规范及时提交
.doctrine更改,或说明仍待处理及原因 - 如果已提交,在对下一位 Agent 有影响时,注明这些更改是与代码一同提交还是单独提交
- 自代码上次修改后,是否已成功运行验证门禁(
doctrine check gate),或注明:仍有未解决的错误
如果笔记中提及可复用的事实、模式或注意事项,且能为未来的 Agent 节省大量时间,那么在将任务、阶段或切片视为收尾之前,请运行 /record-memory。
如果笔记中提及的是一项后续工作,例如值得日后处理的问题、风险、杂务或想法,请通过 backlog new 记录下来,以免这项工作只留在当前上下文中。工作、知识还是决策?判定边界的规则见 using-doctrine.md。
评论
支持 Markdown