sdd-yolo

SDD：YOLO 全流程

你将端到端运行完整的 SDD 工作流，尽量减少中断。 流程为：分析 → 规划 → 实现 → 审查 → 归档。

整个流程只有一个确认关卡：生成规格说明和计划之后、开始实现之前。其他步骤均自动运行。

必需输入

开始前，请收集以下输入。若有任何缺失，请立即询问用户——不得在输入不全时继续。

输入	描述	示例
feature_description	端到端构建的功能	"Add JWT authentication with refresh token support"

步骤

步骤 0：验证输入（始终首先执行）

检查对话中是否提供了 feature_description，并检查 docs/project.md。

• 如果 docs/project.md 不存在 → 停止并告知用户先运行 /sdd-init。
• 如果已提供 feature_description → 继续进入阶段 1。
• 如果缺少 feature_description → 询问：“你想构建什么功能？”在用户提供之前，不得继续。

---

阶段 1 — 分析

按照完整的 sdd-feature 流程执行：

1. 阅读 docs/project.md。
2. 分析请求：feature_description（在步骤 0 中收集）。
3. 仅针对阻碍项提出澄清问题——也就是缺少这些信息就无法编写正确规格说明的情况。 跳过有关偏好或锦上添花事项的问题。最多提出 3 个问题。
4. 使用标准结构在项目根目录中编写 feature.md：

# Feature: <Feature Name>

## Summary
## User Stories
## Functional Requirements
## Acceptance Criteria
- [ ] AC-01: ...
## Technical Scope
## Non-Functional Requirements
## Out of Scope
## Open Questions

5. 输出规格说明的简要摘要（3–5 个项目符号，不要输出完整文件）。

---

阶段 2 — 规划

阶段 1 完成后，立即按照完整的 sdd-plan 流程执行：

1. 阅读 feature.md 和 docs/project.md。
2. 在项目根目录中编写 plan.md，其中包含有序的实现步骤、具体文件路径、检查清单项，以及 AC 到测试的映射表。
3. 输出计划的简要摘要（仅列出步骤名称，不包含完整细节）。

---

确认关卡

向用户显示以下提示，并在继续之前等待用户回复：

## Ready to implement

Spec: feature.md ✓
Plan: plan.md ✓

[Compact spec summary — 3–5 bullets]
[Plan steps — numbered list of step names]

Type PROCEED to start implementation, or describe any changes you want first.

• 如果用户输入 PROCEED（或等效的确认内容）：继续进入阶段 3。
• 如果用户要求修改：在 feature.md 和／或 plan.md 中应用修改，说明更改内容，然后重新显示确认关卡。
• 如果用户取消：停止并保留 feature.md 和 plan.md，供手动继续使用。

---

阶段 3 — 实现

按照完整的 sdd-implement 流程执行：

1. 阅读 plan.md、feature.md 和 docs/project.md。
2. 按照 plan.md 中的顺序执行每个步骤。
3. 每完成一层后编译并运行测试。进入下一层之前修复所有失败——不得将失败留到后续处理。
4. 未经告知用户，不得引入新的依赖项。
5. 完成所有步骤后，运行完整测试套件，并通过通过测试验证每项 AC。
6. 输出完成摘要（已创建／修改的文件、AC 通过／失败表）。

如果实现后仍有任何 AC 未通过，立即停止。报告失败项，并要求用户修复后再继续。

---

阶段 4 — 审查

阶段 3 完成后，立即按照完整的 sdd-review 流程执行：

1. 运行 git diff main...HEAD --name-only，确定已更改的文件。
2. 从所有 8 个维度进行审查（AC 覆盖率、语言最佳实践、框架惯例、安全性、重复情况、设计、性能、测试质量、可观测性）。
3. 生成完整的结构化审查报告。

---

阶段 5 — 归档或停止

评估审查结论：

如果结论为 ✅ 可以合并或 🟡 修复少量问题后合并

自动继续归档：

1. 按照完整的 sdd-archive 流程操作。
2. 更新 docs/project.md（功能列表、架构决策、API 接口、环境配置）。
3. 显示拟议的 project.md 修改，并在写入前征求确认。
4. 将 feature.md 和 plan.md 移至 docs/specs-archive/<feature-name>/。
5. 创建 docs/specs-archive/<feature-name>/README.md。

然后打印最终流水线摘要：

## YOLO Pipeline Complete ✓

Feature: <Feature Name>
Archived to: docs/specs-archive/<feature-name>/

Phase results:
  Analyse     ✓
  Plan        ✓
  Implement   ✓  (N files created, M files modified)
  Review      ✓  (<verdict>)
  Archive     ✓

Next: commit docs/specs-archive/<feature-name>/ and docs/project.md to version control.

如果结论为 🟠 需要修复并重新审查或 🔴 不要合并

停止。不要归档。

打印：

## YOLO Pipeline Stopped — Review issues require attention

Feature: <Feature Name>

Phase results:
  Analyse     ✓
  Plan        ✓
  Implement   ✓
  Review      ✗  (<verdict>)
  Archive     — (skipped)

Critical/Major findings must be resolved before archiving.
Fix the issues above, then run /sdd-review to re-review, and /sdd-archive when clean.

将 feature.md 和 plan.md 留在项目根目录，以便用户继续手动处理。