| name | context-analyzer |
| description | 分析项目上下文、Nuxt 结构和依赖项，用于规划和调试。 |
| metadata | {"internal":true} |
server/api, components, pages) 以及 Nuxt 4 特性。lib/auth.ts (服务端), lib/auth-client.ts (客户端), middleware/auth.global.ts (全局中间件)。package.json 以验证已安装的包和版本。.session/current-task.yaml 等 session 级文件，快速恢复当前任务上下文、进度与认知状态。node_modules 和 .output。server/api 识别为后端定义，将 pages/components 识别为前端。server/api/auth/* 和 middleware/auth.global.ts。package.json 以了解可用的库。.session/current-task.yaml 了解当前任务状态、进度与认知模式；若文件不存在，回退到只读 docs/plan/todo.md 获取阶段级上下文。在分析上下文时，先判断信息需求类型，再选择正确工具。用错工具 = 信息召回失败。
| 信息类型 | 正确工具 | 用错后果 |
|---|---|---|
| 精确字面量（字段名、环境变量、API 路径） | Grep / Glob | 语义检索给出模糊候选，全错 |
| 跨词同义（业务术语 ↔ 代码术语） | 先查 docs/ 对照文档，后做语义关联 | grep 0 hits |
| 调用链 / 结构关系（import 链、引用关系） | 追踪文件 import / require 关系 | 语义检索不理解语法 |
| 时间轴（谁何时改、哪个 commit 引入） | git log / git blame | 其他工具无时间维度 |
原则：把规则告诉模型，让模型选工具；不要写代码替模型选。
输入: "分析当前的用户认证流程。"
动作: 读取 server/api/auth/*, lib/auth-client.ts, middleware/auth.global.ts 和 pages/login.vue 来映射流程。
专门负责管理项目路线图 (roadmap.md)、待办事项 (todo.md)、待办归档 (todo-archive.md) 与阶段切换收口流程。
暂存更改并生成符合 Conventional Commits 规范的提交消息。
全局一体化开发与协作工作流技能，覆盖需求评估、开发、测试、质量、文档、提交、发布等全链路阶段，可集成所有基础原子技能，实现 PDTFC+ 循环自动化及分工合作优化。
编写、运行和优化项目测试用例（Vitest）。
审查 git 变更、Review Gate、merge ready、发布前审计以及代码、文档、配置、脚本质量门禁时使用。输出结构化 Pass 或 Reject 结论、问题分级、最低验证矩阵、证据链和复查基线；当用户提到 review、code review、审计、review gate、merge ready、blocker、evidence、pass、reject 时触发。
专注于查阅、维护和生成项目文档 (位于 docs/ 目录下)。