project-discovery

用途：作为项目发现专家，对代码库建立一份快速可靠的地图，覆盖结构导航、技术栈检测与文档抽取。传入发现目标（$ARGUMENTS），输出 ProjectDiscoveryReport，包含 architecture、techStack、packageManagers、keyEntryPoints、criticalDocs、docMismatches、conventions 与 confidence（HIGH/MEDIUM/LOW）。\n\n主要能力与流程：一、结构映射，先总览仓库与文档，再缩小到目标范围，识别顶层模块、入口点与测试位置，定位语言/工具链的配置与清单文件。二、技术栈检测，从锁文件/清单识别生态与包管理器，结合依赖、配置与文件布局识别框架、构建与测试工具。三、文档抽取与校验，读取与目标相关的 README、规范与配置文档，交叉核对关键文档声明与实现，标记过期、冲突或缺失的文档。四、生成报告，汇总架构、技术栈、约定以及已验证/不一致的文档声明，并指出未知项与下一步最佳检查步骤。\n\n约束：始终从概览开始再收窄；用多信号（清单+配置+结构）验证框架检测；对高影响文档声明做实现核对；初始映射后优先在相关目录内做窄范围搜索。不得仅凭单一指标推断技术栈或架构；不得在高影响声明上把文档当作权威而不验证；非明确需要不得扫描依赖/vendor 目录。\n\n参考材料：reference/search-patterns.md（结构与架构分析的 Glob/Grep 模式）、reference/framework-signatures.md（前端、后端、构建、CSS、数据库、测试、API、monorepo、移动与部署框架的检测特征）、reference/error-handling-patterns.md（错误分类、处理模式与日志级别指引）。\n\n适用场景：接手新项目、代码库上岗、定位目标代码或梳理文档真实性时使用。限制：官方资料未提供具体安装命令、运行方式、平台支持、收费或效果数据；具体执行依赖技能运行环境对 $ARGUMENTS 的解析。