context-analyzer by CaoMeiYouRen

---
name: context-analyzer
description: 在动手规划、修改、调试或回答复杂项目问题前使用。用于快速扫描项目结构、依赖、约束文档、关键文件和调用链，输出任务相关上下文，而不是直接改代码。用户提到 analyze context、scan repo、understand project、定位实现、找规范、排查调用链时都应触发。

metadata:
  internal: true
---

# Context Analyzer

铁律：在没有建立最小充分上下文前，不要直接下结论，更不要直接修改代码。

## 工作流

- [ ] Step 1: 先扫结构 ⚠️ REQUIRED
	- [ ] 1.1 查看根目录、关键子目录和配置文件。
	- [ ] 1.2 忽略构建产物与依赖目录，聚焦真实源码和文档。
- [ ] Step 2: 自动发现约束文档 ⚠️ REQUIRED
	- [ ] 2.1 优先读根目录文档、AGENTS.md、README、贡献与安全文档。
	- [ ] 2.2 如果存在 docs/、.github/ 或特定规范文件，再按主题补读。
- [ ] Step 3: 锁定任务相关代码
	- [ ] 3.1 用文件名、符号名、配置项和调用链缩小范围。
	- [ ] 3.2 识别入口、核心模块、依赖边界和风险区域。
- [ ] Step 4: 输出上下文摘要
	- [ ] 4.1 给出关键文件、已知约束、未知点和下一步建议。
	- [ ] 4.2 区分“已确认事实”和“待验证假设”。

## 输出目标

- 任务相关文件清单。
- 需要遵循的规范来源。
- 关键数据流、依赖和调用链摘要。
- 仍然缺失的信息和最小下一步。

## 常见项目切入点

- package.json：确认脚本、依赖和实际工具链。
- server/api、pages、components、composables：判断前后端边界与调用链。
- lib/auth.ts、lib/auth-client.ts、middleware/auth.global.ts、server/api/auth/*：排查认证与权限流时优先检查。
- README、AGENTS.md、CONTRIBUTING.md、SECURITY.md：优先提取项目规则与协作约束。

## 反模式

- 把仓库里所有文件都读一遍，导致分析失焦。
- 看到相似文件名就假定实现细节一致。
- 不区分事实和猜测，直接给出实现建议。

## 交付前检查

- [ ] 已定位任务相关文件，而不是泛泛而谈。
- [ ] 已优先扫描实际存在的规范文档。
- [ ] 已把结论、证据和未知点分开表述。
- [ ] 输出足以支撑下一步规划或实现。