# Context Analyzer

> 分析项目上下文、Nuxt 结构和依赖项，用于规划和调试。

- Skill: `caomeiyouren/context-analyzer-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add caomeiyouren/context-analyzer-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caomeiyouren/context-analyzer-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: caomeiyouren (https://skillmd.com/u/caomeiyouren)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/caomeiyouren/context-analyzer-3

---


# 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` 来映射流程。