Spec 驱动的 AI 编程脚手架，用结构化工作流提升大模型编码质量。
SDD-RIPER 是一套面向 AI Agent 的研发工作流 Skill，通过 Spec 驱动开发（SDD） 和 RIPER 阶段门禁 机制，让大模型在编码时遵循可审计、可追溯的研发流程，避免"裸改代码"带来的质量风险。
核心理念：
- No Spec, No Code — 没有 Spec 不写代码
- No Approval, No Execute — 没有审批不执行
- Spec is Truth — Spec 是唯一真相源
本仓库包含两个 Skill，适用于不同场景：
| sdd-riper-one（标准版） | sdd-riper-one-light（轻量版） | |
|---|---|---|
| 定位 | 完整 RIPER 阶段门禁框架 | checkpoint-driven 轻量工作流 |
| 适用模型 | 各类 AI 模型 | 强模型（Claude Opus / GPT-5+） |
| 适用场景 | 中大型功能开发、架构改动、多项目协作 | 高频多轮、大上下文、快速迭代 |
| 上下文策略 | 热/温/冷三层上下文管理 | 最小 spec + 核心目标锚点 |
| 流程控制 | 严格阶段门禁 | 按需展开，灵活裁剪 |
将 skills/ 目录下对应的 Skill 文件夹复制到你的 Skill 宿主环境中：
# 标准版
cp -r skills/sdd-riper-one /path/to/your-skill-host/skills/
# 轻量版
cp -r skills/sdd-riper-one-light /path/to/your-skill-host/skills/标准流程（中大型任务）：
请启用 sdd-riper-one，依次执行：
1. create_codemap scope=feature path=src/auth
2. build_context_bundle dir=requirements/auth
3. sdd_bootstrap task=用户认证重构 goal=迁移到JWT requirement=mydocs/context/..._context_bundle.md
快速流程（小任务）：
请启用 sdd-riper-one，执行 sdd_bootstrap：
- task=修复登录超时
- goal=登录接口超时从 30s 降到 5s
- requirement=用户反馈登录偶发 30s 无响应
流程推进至 Plan 阶段后，回复精确字样 Plan Approved 以进入执行。
请使用 sdd-riper-one-light 先收敛任务，不要直接改代码。
先给我：
- 你对任务的理解
- 本轮阶段性核心目标
- micro-spec / summary
- Done Contract（什么算完成、由什么证明）
- 下一步动作 + 风险
我批准后再执行。
轻量版根据任务复杂度自动选择深度：
| 深度 | 适用场景 | Spec 要求 |
|---|---|---|
zero |
typo、配置值等纯机械改动 | 跳过，完成后一句话 summary |
fast |
单文件小改动 | micro-spec（1-3 句） |
standard |
2+ 文件、一般功能开发 | 轻量 spec，落盘 |
deep |
架构/跨模块/需求模糊 | 完整分析写回 spec，获批后执行 |
| 命令 | 用途 | 输出路径 |
|---|---|---|
create_codemap |
生成功能级/项目级代码索引 | mydocs/codemap/ |
build_context_bundle |
整理需求文档为上下文包 | mydocs/context/ |
sdd_bootstrap |
启动 RIPER，产出首版 Spec | mydocs/specs/ |
review_spec |
Execute 前建议性预审 | GO/NO-GO 判定 |
review_execute |
Execute 后三轴质量评审 | Review Matrix |
archive |
归档沉淀，生成 human/llm 双文档 | mydocs/archive/ |
debug |
日志驱动排查，不改代码 | 根因分析报告 |
| 触发词 | 动作 |
|---|---|
MAP / 链路梳理 / 只看代码 |
功能级 CodeMap |
PROJECT MAP / 项目总图 / MAP ALL |
项目级 CodeMap |
MULTI / 多项目 |
进入多项目模式 |
CROSS / 跨项目 |
允许跨项目改动 |
FAST / 快速 / >> |
小改快速通道 |
REVIEW SPEC / 计划评审 |
建议性预审 |
REVIEW EXECUTE / 代码评审 |
三轴审查 |
ARCHIVE / 归档 / 沉淀 |
知识沉淀 |
DEBUG / 排查 |
日志驱动诊断 |
EXIT SDD / 退出协议 |
退出状态机 |
Pre-Research RIPER 主流程
┌─────────────────────┐ ┌──────────────────────────────────────────────┐
│ create_codemap │ │ Research │
│ ↓ │ │ ↓ │
│ build_context_bundle│───→│ [Innovate] (可选，2-3 方案比较) │
│ ↓ │ │ ↓ │
│ sdd_bootstrap │ │ Plan ──→ "Plan Approved" ──→ Execute │
└─────────────────────┘ │ ↓ │
│ Review │
│ ↓ │
│ archive │
└──────────────────────────────────────────────┘
sdd-riper-optimized/
├── README.md # 本文件
├── OPTIMIZATION_REPORT.md # v1.1.0 优化报告
├── skills/
│ ├── sdd-riper-one/ # 标准版 Skill
│ │ ├── SKILL.md # Skill 主定义
│ │ ├── README.md # 标准版说明
│ │ ├── CHANGELOG.md # 变更记录
│ │ ├── agents.md # Agent 配置说明
│ │ ├── agents/
│ │ │ └── openai.yaml # OpenAI Agent 配置
│ │ ├── references/
│ │ │ ├── sdd-riper-one-protocol.md # 完整协议
│ │ │ ├── spec-template.md # Spec 模板
│ │ │ ├── commands.md # 命令详细参数
│ │ │ ├── workflow-quickref.md # 工作流速查卡
│ │ │ ├── usage-examples.md # 实战示例
│ │ │ ├── multi-project.md # 多项目协作规则
│ │ │ └── archive-template.md # 归档模板
│ │ └── scripts/
│ │ └── archive_builder.py # 归档自动化脚本
│ └── sdd-riper-one-light/ # 轻量版 Skill
│ ├── SKILL.md # Skill 主定义
│ ├── README.md # 轻量版说明
│ ├── CHANGELOG.md # 变更记录
│ ├── agents/
│ │ └── openai.yaml # OpenAI Agent 配置
│ ├── references/
│ │ ├── spec-lite-template.md # 最小 spec 模板
│ │ ├── modules.md # 按需模块
│ │ └── conventions.md # 落盘目录与命名规则
│ └── examples/
│ ├── README.md # 示例说明
│ ├── specs/ # Spec 示例
│ └── codemap/ # CodeMap 示例
└── .gitignore
- 选标准版 — 如果你需要完整的阶段门禁、多项目协作、三轴评审，或者团队中有多种能力的模型混用。
- 选轻量版 — 如果你使用强模型（Claude Opus、GPT-5+），追求高频多轮迭代效率，信任模型的自主分解能力。
两个版本可以在同一项目中切换使用：小改用轻量版快速通道，大改切标准版走完整流程。
- 原始仓库：huisezhiyin/sdd-riper
- 优化版本：v1.1.0（详见 OPTIMIZATION_REPORT.md）
MIT