mcpField
S
system-evolution-review

system-evolution-review

github.com/coleam00Agent 工作流722215 次安装3 周前更新
代码仓库

关于 system-evolution-review

用于对照实施计划和执行报告进行流程层面复盘的技能，面向希望改进规划与交付方式的团队。它关注流程偏差，而非查找代码缺陷。

主要功能

  1. 01对照计划与执行报告
  2. 02分类实施偏差
  3. 03追溯流程问题的根因
  4. 04建议更新技能和文档
  5. 05生成结构化复盘报告

适用场景

  1. 01分析实施为何偏离计划
  2. 02发现验证或上下文缺失
  3. 03将重复流程问题转化为技能更新

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/coleam00/skills --skill system-evolution-review

安装后在 Claude Code 中输入/system-evolution-review确认已加载。

详细介绍

系统评审

从元层面分析实现对计划的遵循情况，并找出流程改进方案。

目的

**系统评审不是代码评审。**你不是在找代码中的错误，而是在找流程中的问题。

你的任务：

  • 分析对计划的遵循情况及偏离模式
  • 判断哪些偏离有合理依据，哪些存在问题
  • 找出能够避免未来问题的流程改进方案
  • 提出对 AI-Layer 资源（CLAUDE.md、计划模板、技能）的更新建议

理念：

  • 合理的偏离揭示了计划的局限 → 改进规划
  • 不合理的偏离揭示了需求不明确 → 改善沟通
  • 重复出现的问题揭示了自动化缺失 → 创建技能

背景与输入

你将分析以下四项关键材料：

计划技能： 阅读此文件，了解规划流程以及指导计划制定的说明。 .claude/skills/piv-plan-implementation/SKILL.md

生成的计划： 阅读此文件，了解 Agent 原本应该完成的工作。 计划文件：$plan

执行技能： 阅读此文件，了解执行流程以及指导实现工作的说明。 .claude/skills/piv-implement/SKILL.md

执行报告： 阅读此文件，了解 Agent 实际完成的工作及其原因。 执行报告：$report

分析工作流

步骤 1：了解计划方法

阅读生成的计划（$plan）并提取：

  • 计划实现了哪些功能？
  • 指定了什么架构？
  • 定义了哪些验证步骤？
  • 引用了哪些模式？
步骤 2：了解实际实现

阅读执行报告（$report）并提取：

  • 实现了什么？
  • 哪些方面偏离了计划？
  • 遇到了哪些挑战？
  • 跳过了哪些内容，原因是什么？
步骤 3：对每项偏离进行分类

对执行报告中指出的每项偏离进行分类：

合理偏离 ✅（有正当理由）：

  • 计划假设了代码库中不存在的内容
  • 实现过程中发现了更好的模式
  • 需要进行性能优化
  • 发现了安全问题，必须采用不同方案

不合理偏离 ❌（存在问题）：

  • 忽略了计划中的明确约束
  • 未遵循现有模式，而是另建架构
  • 采取了引入技术债的捷径
  • 误解了需求
步骤 4：追溯根本原因

针对每项有问题的偏离，找出根本原因：

  • 计划是否不明确？具体在哪里，为什么？
  • 是否缺少上下文？具体在哪里，为什么？
  • 是否缺少验证？具体在哪里，为什么？
  • 是否重复了手动步骤？具体在哪里，为什么？
步骤 5：提出流程改进方案

根据各项偏离中体现的模式，提出以下建议：

  • **CLAUDE.md 更新：**应记录的通用模式或反模式
  • **计划技能更新：**需要进一步说明的指示或缺失步骤
  • **新技能：**应实现自动化的手动流程
  • **验证补充：**可更早发现问题的检查

输出格式

将分析结果保存到：.claude/system-reviews/[feature-name]-review.md

报告结构：
元信息
  • 评审计划：[$plan 的路径]
  • 执行报告：[$report 的路径]
  • 日期：[当前日期]
总体一致性评分：__/10

评分指南：

  • 10：完全遵循计划，所有偏离均有合理依据
  • 7-9：存在少量有合理依据的偏离
  • 4-6：合理偏离与有问题的偏离并存
  • 1-3：存在严重的问题偏离
偏离分析

针对执行报告中的每项偏离：

divergence: [what changed]
planned: [what plan specified]
actual: [what was implemented]
reason: [agent's stated reason from report]
classification: good ✅ | bad ❌
justified: yes/no
root_cause: [unclear plan | missing context | etc]
模式遵循情况

评估对已记录模式的遵循情况：

  • 遵循代码库架构
  • 使用已记录的模式（来自 CLAUDE.md）
  • 正确应用测试模式
  • 满足验证要求
系统改进措施

根据分析，推荐具体的改进措施：

更新 CLAUDE.md：

  • 记录实施过程中发现的 [模式 X]
  • 添加针对 [Y] 的反模式警告
  • 澄清 [技术约束 Z]

更新 Plan 技能（$plan）：

  • 添加关于 [缺失步骤] 的说明
  • 澄清 [含糊不清的说明]
  • 添加针对 [X] 的验证要求

创建新技能：

  • 为 [重复 3 次以上的手动流程] 创建新技能

更新 Execute 技能：

  • 将 [验证步骤] 添加到执行检查清单中
主要经验

进展顺利的方面：

  • [顺利完成的具体事项]

需要改进的方面：

  • [发现的具体流程缺陷]

供下次实施参考：

  • [可尝试的具体改进]

重要说明

  • 务必具体： 不要说“计划不清晰”，而要说“计划未说明应采用哪种身份验证模式”
  • 关注模式： 偶发问题不具备可操作性。请寻找反复出现的问题。
  • 以行动为导向： 每项发现都应附带具体的资产更新建议
  • 提出改进建议： 不要只做分析，还要实际建议应添加到 CLAUDE.md 或技能中的文本

评论

支持 Markdown