跳转至

SDS — 规格定义软件 (需求交付版本)

欢迎来到软件工程的未来。

规格说明定义软件 (Spec-Defined Software, SDS) 代表了软件交付模式的重大变革：从传统的“手动编码”升级为精准的、AI 协同的“规格定义”。在这一范式中，业务需求的完整行为和业务标识被元数据化写入 spec.md（定义“做什么”），并映射到 design.md 的技术设计上（定义“怎么做”）。

实际的物理代码、数据库迁移、测试套件和部署配置被视为逻辑衍生品，它们完全可以由先进 of AI 引擎自动合成、验证与自我修复。

🚀 SDS 核心理念：代码即编译产物

始终将规格说明书（Specification）视为整个需求交付流程的绝对唯一真理源。优先保证规格说明的完整性与清晰度，而非急于直接编码。

  [ 用户场景 ] ➔ [ 达成共识的规约与设计 ] ➔ [ 物理实现 ] ➔ [ 自动化验证 ] ➔ [ 需求交付 ]

代码仅仅是已交付需求的一个编译产物。通过将修改聚焦在“规格说明优先”的交付模型上，我们的每一次改动都能百分之百地追溯回规格说明书中的验收准则（AC），从而实现“零漂移（Zero-Drift）”式高质量开发。

🛠️ SDS 多技能生命周期工具链

为了彻底摆脱被动的“代码语法校验（Linting）”并支持完整的需求交付流水线，SDS 编排并集成了多个专属的智能体技能（Agent Skills）：

  1. sds-ideator (需求阶段)：苏格拉底式需求风暴技能，引导开发者将模糊的用户诉求提炼为严密的、Gherkin 风格的验收准则（AC）。
  2. sds-architect (设计阶段)：自动将产品需求转换为正式的 API 契约、数据库 Schema 变更和技术架构模式。
  3. sds-coder (实现阶段)：拉起隔离的编码子智能体执行物理特征与单元测试编写，并自动维护 @sds-trace 代码注释覆盖率。
  4. sds-qa (验证阶段)：🧪 核心质量闸门。 自动将 spec.md 的 AC 以及 user-journey.md（User Story）的用户故事进行全自动 BDD 测试合成，实现全面的需求闭环校验。
  5. sds-ops (交付阶段)：使用基于 symlink 的原子化隔离部署环境，管理数据库迁移总账，并运行冒烟测试。

📦 极速上手

只需几秒，即可在本地和 AI 环境中运行 SDS 命令行工具：

1. 一键安装

使用我们的一键脚本安装 CLI 工具： 

curl -fsSL https://raw.githubusercontent.com/flingfox63/spec-defined-software/main/install.sh | sh

2. 初始化项目

在业务仓库根目录下执行骨架初始化： 

sds init
这将生成配置文件 .sds.harness.yaml 并建立标准的 specs/ 目录规范。

3. 执行规范校验

对代码层注释、规格说明格式以及需求一致性进行全方位扫描： 

sds check

🗺️ 生态路线图 (Ecosystem Roadmap)

SDS 正在从一个基础的静态校验工具，逐步演进为一个端到端、完全自动化的 AI 协同软件交付操作系统。以下是我们的核心里程碑与发展时间线：

阶段 / 模块 计划时间 当前状态 核心交付物与能力介绍
sds-core
(校验护栏)		 已发布 🟢 已发布 • 静态校验 specs/ 目录结构与 Frontmatter 状态。
• 物理集成 Pre-commit 钩子与跨平台一键安装器。
• 暴露标准的 Model Context Protocol (MCP) 语义服务器。
sds-ideator
(苏格拉底产品经理)		 2026 Q3 🟡 进行中 • 苏格拉底式对齐 Prompt 套件，将模糊想法提炼为 BDD Gherkin AC。
• 自动在 specs_review/ 目录下合成并起草初始 spec.md 规范。
sds-architect
(架构总监)		 2026 Q3 🟡 进行中 • 将通过的业务规范一键编译为具象的技术实现方案。
• 自动生成 TypeScript/Go API 契约、数据库迁移脚本并写入 design.md。
sds-coder
(自主代码合成)		 2026 Q4 🔵 规划中 • 智能体驱动的自动化编码器，直接基于 Spec 生成业务代码。
• 自动插桩 @sds-trace 并自动修复测试编译/规范漂移报错。
sds-qa
(BDD 测试编译器)		 2026 Q4 🔵 规划中 • 将 AC 自动编译为可运行的集成测试、单元测试与 E2E 校验脚本。
• 强制执行质量卡点检验，通过后才可解锁后续部署管道。
sds-ops
(原子化无损发布)		 2027 Q1 🔵 规划中 • 类似 Capistrano 风格的原子化符号链接（Symlink）版本切换发布。
• 自动隔离 Virtualenv 并支持一键免密无损回滚策略。

💖 致敬与灵感来源 (Heritage & Inspiration)

Spec-Defined Software (SDS) 非常荣幸继承了开源社区的优秀传统，本项目的核心设计深受 GitHub 先驱项目 spec-kit 规范开发模式的启发并由其演进而来。

我们在其经典 spec-kit 规范驱动理念之上，针对 AI 原生开发时代进行了大幅度的能力扩展 —— 物理引入了零偏差静态校验器、多智能体协同安全网、以及物理层双向可追溯 @sds-trace 机制，致力于打造 AI 原生时代下坚不可摧的需求契约闭环。

[!NOTE] SDS 与现代的多智能体协同框架和 MCP 协议完美兼容，为你的 AI 辅助编码助手（如 Cursor、Cline）提供最强大的后台校验武器。