review

review skill 概览

review 能做什么

review 是一个用于审计 Claude Code auto-memory 的 self-improving-agent skill。review skill 可以帮助 agent 检查 MEMORY.md，找出适合提升为长期规则的候选内容，识别过时或重复的记忆条目，并给出维护建议，避免项目记忆不受控制地越积越多。当你想了解 agent 已经学到了什么、哪些内容应该沉淀为稳定的项目指导、哪些内容应该清理时，就适合使用 review skill。

这个 review skill 适合哪些场景

对于把 Claude Code memory 纳入 Context Engineering 工作流的团队来说，这个 skill 最有价值。它适合那些会自动记录重复经验、工具偏好、架构决策或常见错误，但又需要定期做编辑式复查的项目。如果你的项目不使用 Claude Code memory、没有 .claude 项目记忆目录，或者你只是想对某个源文件做一次性总结，那么它的价值就比较有限。

它和普通提示词有什么不同

普通的“总结一下我的 memory”提示词，通常会漏掉很多运维层面的检查。review skill 会给 agent 一条明确的审计路径：定位项目专属的 memory 目录，读取 MEMORY.md，根据 200 行启动限制检查行数压力，识别重复出现的经验，验证过时的文件引用，并把适合提升的候选内容与低价值条目分开。这样的结构让输出更适合用于维护长期运行的 agent 上下文，而不只是生成一段摘要。

如何使用 review skill

review 安装与首先要检查的文件

使用下面的命令从 GitHub repository 安装这个 skill：

npx skills add alirezarezvani/claude-skills --skill review

安装后，先阅读 SKILL.md。这个 repository path 将完整工作流放在单个文件中，没有额外需要检查的 rules/、resources/、references/ 或脚本。最重要的源文件章节是 Usage、What It Does、Step 1: Locate memory directory 和 Step 2: Read and analyze MEMORY.md。

review 的基础使用命令

上游 skill 的设计围绕 /si:review 风格的调用方式：

• /si:review 用于完整 memory 审计
• /si:review --quick 用于查看数量统计和最重要的候选项
• /si:review --stale 用于重点检查过时条目
• /si:review --candidates 用于只展示可能适合提升的内容

实际使用时，请在你想审计的项目根目录调用 review skill。这个 skill 需要访问 Claude Code 的项目 memory，通常位于基于当前工作目录推导出的 ~/.claude/projects/.../memory 路径下。

能提升 review 输出质量的输入

较弱的提示是：“Review memory.”

更好的提示是：

“Run the review skill for this repository. Check the project auto-memory, count MEMORY.md lines against the startup limit, identify recurring lessons that should be promoted into durable instructions, flag stale entries that reference deleted files or old tools, and group recommendations by promote, consolidate, prune, and keep.”

这个提示更有效，因为它明确了审计标准和决策分类。如果你了解近期的项目变化，也应该一并说明：例如重命名的目录、移除的工具、新的编码标准或策略调整。这些信息可以帮助 agent 判断某条 memory 是已经过时，还是仍然有价值。

推荐的 review 工作流

如果 memory 文件很大，或者你只需要先做一次分流排查，可以从 /si:review --quick 开始。在准备刷新上下文、为新的 agent 设置做 onboarding，或在重大功能周期开始前清理累积 memory 时，运行完整 review。大型重构、依赖变更或文件移动之后，使用 --stale。如果你的目标是 Context Engineering，也就是把反复出现的经验提升到 CLAUDE.md、项目文档或团队规则中，则使用 --candidates。

review skill 常见问题

review 只适用于 Claude Code memory 吗？

是的，这个 skill 是围绕 Claude Code auto-memory 约定设计的，尤其是 ~/.claude/projects/.../memory 下的项目 memory 和 MEMORY.md。你也可以把 review 指南改用到其他 memory 文件上，但当 agent 能遵循预期的 Claude Code memory 目录结构时，它的价值最大。

如果没有 memory 目录会怎样？

skill 应该报告 auto-memory 可能尚未启用或不可用，并建议检查 memory 设置，例如使用 /memory。这是安装前需要考虑的一个实际问题：如果你的团队还没有启用或积累 Claude Code memory，那么在 memory 存在之前，review 几乎没有可分析的内容。

什么时候不应该使用 review？

不要把 review 当作 code review、安全审查或文档 QA 的替代品。它审计的是 agent memory 的质量，不是源代码的正确性。对于没有重复模式的全新项目、刻意避免持久化 agent memory 的团队，或者你只需要对单个文档做简单摘要的场景，它也并不适合。

review 对 Context Engineering 有什么帮助？

在 Context Engineering 中，review 会把原始 memory 转化为一组可维护的待办事项。它帮助你判断哪些重复观察应该成为稳定上下文，哪些条目只是重复内容，哪些过时笔记应该在误导未来 agent 之前被删除。当你把它的输出当作对 agent 运行上下文的一次编辑式审校时，价值最大。

如何改进 review skill

给 review 提供证据，而不只是命令

当 agent 能检查实际 memory 文件和当前 repository 时，review skill 的效果会更好。请确保它可以通过文件系统检查来验证被引用的路径，而不是只依赖 memory 文本本身。如果你怀疑某些指导已经过时，请说明原因，例如：“we migrated from Jest to Vitest,” “the api/legacy folder was removed,” 或 “the deployment process changed last week.”

要求输出可直接决策的分类

请要求输出能映射到具体行动的分类。好的分类包括：

• Promote to durable project instruction
• Consolidate with similar entries
• Prune because stale or low-value
• Keep as temporary memory
• Investigate because evidence is unclear

这样可以避免 review 输出变成含糊的总结，也方便你在审计之后更新 CLAUDE.md、团队文档或 memory 文件。

常见失败模式与注意事项

最常见的失败是把一次性观察过度提升为长期规则。通常只有当某条 memory 反复出现、具有策略属性，或对未来会话有广泛帮助时，才应该提升。另一个失败模式是仅仅因为条目很旧就删除它；时间久并不等于过时。更可靠的过时信号包括文件已不存在、工具已被替换、约定被新规则否定，或者引用的是已经完成的临时工作。

第一次 review 后继续迭代

第一次 review 之后，可以要求 agent 把建议转成最小化的 patch plan：要新增什么、合并什么、删除什么，以及需要重新检查什么。然后再次用 quick mode 运行 review，确认 memory 变得更短、重复更少，并且更符合当前项目行为。这样，review 就不再是一次性报告，而会成为持续的维护循环。