sddadd

SDD + ADD 起始模板是一个面向AI编程助手（尤其是Claude Code）的治理框架。其主要目标是将AI助手转化为遵循规格驱动开发（SDD）工作流并结合代理驱动开发（ADD）的纪律化开发伙伴。 ## 核心工作流 该模板应用了顺序开发工作流：CONTEXT → SPEC → PLAN → TASKS → execute → verify → sync。每一步都有检查点，并且需要人工批准后才能允许代理执行。 ## 三条基础规则 1. **编辑规格而非代码**：当需求缺失或含糊时，使用 `/sdd-update` 命令先更新规格，然后在改变行为之前进行审查。 2. **无技术猜测**：规划、任务和执行仅使用 `.sdd/architecture-profile.md` 中批准的绑定和精确验证命令。 3. **人类决策**：代理不得自我批准，不得 `git push`，不得部署，也不得自主执行物理状态变更。 ## 所有权与执行 模板在 `.sdd/shared_context.md` 中区分两个独立的轴： - **项目所有权**（`solo` 或 `team`）：决定人工审查的有效性和Git交付策略。默认为 `team`。 - **代理执行**（`direct` 或 `orchestrated`）：`/add-execute` 在当前代理中直接运行，或在观察运行时能力后编排工作器。 ## 文档 模板提供了全面的文档系统： - **快速入门**（`docs/sdd-add-quickstart.md`）：面向新手的逐步路线图。 - **操作指南**（`docs/sdd-add-guide.md`）：了解工件、门禁和所有权。 - **快速参考**（`docs/sdd-add-field-guide.md`）：按场景选择命令。 - **场景手册**（`docs/sdd-add-scenario-playbook.md`）：处理绿地、棕地、错误和交接。 - **架构配置文件指南**（`docs/architecture-profile-guide.md`）：选择绑定和技术命令。 - **执行指南**（`docs/multi-agent-orchestration-guide.md`）：执行任务/功能及工作器编排。 ## 规范来源 - `.claude/skills/`：命令的契约。 - `.claude/skills/_shared/ai-review-protocol.md`：审查协议、方法论和操作记录。 - `.sdd/architecture-profile.md`：技术绑定和精确验证命令。 - `CONSTITUTION.md`：关于安全、架构和质量的硬性规则。 - `AGENTS.md`：代理范围和权限。 ## 实用脚本 - `scripts/self-heal.sh`：运行已批准的命令以收集证据；不修改源代码或重试。 - `scripts/template-smoke.sh` / `.ps1`：对文件、链接和策略契约进行静态检查。 - `scripts/adopt.*`：将模板采用到现有仓库中。 - `scripts/update.*`：从模板获取更新；治理文件暂存以供人工审查。