SDD Bootstrap

在任意 Git 仓库中初始化完整的 SDD（规格驱动开发） 治理体系。自动生成规则包配置、规格目录骨架、预检脚本、SDD 工作流技能和 AGENTS.md 规则。

快速开始

python3 sdd-bootstrap/init.py \
    --project-root /path/to/my-project \
    --profile my_backend \
    --source-roots "src,lib" \
    --force-full-paths "src/core,src/api,migrations"

生成内容

类别	输出
配置	rule-pack.<profile>.yaml
技能（12 个）	SDD 工作流技能文件，输出到 docs/skill/
脚本（3 个）	sdd_preflight_gate.py、branch_advisor.py、spec_advisor.py
文档	SDD_WORKFLOW.md、SDD_QUICKSTART.md、AI_CHANGELOG.md
治理	AGENTS.md 中注入 SDD 硬性规则段落
目录	docs/specs/、docs/decisions/、docs/logs/sdd-preflight/、docs/skill/scripts/

项目结构

sdd-bootstrap/
├── init.py                # 主引导入口
├── SKILL.md               # 技能元数据与工作流描述
├── scripts/
│   ├── sdd_preflight_gate.py
│   ├── branch_advisor.py
│   └── spec_advisor.py
├── skills/                # 12 个 SDD 技能定义
│   ├── sdd-feature-loop.skill.md
│   ├── sdd-branch-advisor.skill.md
│   ├── sdd-changelog-recorder.skill.md
│   ├── sdd-implementation-plan.skill.md
│   ├── sdd-interface-contract.skill.md
│   ├── sdd-lafr-bugfix.skill.md
│   ├── sdd-research-spec.skill.md
│   ├── sdd-spec-advisor.skill.md
│   ├── sdd-spec-diff-review.skill.md
│   ├── sdd-step-executor.skill.md
│   ├── sdd-test-spec-builder.skill.md
│   └── project-sdd-governance.skill.md
└── templates/             # 初始化时渲染的模板
    ├── rule-pack.template.yaml
    ├── AGENTS.sdd-section.md
    ├── SDD_WORKFLOW.template.md
    ├── SDD_QUICKSTART.template.md
    ├── AI_CHANGELOG.template.md
    └── specs-README.template.md

技能概览

技能	用途
sdd-feature-loop	端到端 SDD 编排
sdd-research-spec	研究并生成规格草案
sdd-interface-contract	定义接口契约
sdd-implementation-plan	创建分步实施计划
sdd-step-executor	执行单个实施步骤
sdd-test-spec-builder	生成测试规格
sdd-spec-diff-review	审查规格变更
sdd-branch-advisor	分支命名与管理建议
sdd-spec-advisor	规格质量与覆盖度建议
sdd-changelog-recorder	记录变更到 AI 变更日志
sdd-lafr-bugfix	前瞻性修复与修补（LAFR）缺陷修复流程
project-sdd-governance	项目级 SDD 治理规则

初始化后检查清单

运行 init.py 后：

• 检查 rule-pack.<profile>.yaml —— 确认 force_full_paths 配置
• 填写 docs/specs/README.md —— 定义领域归属边界
• （可选）添加项目特有的阶段钩子技能
• （可选）添加 CI 合并门禁（在 GitHub Actions / pre-push hook 中使用 scripts/sdd_preflight_gate.py）
• 运行第一次 SDD 循环：

  python3 scripts/sdd_preflight_gate.py --topic "first-feature" --details "..." --dry-run

许可证

MIT