用途:扫描代码库并生成或更新 docs/project-reference/project-structure-reference.md,记录服务架构、API 端口、目录结构、技术栈与模块代码。
主要能力:Phase 0 检测架构类型(微服务、单体、单体仓库、Nx 单体仓库、多仓库)与编排方式(.NET Aspire、Docker Compose、Kubernetes/Helm、直接运行)及扫描模式(Init/Sync);Phase 1 建立任务跟踪;Phase 2 并行启动 3 个子代理分别扫描后端服务、前端应用、基础设施与技术栈,每项发现须引用 file:line,置信度 >80% 记录、60–80% 标注未验证、<60% 省略;Phase 3 生成架构概览、服务架构、基础设施端口、前端应用、技术栈、模块代码、关键目录等章节;Phase 4 局部写入并用 Glob/Grep 校验全部 Dockerfile 路径与端口。
使用方式:需先读取 docs/project-config.json、docs/project-reference/docs-index-reference.md 与 lessons.md,按任务类型打开相关参考文档;在 Codex 中用 $skill-name 调用,工作流中逐步执行并报告证据。端口必须读取实际配置文件(launchSettings.json、appsettings*.json、docker-compose.yml),不得凭记忆推断;架构类型置信度低于 60% 时报告不确定并停止。
限制与环境要求:仅做局部更新,禁止整体重写或删除无证据过时的章节;所有路径与端口需双向核验,Round 1 发现问题后须由零记忆的新子代理做 Round 2 复验。若步骤或工具在当前环境不可运行,应先停止并询问用户。文档未提供该技能的收费、价格、平台依赖与具体版本信息。