context-analyzer

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

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：优先提取项目规则与协作约束。

反模式

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

交付前检查

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