用途:从 UI 截图或视觉描述中定位前端源码组件,属于前端开发辅助技能。当粘贴截图并带有修复、更新、查找、调试等 UI 意图时,该技能在 /scout 之前运行,先缩小搜索范围,再把匹配到的文件路径与组件关系图交给后续调查步骤。适用于 bugfix、feature、refactor、fix-ui、验证等工作流。
主要能力与流程:
- 加载组件索引。全量重建:node .claude/skills/find-component/scripts/generate-component-index.cjs;增量更新(仅重扫 git 变更的组件文件):node .claude/skills/find-component/scripts/generate-component-index.cjs --git-changes。随后读取 docs/component-index.json。索引缺失、过期或大重构后用全量;编辑组件后快速更新用 --git-changes;索引不可用时回退到实时 grep。
- 从截图提取视觉信号,共 6 类:文本、BEM、Material、布局、颜色、数据形态,只记录实际所见,不做推断。
- 自底向上搜索:先匹配 platform-core/ 与 libs/ 的可复用组件,再匹配 shared/components/ 的领域组件,再找组合子组件的页面组件;无可复用匹配时直接搜索页面模板。
- 置信度评分:≥85%(至少 2 个 grep 验证信号)报告为确认匹配;<85% 展示候选及逐信号明细并询问用户。
- 构建组件关系图,输出 Mermaid 图,每条边需读取实际模板 HTML 验证,不能仅凭 import 推断。
- 报告匹配组件、文件路径(TS/HTML/SCSS)、置信度、Mermaid 图及未解决的歧义。
限制:必须遵守反幻觉要求,每个匹配声明都需 grep 验证证据;置信度低于 85% 时停止并展示候选,不得编造。资料未提供具体支持的前端框架、索引文件结构细节及安装方式。