23059a1de3
Some checks failed
CodeQL / Analyze (javascript) (push) Failing after 16s
CodeQL / Analyze (python) (push) Failing after 3s
i18n sync check / check:sync (push) Failing after 3s
React Doctor / react-doctor (push) Failing after 16s
Branch Build CE / Build-Push Admin Docker Image (${{ matrix.arch }}) (push) Has been cancelled
Branch Build CE / Merge Admin Manifest (push) Has been cancelled
Branch Build CE / Build-Push Web Docker Image (${{ matrix.arch }}) (push) Has been cancelled
Branch Build CE / Merge Web Manifest (push) Has been cancelled
Branch Build CE / Build-Push Space Docker Image (${{ matrix.arch }}) (push) Has been cancelled
Branch Build CE / Merge Proxy Manifest (push) Has been cancelled
Branch Build CE / Merge Space Manifest (push) Has been cancelled
Branch Build CE / Prepare AIO Assets (push) Has been cancelled
Branch Build CE / Build Setup (push) Has been cancelled
Branch Build CE / Build-Push Live Collaboration Docker Image (${{ matrix.arch }}) (push) Has been cancelled
Branch Build CE / Merge Live Collaboration Manifest (push) Has been cancelled
Branch Build CE / Build-Push API Server Docker Image (${{ matrix.arch }}) (push) Has been cancelled
Branch Build CE / Merge API Server Manifest (push) Has been cancelled
Branch Build CE / Build-Push Proxy Docker Image (${{ matrix.arch }}) (push) Has been cancelled
Branch Build CE / Build-Push AIO Docker Image (${{ matrix.arch }}) (push) Has been cancelled
Branch Build CE / Merge AIO Manifest (push) Has been cancelled
Branch Build CE / Upload Build Assets (push) Has been cancelled
Branch Build CE / Build Release (push) Has been cancelled
51 lines
2.6 KiB
Markdown
51 lines
2.6 KiB
Markdown
---
|
||
name: react-doctor
|
||
description: Use when finishing a feature, fixing a bug, before committing React code, or when the user types `/doctor`, asks to scan, triage, or clean up React diagnostics. Covers lint, accessibility, bundle size, architecture. Includes a regression check and a full local-triage workflow that fetches the canonical playbook.
|
||
version: "1.1.0"
|
||
---
|
||
|
||
# React Doctor
|
||
|
||
Scans React codebases for security, performance, correctness, and architecture issues. Outputs a 0–100 health score.
|
||
|
||
## After making React code changes:
|
||
|
||
Run `npx react-doctor@latest --verbose --diff` and check the score did not regress.
|
||
|
||
If the score dropped, fix the regressions before committing.
|
||
|
||
## For general cleanup or code improvement:
|
||
|
||
Run `npx react-doctor@latest --verbose` (without `--diff`) to scan the full codebase. Fix issues by severity — errors first, then warnings.
|
||
|
||
## /doctor — full local triage workflow
|
||
|
||
When the user types `/doctor`, says "run react doctor", or asks for a full triage / cleanup pass (not just a regression check), fetch the canonical local-triage playbook and follow every step in it:
|
||
|
||
```bash
|
||
curl --fail --silent --show-error \
|
||
--header 'Cache-Control: no-cache' \
|
||
https://www.react.doctor/prompts/react-doctor-agent.md
|
||
```
|
||
|
||
The playbook is the single source of truth — a scan → filter → triage → fix → validate loop that edits the working tree directly (never commits, never opens PRs). Updating the prompt at its source updates every agent on its next fetch — no skill reinstall needed.
|
||
|
||
Pair it with the matching per-rule prompts at `https://www.react.doctor/prompts/rules/<plugin>/<rule>.md` (fetched on demand inside the playbook) so each fix uses the canonical, reviewer-tested recipe.
|
||
|
||
## Configuring or explaining rules
|
||
|
||
When the user wants to understand a rule, disagrees with one, or wants to disable / tune which rules run (not fix code), use the `doctor-explain` skill (alias `/doctor-config`). Start with `npx react-doctor@latest rules explain <rule>`, then apply the narrowest control via `npx react-doctor@latest rules disable|set|category|ignore-tag …`, which edits your `doctor.config.*` (or `package.json#reactDoctor`).
|
||
|
||
## Command
|
||
|
||
```bash
|
||
npx react-doctor@latest --verbose --diff
|
||
```
|
||
|
||
| Flag | Purpose |
|
||
| ----------- | --------------------------------------------- |
|
||
| `.` | Scan current directory |
|
||
| `--verbose` | Show affected files and line numbers per rule |
|
||
| `--diff` | Only scan changed files vs base branch |
|
||
| `--score` | Output only the numeric score |
|