expert-review

技术方案专家 Review 框架 — Claude Code Skill

从"一坨需求"到"可执行的编码 Plan"的完整方法论，以第一性原理为核心驱动。

安装

git clone <your-repo-url> ~/.claude/skills/expert-review && cd ~/.claude/skills/expert-review && ./setup

重启 Claude Code 后即可使用。

命令

命令	阶段	产出
/expert-review	总览	框架介绍 + 建议起始阶段
/p1-position	定位	问题定义 + 核心矛盾
/p2-deconstruct	解构	模块清单 + 依赖图 + 风险/复杂度
/p3-deepdive	深潜	方案对比表 + 业界实践 + 验证场景 + Open Questions
/p4-integrate	勾兑	耦合点 + 对齐矩阵 + 接口review + 解决 Open Questions
/p5-converge	收敛	完整编码 Plan + 风险登记表
/p6-verify	验证	实现 vs Plan 偏差报告

Review 产出目录结构

~/expert-reviews/
  <project>/
    <YYYY-MM-DD>-<topic>/
      README.md              ← 进度概览
      decisions.md           ← 决策日志（跨 Phase 累积）
      p1-position.md
      p2-deconstruct.md
      p3-deepdive/
        module-a-xxx.md      ← 含 Open Questions + Revision Log
        module-b-xxx.md
      p4-integrate.md
      p5-converge/
        coding-plan.md       ← 含风险登记表 + 代码约束
      p6-verify.md           ← 验证报告

配置

# 修改产出目录
vi ~/.expert-review/config
# 设置 REVIEW_HOME=/your/path

核心设计原则

1. 第一性原理驱动 — 所有 trade-off 先做高维度问题抽象，再推导方案
2. 最佳实践锚定 — 每个关键决策搜索业界参考（Google/Uber/Stripe），提供文档链接
3. 产出可追溯 — 决策日志 (decisions.md) 跨 Phase 累积，每个决策标注推导来源
4. 会话持久化 — 每次 review 的完整产出按项目/时间归档，支持跨会话继续
5. 迭代追踪 — P3/P4 反复时通过 Revision Log 追踪修改历史，不丢失推导过程
6. 闭环验证 — P6 对比实现 vs Plan，确保编码没有偏离设计意图