context-analyzer

# Context Analyzer Skill (上下文分析技能) ## 能力 (Capabilities) - **项目结构分析**: 理解 Nuxt 目录约定 (`server/api`, `components`, `pages`) 以及 Nuxt 4 特性。 - **符号解析**: 定位组件、自动导入的可组合函数 (composables) 和 TypeORM 实体的定义。 - **认证流程分析**: 深入理解 Better-Auth 的集成，包括 `lib/auth.ts` (服务端), `lib/auth-client.ts` (客户端), `middleware/auth.global.ts` (全局中间件)。 - **依赖检查**: 读取 `package.json` 以验证已安装的包和版本。 - **Session 上下文恢复**: 读取 `.session/current-task.yaml` 等 session 级文件，快速恢复当前任务上下文、进度与认知状态。 ## 指令 (Instructions) 1. **读取结构**: 使用目录列表工具了解布局，忽略 `node_modules` 和 `.output`。 2. **识别 Nuxt 类型**: 将 `server/api` 识别为后端定义，将 `pages`/`components` 识别为前端。 3. **追踪逻辑**: 广泛搜索符号定义，以理解数据如何在后端实体 (Entities) 和前端组件 (Components) 之间流动。 4. **身份验证感知**: 在处理受保护路由或用户数据时，务必检查 `server/api/auth/*` 和 `middleware/auth.global.ts`。 5. **依赖项**: 在建议导入之前检查 `package.json` 以了解可用的库。 6. **Session 上下文恢复**: 在分析项目上下文时，优先读取 `.session/current-task.yaml` 了解当前任务状态、进度与认知模式；若文件不存在，回退到只读 `docs/plan/todo.md` 获取阶段级上下文。 ### 信息检索铁律：先分类再选工具 在分析上下文时，先判断信息需求类型，再选择正确工具。用错工具 = 信息召回失败。 | 信息类型 | 正确工具 | 用错后果 | |:---|:---|:---| | **精确字面量**（字段名、环境变量、API 路径） | `Grep` / `Glob` | 语义检索给出模糊候选，全错 | | **跨词同义**（业务术语 ↔ 代码术语） | 先查 `docs/` 对照文档，后做语义关联 | `grep` 0 hits | | **调用链 / 结构关系**（import 链、引用关系） | 追踪文件 `import` / `require` 关系 | 语义检索不理解语法 | | **时间轴**（谁何时改、哪个 commit 引入） | `git log` / `git blame` | 其他工具无时间维度 | 原则：把规则告诉模型，让模型选工具；不要写代码替模型选。 ## 使用示例 (Usage Example) 输入: "分析当前的用户认证流程。" 动作: 读取 `server/api/auth/*`, `lib/auth-client.ts`, `middleware/auth.global.ts` 和 `pages/login.vue` 来映射流程。