context-analyzer

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)

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 了解当前任务状态、进度与认知模式；若文件不存在，回退到只读 获取阶段级上下文。