用途:为 SDD 流程初始化全新(greenfield)项目,属于跨层工具,先于 BRD 执行。适用场景:项目尚无 docs/ 结构、尚未选择领域时使用;若 docs/01_BRD/ 等已存在,应直接进入 ../doc-flow/SKILL.md。
主要能力与步骤:
- 领域选择:询问项目目标领域并记录,选项为 1 金融服务(默认)、2 软件/SaaS、3 医疗、4 电商、5 IoT、6 其他/通用,该选择决定第 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
- 领域配置:应用所选领域的术语映射(如金融:[RESOURCE_ITEM]→Position、[USER_ROLE]→Trader;软件:[RESOURCE_ITEM]→Resource、[USER_ROLE]→Account Admin;通用:[RESOURCE_ITEM]→Entity),并创建领域专属子目录。
- 索引文件:
touch docs/01_BRD/BRD-00_index.md docs/02_PRD/PRD-00_index.md
docs/03_EARS/EARS-00_index.md docs/04_BDD/BDD-00_index.md
docs/05_ADR/ADR-00_index.md docs/06_SPEC/SPEC-00_index.md
docs/07_TDD/TDD-00_index.md docs/08_IPLAN/IPLAN-00_index.yaml 后续每个产物须填写 Document Control(名称、版本、日期、负责人、状态、修订历史)。 - 校验:确认 8 个目录、索引文件、领域子目录与 plans/ 均存在,缺失则重跑相应步骤。
- 交接:报告初始化完成,并引导用户到 ../doc-flow/SKILL.md 从 doc-brd 开始;模板引用自 ${CLAUDE_PLUGIN_ROOT}/framework/layers/NN_<X>/,复制到项目为可选。
适配:搭建前读取项目适配配置 .aidoc/profile.yaml,遵循 active_layers,仅为启用的层创建结构,不搭建被禁用的可跳过层;忽略未知或超出范围的键。权威依据:${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md。
相关资源:下一步 ../doc-flow/SKILL.md;层注册表 ${CLAUDE_PLUGIN_ROOT}/framework/registry/LAYER_REGISTRY.yaml;模板与 README 位于 ${CLAUDE_PLUGIN_ROOT}/framework/layers/NN_<X>/;图表见 ../charts-flow/SKILL.md。
限制:仅用于一次性初始化,不适用于已有 docs/ 结构的项目;具体模板内容与各层细节资料未提供。