# React Doctor 深度研究报告

更新时间：2026-07-07  
项目地址：https://github.com/millionco/react-doctor  
项目定位：React 代码审计与规则扫描器  

## 一句话结论

React Doctor 的价值在于把 React 质量问题从“模型感觉不对”变成“规则和扫描能稳定抓出来”。

## 项目定位

这个项目很聪明的一点，是没有继续卷“再来一个写代码 Agent”，而是把自己放在更稳定的位置：给人和 Agent 都能用的 React 审计器。README 明确说它是 deterministic scan，这比单纯让 LLM 猜哪里有问题更靠谱。

## 核心能力

### 本地审计与 CI 质量门

- 支持一条命令跑审计，也支持在 CI 中只报告当前 PR 新引入的问题。
- 覆盖 state、effects、performance、architecture、security、accessibility 六类常见 React 风险。
- 适合做“先扫描再修复”的前置质量门，而不是等线上出问题。

### 面向 Agent 的使用方式

- 支持 `install` 给 Claude Code、Cursor、Codex、OpenCode 等 agent 安装技能。
- 可配置 rules，让团队按自己项目风格打开或关闭规则。
- 把 React 专项经验沉淀成工具，对 agent 很有价值，因为 React 坑往往是框架特有的。

## 优势判断

它的强项是“确定性 + 框架垂直 + CI 友好”，特别适合把 React 经验系统化，降低 LLM 写 React 时的常见坏味道。

## 风险与边界

边界也很清楚：它只对 React 生态有价值，而且规则型工具天然会面临误报、漏报和团队定制成本问题；README 还说明有匿名 telemetry，这点对某些团队会是顾虑。

## 适合人群

适合重度 React / Next.js / React Native 团队，以及经常让 coding agent 写 React 代码的人。

## 对个人网站的启发

作为项目墙条目，它可以代表“AI 时代的前端质量门”方向，而不是单纯展示一个 UI 项目。

## 最终判断

React Doctor 最值得研究的地方，是它在 Agent 热潮里选了一个更稳的方向：不是替代开发者，而是把 React 的坏味道和质量风险变成可重复执行的检查体系。

## 信息来源

- React Doctor GitHub 仓库：https://github.com/millionco/react-doctor
- 官方文档：https://react.doctor/docs
- CI 文档：https://react.doctor/ci