用途：在代码评审前，扫描 TypeScript 和 React 代码，列出潜在的代码坏味道，供人工复核，而非直接判定代码质量。
主要能力：区分两类匹配结果：signal 表示精确语法信号，hotspot 表示需要结合上下文审查的热点。可按路径扫描，也可仅扫描 Git 变更，并支持 JSONL 输出、选择规则、排除路径。
使用方式：运行 scripts/scan.sh [path] 扫描指定路径；加 --changed 扫描 Git 变更，例如 skills/typescript-react-smell-detector/scripts/scan.sh --changed --format jsonl；可用 --rule react-unstable-key 选择规则，用 --exclude 'examples/**' 排除路径；再按 OUTPUT.md 生成综合审查结果。运行 bash skills/typescript-react-smell-detector/tests/run.sh 可执行测试。
适用场景：提交前或评审时的 TS/React 代码坏味道初筛，优先查看 signal 结果再查看 hotspot 结果。
限制：所有匹配仅为提示，需先阅读代码再判断或修改，不应依据匹配数量推断代码质量；通用仓库卫生问题应改用 codebase-slop-audit。完整参数、规则、输出、排除与限制见 REFERENCE.md。