技能介绍

要解决什么问题

改需求、查 bug 或核对接口行为时，你往往只有一句现象描述和一个「大概从这里开始」的文件路径。全仓库盲搜会淹没在 node_modules 和薄封装里；反过来只做入口全景梳理，又容易产出用不上的长文档。本技能把目标收窄为：在可验证的线索下，从单一入口追到直接承载业务判断的那几段代码。

技能如何工作

触发后会先补齐两样输入：需求或问题（报错、接口 path、按钮文案、字段名等可检索词）与代码入口（单文件或符号 + 大致路径）。随后按栈自适应追踪：

读入口上下文：import、路由名、$http/axios URL、RPC/Action、常量与注释里的业务词。
语义匹配优先：用需求中的名词、动词、表名、状态码等在当前文件与一跳依赖内缩小下一跳，避免无目的全仓展开。
前后端与跨端：前端走组件 → API/store；后端走 Controller → Service → DAO/Mapper；发现 path 或 operationId 后在另一端按映射反查。
早停：一旦某处直接实现分支、校验、持久化或 UI 展示，即以该层为主锚点；多层薄封装时保留最接近业务判断的一层。

工具上优先 Grep（符号/path）、SemanticSearch（语义）、Read（局部验证）。默认在对话里给出结论、短调用链，以及用 Cursor 可导航格式的核心片段；次要位置（枚举、校验、SQL）各附一小段，单段有效代码不宜过长。

适用边界与注意点

| 维度 | 本技能 | 「梳理功能点」 |
|------|--------|----------------|
| 输入 | 需求 + 一个入口 | 入口为主、偏全量结构 |
| 目标 | 收敛到关键实现 | 结构化知识库、递归全景 |

若用户只要「从入口完整梳文档」，应换用梳理功能点；若要给具体问题找落点，用本技能。关联代码不在当前 workspace 时会标明 [⚠️ 不在当前工作空间]，只给出已知符号或接口约定，不臆造路径。无法收敛时会列出已追踪路径、排除原因、缺少的信息（如未知动态路由参数），并建议下一入口或可供 grep 的关键词。