mcpField
R
reviewing-memory

reviewing-memory

github.com/davidleeAgent 工作流2133 次安装4 天前更新
代码仓库

关于 reviewing-memory

reviewing-memory 是用于审计项目记忆质量和状态的 Agent 技能,适用于发布或其他重大变更前。它要求为每条审查过的记忆记录一个终结状态。

主要功能

  1. 01验证整个记忆库
  2. 02按影响和偏移风险排序
  3. 03检查来源、新鲜度与范围
  4. 04处理未验证的讨论线程
  5. 05为每条记忆记录终结状态

适用场景

  1. 01发布前审计记忆
  2. 02模式迁移前审查记忆
  3. 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 返回相互矛盾或置信度较低的结果时运行。

流程

  1. 提取影响最大的记忆。 在整个语料库范围内运行 doctrine memory validate(不带 REF),以找出失效的关系、过期的验证和即将过期的草稿。输出结果就是你的审计队列。

  2. 确定优先级。 按影响排序:

    • 有限定路径且自认证以来提交变动频繁的记忆(存在漂移风险)
    • 已认证(已验证)的记忆——对于不断变化的目标,过期的认证比未经认证更糟
    • 高严重性 × 高权重——此处出错影响很大
  3. 逐项执行检查清单。 对审计队列中的每项记忆,检查:

    • 来源可追溯性。 来源是否仍可追溯?引用的代码/文档是否已移动?
    • 时效性。 认证是否足够新?限定路径的变动是否已使其失去实用价值?
    • 元数据效率。 范围是否仍然准确?标签是否过时?生命周期是否合适?
    • 范围准确性。 路径/glob/命令范围是否仍涵盖正确的内容?
    • 可操作性。 后续 Agent 能否无需进一步研究就据此采取行动?
    • 重复情况。 这项记忆是否与其他记忆重叠?将其合并或标记为已取代。
  4. 清理线程。 扫描仍未验证的线程(memory list --type thread)。对每个线程:

    • 如果仍然相关,则验证它(doctrine memory verify <REF>)
    • 如果已过时,则将其归档(doctrine memory status <REF> archived)
    • 如果已被更新的知识取代,则将其标记为已取代(doctrine memory status <REF> superseded --by <SUCCESSOR>)
  5. 给出结论。 每项已审查内容都必须恰好进入一种最终状态:

    • verified — 已在当前代码树上重新认证,并更新元数据
    • corrected — 已编辑(doctrine memory edit),更新范围、信任度或内容
    • superseded — 通过 memory status superseded --by 指向其后继项
    • archived — 不再具有可操作性,但为保留历史而留存
    • promoted — 转换为持久化成果(ADR、规范或文档),并从记忆中归档

    每项记忆离开审查时,都必须记录上述一种结论。

评论

支持 Markdown