用途:在动手规划、修改、调试或回答复杂项目问题前,先建立最小充分上下文,避免直接下结论或改代码。触发场景包括 analyze context、scan repo、understand project、定位实现、找规范、排查调用链。
主要能力与工作流:第一步扫描根目录、关键子目录和配置文件,忽略构建产物与依赖目录,聚焦真实源码和文档;第二步自动发现约束文档,优先读根目录文档、AGENTS.md、README、贡献与安全文档,如存在 docs/、.github/ 或特定规范文件再按主题补读;第三步用文件名、符号名、配置项和调用链锁定任务相关代码,识别入口、核心模块、依赖边界和风险区域;第四步输出上下文摘要,给出关键文件、已知约束、未知点和下一步建议,并区分已确认事实与待验证假设。
输出目标:任务相关文件清单、需遵循的规范来源、关键数据流与依赖调用链摘要、仍缺失的信息和最小下一步。常见切入点包括 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 提取项目规则。
限制与反模式:不要读遍所有文件导致分析失焦,不要因文件名相似就假定实现一致,不要不区分事实和猜测直接给实现建议。交付前需确认已定位任务相关文件、已优先扫描实际存在的规范文档、已分开表述结论证据与未知点,且输出足以支撑下一步规划或实现。具体安装与调用方式暂未提供。