SuperAPI AI 工具集

project-adopt

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

用途:把已存在的代码库(brownfield)接入 SDD 流程,是 project-init 的对应版本。适用于已有源代码但尚无 docs/ SDD 结构、需要从运行系统推导基线制品的场景;若代码和文档都不存在应改用 project-init,若 docs/01_BRD 等已存在则直接进入 doc-flow。

主要能力与步骤:1)先检测仓库中的源码模块、公共接口、配置、README/ADR/设计笔记与测试,记录可引用来源,测试可作为 BDD/TDD 基线证据;2)从代码和文档推断领域(Financial、Software-SaaS、Healthcare、E-commerce、IoT、Generic)并与用户确认,含糊时默认 Generic;3)搭建 8 层结构:mkdir -p docs/{01_BRD,02_PRD,03_EARS,04_BDD,05_ADR,06_SPEC,07_TDD,08_IPLAN} 与 mkdir -p docs/08_IPLAN/tmp plans;4)反向工程 8 个基线制品,全部为 draft 状态,SPEC 来自模块/接口签名、数据模型与契约,ADR 来自现有设计笔记与架构隐含决策,EARS/BDD 来自可观察行为与现有测试,BRD/PRD 来自系统交付的产品行为与能力,TDD/IPLAN 来自现有测试套件与已建成文件布局;推断内容需显式标注,缺口不得编造占位 ID,仅在上游制品真实存在时添加 @ 标签,未知项记为 gap;5)创建各层索引文件(BRD-00_index.md 等);6)校验 8 个目录、索引、plans/ 及每层一个 draft 基线制品;7)交接给 doc-flow 与各层 -audit 技能,再由 -fixer 修复,最后用 doc-validator 确认可追溯性。

适配与限制:搭建前读取 .aidoc/profile.yaml,仅按 active_layers 创建结构,不搭建被禁用的可跳过层,忽略未知键;权威说明见 framework/governance/ADAPTATION.md。制品集与模板分别来自 LAYER_REGISTRY.yaml 和 framework/layers/NN_<X>/。所有推导制品初始为 draft,需由各层技能提升至 ready。