架构计划审核服务

通过独立的Claude实例对实施计划进行架构审核,返回分页反馈供人工筛选(接受/跳过)。

  • by boinger
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 boinger/mcp-plan-review

使用说明

mcp计划评审

MCP服务器,将实现计划发送到单独的Claude实例进行独立的架构审查。通过分页会话一次返回一个反馈项,以便人工分诊(接受/跳过)。

工具

名称 描述
review_plan 将计划发送给独立的Claude审阅者。返回会话ID和第一个反馈项。
submit_decision 记录当前项目的接受/跳过。返回下一个项目,或在所有项目都确定后返回最终摘要。

review_plan

输入: { plan: string }

输出 (有反馈):

{ "review_id": "uuid", "total": 7, "current_index": 0, "item": { "category": "...", "title": "...", "description": "...", "suggestion": "..." } }

输出 (无反馈):

{ "review_id": "uuid", "total": 0, "done": true, "accepted": [], "skipped": [] }

submit_decision

输入: { review_id: string, decision: "accept" | "skip" }

输出 (下一项):

{ "review_id": "uuid", "current_index": 1, "total": 7, "item": { ... } }

输出 (全部决定):

{ "review_id": "uuid", "done": true, "accepted": ["title1", "title2"], "skipped": ["title3"] }

类别

completeness, risk, edge_case, architecture, dependency, testing, error_handling, clarity, other

分流是如何工作的

review_plan 将计划发送给独立审阅者,并仅返回第一个反馈项。Claude将其呈现给用户。用户说接受或跳过。克劳德打电话来 submit_decision 根据用户的选择,获取下一个项目。重复此操作,直到所有项目都被分类。

Claude一次只能看到一个项目——它不能批量应用、总结或挑选反馈。会话在30分钟不活动后过期。

设置

先决条件

  • Node.js 20+
  • 人类API密钥

构建

cd ~/Projects/mcp-plan-review
npm install
npm run build

环境变量

变量 必填 描述
ANTHROPIC_API_KEY 是 审核人使用的API Anthropic密钥
REVIEW_MODEL 是* 用于评论的模型(例如。 claude-sonnet-4-6)

*也可以通过配置文件进行设置。

配置文件(可选)

~/.config/mcp-plan-review/config.json:

{
  "model": "claude-sonnet-4-6",
  "systemPrompt": "Custom reviewer prompt...",
  "maxTokens": 4096
}

配置值会覆盖环境变量。所有字段都是可选的。

使用克劳德代码注册

claude mcp add mcp-plan-review --scope user \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  -e REVIEW_MODEL=claude-sonnet-4-6 \
  -- node ~/Projects/mcp-plan-review/build/index.js

技能设置

审核计划技能协调审核工作流程:定位计划、调用分页工具、为用户分类呈现每个项目、修改计划,以及可选地重新审核。

安装

ln -s ~/Projects/mcp-plan-review/skill ~/.claude/skills/review-plan

用法

起草计划后,调用以下技能:

/review-plan

当克劳德检测到计划审查上下文时,该技能也会自动触发。

它做什么

  1. 查找计划(文件路径、对话上下文或询问您)
  2. 呼叫 review_plan --获取第一个反馈项
  3. 展示项目,要求接受或跳过
  4. 呼叫 submit_decision 根据您的选择,获取下一个项目
  5. 重复,直到所有项目都分类
  6. 仅根据接受的反馈修改计划
  7. 可选择重新审核(最多3轮)

发展

npm run dev    # Watch mode
npm test       # Run tests
npm run build  # Build