关于 reviewing-memory
reviewing-memory 是用于审计项目记忆质量和状态的 Agent 技能,适用于发布或其他重大变更前。它要求为每条审查过的记忆记录一个终结状态。
主要功能
- 01验证整个记忆库
- 02按影响和偏移风险排序
- 03检查来源、新鲜度与范围
- 04处理未验证的讨论线程
- 05为每条记忆记录终结状态
适用场景
- 01发布前审计记忆
- 02模式迁移前审查记忆
- 03处理检索结果矛盾或置信度低的情况
MCP 相关
连接 doctrine MCP 服务时,该技能建议使用其 `memory_show` 工具,而非 `doctrine memory show`,以获取包含反向链接的机器可读 JSON。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ davidlee/ doctrine --skill reviewing-memory安装后在 Claude Code 中输入/reviewing-memory确认已加载。
详细介绍
审查记忆
MCP 快捷方式: 如果已连接 doctrine MCP 服务,请使用 MCP 工具
memory_show, 而不是doctrine memory show,以获取包含反向链接、可供机器解析的 JSON 结果。
稳定性门禁审计:系统地提取影响最大的记忆,检查其质量,并为每项记忆给出可审计的结论。在发布、架构迁移、改变子系统边界的 ADR 之前,或在 retrieve 返回相互矛盾或置信度较低的结果时运行。
流程
-
提取影响最大的记忆。 在整个语料库范围内运行
doctrine memory validate(不带 REF),以找出失效的关系、过期的验证和即将过期的草稿。输出结果就是你的审计队列。 -
确定优先级。 按影响排序:
- 有限定路径且自认证以来提交变动频繁的记忆(存在漂移风险)
- 已认证(已验证)的记忆——对于不断变化的目标,过期的认证比未经认证更糟
- 高严重性 × 高权重——此处出错影响很大
-
逐项执行检查清单。 对审计队列中的每项记忆,检查:
- 来源可追溯性。 来源是否仍可追溯?引用的代码/文档是否已移动?
- 时效性。 认证是否足够新?限定路径的变动是否已使其失去实用价值?
- 元数据效率。 范围是否仍然准确?标签是否过时?生命周期是否合适?
- 范围准确性。 路径/glob/命令范围是否仍涵盖正确的内容?
- 可操作性。 后续 Agent 能否无需进一步研究就据此采取行动?
- 重复情况。 这项记忆是否与其他记忆重叠?将其合并或标记为已取代。
-
清理线程。 扫描仍未验证的线程(
memory list --type thread)。对每个线程:- 如果仍然相关,则验证它(
doctrine memory verify <REF>) - 如果已过时,则将其归档(
doctrine memory status <REF> archived) - 如果已被更新的知识取代,则将其标记为已取代(
doctrine memory status <REF> superseded --by <SUCCESSOR>)
- 如果仍然相关,则验证它(
-
给出结论。 每项已审查内容都必须恰好进入一种最终状态:
verified— 已在当前代码树上重新认证,并更新元数据corrected— 已编辑(doctrine memory edit),更新范围、信任度或内容superseded— 通过memory status superseded --by指向其后继项archived— 不再具有可操作性,但为保留历史而留存promoted— 转换为持久化成果(ADR、规范或文档),并从记忆中归档
每项记忆离开审查时,都必须记录上述一种结论。
评论
支持 Markdown