SuperAPI AI 工具集

project-discover

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:把“已有代码的存量项目”在一次指令内逆向沉淀为 .aidlc/project/ 项目级 SSOT,供后续 Spec Pack 的 AI 辅助开发使用,避免重复跑 Discover。核心不是翻译文档,而是立起三件事:可导航的索引骨架(索引只导航)、每个 P0 模块的单页模块 SSOT(模块页权威)、每条关键结论指向仓库内证据入口或结构化缺口。开始时应宣布:“我正在使用 project-discover 技能执行存量项目 Discover(逆向)并建立 .aidlc/project/ 项目级 SSOT。”

主要产出:Level-0/Memory(structure.md、tech.md、product.md、glossary.md)、Level-1 地图索引(components/index.md 含 direct-only 依赖图,products/index.md)、模块页(P0 尽可能创建并填充到 DoD,P1 允许一段契约降级到 Evidence Gaps,P2 仅索引占位)、Ops 入口(有证据则创建)、DoD 门禁与增量 Discover/stale 机制。

硬规则:禁止产出 .aidlc/project/contracts/**;契约合并进模块页固定段落 ## API Contract / ## Data Contract;索引只导航,不写不变量、字段、详细流程或“待补”;P0 模块页须含固定标题 ## TL;DR、## API Contract、## Data Contract、## Evidence、## Evidence Gaps;缺证据就写 Evidence Gaps,不脑补;先做 P0/P1/P2 止损;Products 默认收敛到 <= 6。

执行策略:本技能是总控编排器,一次运行完成,不拆多轮。流程为:先建 Memory + Index 骨架;并行补模块页(总控唯一可写 memory/、components/index.md、products/index.md;模块子代理只写自己负责的 components/{module}.md;products 子代理只写 products/;ops 子代理只写 ops/*);并行收敛 Products、补 Ops;最后做 DoD 与一致性门禁回填。面对 2+ 互不依赖任务域时可用并行子代理,但须给出路径白名单、固定标题要求与不脑补规则。

适用场景:为存量项目建立或补齐 .aidlc/project/;入口、边界、契约总靠猜导致反复返工;担心索引与细节双写、字段大全、TODO 散落;需要增量 Discover 对抗知识过期。不适用:需求级 Spec Pack 的 requirements/design/implementation;字段级数据字典作为独立治理体系。

限制与门禁:索引只导航校验;P0 模块页须 frontmatter 齐全、契约段落含权威入口 + 3–7 条不变量 + 证据入口,有缺口不得勾选;P1 允许 API 或 Data 其一缺失但须结构化记录;P2 默认不勾选;勾选只反映模块页是否达标,不得先勾选再补内容;依赖图只画 direct-only 并标注交互方式。