Cc Plan Review

Claude代码计划审查插件

英语 | 中文

一个克劳德代码插件，为计划模式提供人工审查功能。插件拦截 ExitPlanMode 通过钩子调用并打开一个基于浏览器的审查界面，用户可以在其中对Claude生成的计划进行注释并提供反馈。

特性

• 退出计划模式拦截：自动拦截计划提交以供人工审核
• 行内注释：将评论附加到特定的文本选择中（如GitLab MR评论）
• 批量审核：在提交之前创建多个草稿评论
• 版本历史记录：通过差异比较跟踪计划修订
• 实时更新：浏览器中基于SSE的实时更新

安装

通过克劳德代码CLI

# Add GitHub marketplace
claude plugin marketplace add zhcsyncer/cc-plan-review

# Install the plugin
claude plugin install cc-plan-review@cc-collab-plugins

通过克劳德代码互动

/plugin marketplace add zhcsyncer/cc-plan-review
/plugin install cc-plan-review@cc-collab-plugins

或者简单地使用 /plugin 并按照交互式提示进行操作。

更新插件

第一步：更新市场

claude plugin marketplace update

步骤2：通过Claude Code更新插件

1. 进入 /plugin 命令
2. 选择 2. Manage and uninstall plugins
3. 按Enter键 cc-plan-review 插件
4. 再次按Enter键
5. 选择 Update now

来源（发展）

git clone https://github.com/zhcsyncer/cc-plan-review.git
cd cc-plan-review
pnpm install && pnpm build
claude plugin add ./cc-plan-review

运作原理

该插件由两个协同工作的组件组成：

1.挂钩（工具使用前）

截距 ExitPlanMode 调用并触发审核工作流：

ExitPlanMode called → Hook intercepts → Opens browser → User reviews → Returns approve/block

2.MCP服务器

为审核工作流提供工具和资源：

工具：

• ask_questions：代理询问澄清问题或确认用户意见

资源：

• review://project/{projectPath}/pending：获取特定项目的所有待审核评论
• review://project/{projectPath}/current：获取最新的待审核内容
• review://{id}：按ID获取具体的审核详细信息

审核状态流

stateDiagram-v2
    [*] --> open: Create Review
    open --> approved: Approve directly (no comments)
    open --> changes_requested: User submits comments

    changes_requested --> discussing: Agent asks questions
    changes_requested --> updated: Agent submits revision

    discussing --> updated: User answers, Agent updates
    discussing --> approved: Issues resolved, User approves

    updated --> changes_requested: User adds more comments
    updated --> approved: User approves revision

    approved --> [*]

已知限制

审批后模式切换

当用户在审核界面中批准计划时，插件会向Claude Code返回“批准”决定。然而，存在一个已知的局限性：

问题：钩子返回后 approve，Claude Code不会自动从计划模式切换到接受编辑模式。

变通方案：批准计划后，用户有两个选项：

1. 等待提示：等待Claude Code在终端中显示“接受编辑”提示，然后确认
2. 手动开关：新闻 Shift+Tab 手动切换到接受编辑模式

这是克劳德代码挂钩系统的一个限制，该系统只能批准/阻止工具调用，但不能自动触发模式切换。

吊钩超时（10分钟）

克劳德代码挂钩系统有一个 10分钟超时 对于PreToolUse挂钩。如果审核过程超过10分钟：

行为:

• 钩子将超时，Claude Code将其视为 拒绝 （块）
• Claude将收到一个错误，指示挂钩超时
• 查看会话在浏览器中保持打开状态，但已断开连接

推荐:

• 在10分钟内完成您的评论
• 对于复杂的计划，考虑先留下快速评论，然后使用讨论功能获得详细反馈

数据持久层

审核数据存储在以下目录中：

~/.cc-plan-review/reviews/

每个复习会话都保存为JSON文件，文件名为复习ID。

技术栈

• 前端：Vue 3、Rsbuild、TailwindCSS
• 后端：Node.js、Express 5、MCP SDK

发展

pnpm install        # Install dependencies
pnpm dev            # Watch mode
pnpm build          # Full build (server + scripts + client)
pnpm start          # Start server