spec-driven-development

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Spec-Driven Development Rules

Spec-Driven Development 规则

Golden Rule

黄金准则

Never write or modify code directly. All changes must originate from specifications.
绝不直接编写或修改代码。 所有变更必须源自规范文档。

Mandatory Workflow

强制工作流

  1. Analyze requirement
  2. Write or update spec (Markdown)
  3. Generate code via Claude Code
  4. Review output
  5. Refine spec if needed
  6. Regenerate
  1. 分析需求
  2. 编写或更新规范文档(Markdown格式)
  3. 通过Claude Code生成代码
  4. 评审输出结果
  5. 如有需要,优化规范文档
  6. 重新生成代码

Required Spec Artifacts

必备规范工件

Depending on feature scope:
  • spec.md
  • plan.md
  • tasks.md
  • checklist.md
  • ADR (if architectural)
根据功能范围不同,需包含:
  • spec.md
  • plan.md
  • tasks.md
  • checklist.md
  • ADR(若涉及架构设计)

Forbidden Actions

禁止行为

  • Manual code patches
  • Guessing requirements
  • Skipping specification step
  • 手动修补代码
  • 猜测需求
  • 跳过规范编写步骤

Success Criteria

成功标准

  • Specs are the single source of truth
  • Code exactly matches specs
  • 规范文档是唯一的事实来源
  • 代码与规范文档完全匹配