功能点梳理

要解决什么问题

让 AI 改代码或做重构时，上下文往往只有产品说明或零散文件，缺少可定位的实现视图：谁调谁、类型边界在哪、前后端接口是否对得上。本技能把「从入口读代码」当成固定工序，产出面向模型的实现向文档，而不是业务需求复述。

技能如何工作

1. 识别元数据：分析入口文件的类型（前端 / 后端 / 全栈）、路径、技术栈，以及导出与导入依赖。
2. 递归追踪：前端按子组件 → Hooks → API 模块 → Store → 路由展开；后端按 Controller → Service → Repository → Entity/DTO → 配置展开。
3. 跨端关联：尝试把前端 API 调用与后端接口对齐。若关联代码不在当前工作空间，会暂停并询问；确认后在文档中统一标记为 [⚠️ 关联代码不在当前工作空间] 再继续。
4. 结构化提取：记录签名、类/接口定义、调用关系链；核心逻辑用 少于 20 行 的代码块呈现，可用 //... 省略样板代码。前端侧重 Props/State/生命周期；后端侧重路由、SQL、事务等实现细节。

输出要求路径 + 函数名/行号可回溯，核心片段必须来自真实代码，禁止臆造缺失实现。默认在对话中输出；仅在你明确要求时才生成 .md 文件。

适用边界与注意点

• 聚焦代码实现，不展开业务故事或运营文案。
• 工作空间外依赖无法自动展开，需你确认后才会带警告标记继续。
• 适合作为单次入口的「实现地图」；若仓库极大，应明确入口文件或模块范围，避免无边界递归。