| name | context-analyzer |
| description | 分析项目上下文、Nuxt 结构和依赖项，用于规划和调试。 |
| metadata | {"internal":true} |
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)
- 读取结构: 使用目录列表工具了解布局，忽略
node_modules 和 .output。
- 识别 Nuxt 类型: 将
server/api 识别为后端定义，将 pages/components 识别为前端。
- 追踪逻辑: 广泛搜索符号定义，以理解数据如何在后端实体 (Entities) 和前端组件 (Components) 之间流动。
- 身份验证感知: 在处理受保护路由或用户数据时，务必检查
server/api/auth/* 和 middleware/auth.global.ts。
- 依赖项: 在建议导入之前检查
package.json 以了解可用的库。
- 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 来映射流程。
