在完成功能、修复错误、提交 React 代码之前,或当用户输入 `/doctor`、要求扫描、分类或清理 React 诊断时使用。涵盖 lint、可访问性、包体积、架构。包括回归检查以及获取规范手册的完整本地分类工作流。
React Doctor
扫描 React 代码库中的安全性、性能、正确性和架构问题。输出 0–100 的健康评分。
在修改 React 代码后:
运行 npx react-doctor@latest --verbose --scope changed 并检查评分没有下降。
如果评分下降,在提交前修复回归问题。
常规清理或代码改进:
运行 npx react-doctor@latest --verbose(默认 --scope full)扫描整个代码库。按严重性修复问题——先处理错误,再处理警告。
/doctor — 完整本地分类工作流
当用户输入 /doctor、说“运行 react doctor”或要求完整分类/清理(不仅仅是回归检查)时,获取规范的本地分类手册并遵循其中的每一步:
curl --fail --silent --show-error \
--header 'Cache-Control: no-cache' \
https://www.react.doctor/prompts/react-doctor-agent.md
该手册是唯一权威来源——一个扫描→过滤→分类→修复→验证的循环,直接编辑工作树(从不提交,从不打开 PR)。在源处更新提示,所有代理在下一次获取时都会更新——无需重新安装技能。
将其与 https://www.react.doctor/prompts/rules/<plugin>/<rule>.md 上匹配的每个规则提示配对(在手册中按需获取),以便每个修复都使用规范的、经过审查的配方。
配置或解释规则
当用户想了解某个规则、不同意某个规则,或想禁用/调整运行的规则(而不是修复代码)时,阅读 references/explain.md 并遵循它。从 npx react-doctor@latest rules explain <rule> 开始,然后通过 npx react-doctor@latest rules disable|set|category|ignore-tag … 应用最窄的控制,这会编辑你的 doctor.config.*(或 package.json#reactDoctor)。
命令
npx react-doctor@latest --verbose --scope changed
| 标志 | 用途 |
|---|---|
. |
扫描当前目录 |
--verbose |
显示每个规则影响的文件和行号 |
--scope changed |
仅报告相对于基础分支引入的问题(默认:全部) |
--scope lines |
仅报告更改行上的问题 |
--score |
仅输出数字评分 |






