用途:在开始存量项目 Discover 前做两件事——盘点证据入口(Preflight)与控制范围(Scope)。目标是先明确“从哪里进入、如何定位”,而不是把信息写全。使用时可宣布正在执行该技能。
输入:仓库根目录(代码、配置、依赖、CI/CD);已有文档入口(README、Makefile、package.json、脚本等);可观测/运维入口(dashboard、告警、runbook、回滚)。
输出(落盘):.aisdlc/project/components/index.md(模块清单 + P0/P1/P2 + code_entry + 复选框,此时不打勾);.aisdlc/project/memory/structure.md(以链接固定运行/验证/发布入口)。证据入口清单不单独建文件,分散落位到 memory/、模块页与 ops/。
Preflight 原则:优先可执行证据(脚本/CI job/契约文件/迁移/生成命令 > 描述性文档 > 口述经验);只记录入口,不写推断;缺证据写入 ## Evidence Gaps(缺口/期望粒度/候选位置/影响)。最小清单涵盖运行入口(启动脚本、环境变量)、测试入口(单测/集成/E2E、覆盖率门禁)、CI/CD 入口(workflow/pipeline 位置与关键 job 名)、契约入口(OpenAPI/Proto/GraphQL、迁移/DDL/ORM)、可观测运维入口(dashboard、告警、日志、runbook、回滚)。
Scope 分级:P0 为高频变更、跨团队交界、对外集成多、事故热点或合规风险高;P1 为稳定但常被引用/依赖的基础能力;P2 为低风险、低协作、生命周期短,先索引占位。逆向深度止损:P0 必须有模块页且含 ## API Contract、## Data Contract、## Evidence(有缺口则不打勾);P1 必须有模块页,允许 API 或 Data 之一降级为 Evidence Gaps;P2 仅索引导航,默认不建页。索引表格只导航,不写不变量、字段或“待补/未发现”。
并行化:入口盘点互不依赖时可并行——Agent A 运行与环境变量、Agent B 测试与质量门禁、Agent C CI/CD、Agent D 契约与 Ops。
限制与红旗:Scope 未做就写细节、用猜测填运行/测试/契约、在索引写类/表/错误码/字段列表均属失控;Preflight 不应变成写 README 教程,也不应一次覆盖全部模块,应先完成 P0 三件套。具体收费、平台支持等信息暂未提供。