30 分钟快速体验

✅ 已上线 — Aiko Studio IDE 已可使用。本文用 aiko-sdd 仓库作为最小复刻路径，让你在公开仓库里跑通整条 SDD 流程。

完整产品里，第一步会从 Aiko Studio 选择一份已确认的 BRD / PRD，由 Workbench / SDD 面板按变更类型生成任务、设计与测试材料；公开体验版没有连接你的 Studio 实例，所以用手动起草需求材料来模拟这一步。

你将体验到

在完整产品里选择新功能、hotfix、日志与小调整，或 full 完整流程
从需求文档生成或起草 SDD 输入材料（vision / requirements / acceptance）
Workbench / SDD 面板生成开发任务、设计与测试证据骨架
跑 aiko.pipeline DoR → §1 impl → §2 tdd → §4 e2e → §5 evidence → ready
14 个 Validator 守门 + bulk-archive，并把归档结果沉淀给知识库

前置条件

macOS / Linux（Windows 用 WSL2）
Node.js ≥ 20.19
Git
已 clone aiko-sdd 仓库

1. 初始化（5 min）

cd aiko-sdd
./scripts/bootstrap-openspec.sh
./scripts/aiko-validate.sh

期望看到：

[aiko-validate OK] 全部 N 个 change 校验通过。

跑通 = 环境 OK。

2. 装 pre-commit hook（1 min）

pip install -r requirements-dev.txt
./scripts/install-pre-commit-hook.sh

之后每次 git commit 自动跑 aiko-validate，违规直接拒提交。

3. 起一个新 change（10 min）

在完整 IDE 中，你可以直接选择 Studio 里的 PRD 版本来生成这个 change。公开体验版手动建目录，效果等价于“从需求输入生成 SDD 骨架”。

按 5 档决策树选档位（这里选 s 档，单功能小改）：

# 在 IDE 里调 aiko-new-change Skill,或手动:
mkdir -p openspec/changes/add-coupon-discount-pd
# 起草 vision/stories/requirements/nfr/acceptance...

PD 包至少要写：

制品	写什么
`vision.md`	为什么做这个优惠券折扣
`requirements.md`	系统应做哪些功能（EARS 格式）
`acceptance.md`	怎样算达标（每条 ACC-* 引用 REQ-FN-*）

4. 生成 SDD 任务与测试材料（5 min）

# 完整产品：SDD 面板按变更类型生成设计 / 详细设计、开发任务、测试材料
# 公开体验：调 aiko-pd-to-test / aiko-pd-to-dev Skill 生成最小骨架

Workbench / SDD 面板会显示新生成的任务、设计 / 测试材料与 pipeline 状态。

5. 跑 dev pipeline（8 min）

./scripts/pipeline/init-pipeline.sh --change add-coupon-discount --demo coupon
./scripts/pipeline/advance-node.sh --change add-coupon-discount --to impl
# 让 Aiko Chat 按 spec 写代码
./scripts/pipeline/advance-node.sh --change add-coupon-discount --to tdd
# 让 Aiko Chat 写单测
./scripts/pipeline/advance-node.sh --change add-coupon-discount --to e2e_gen
# 按 test-cases 生成 E2E 脚本
./scripts/pipeline/advance-node.sh --change add-coupon-discount --to e2e_run
# 跑 E2E gate (L2)
./scripts/pipeline/advance-node.sh --change add-coupon-discount --to evidence
# 回填 test-evidence.md
./scripts/pipeline/advance-node.sh --change add-coupon-discount --to ready

每一步都会跑 pipeline-gate Validator，tasks § 与 node 不一致 → ERROR。

6. 校验 + 归档（2 min）

./scripts/aiko-validate.sh
# 14 个 Validator 全过

git commit -m "feat: coupon discount"
git push
# CI 跑同一套 validate + E2E + pipeline check

# main 上:
# 调 openspec-bulk-archive-change Skill
# delta merge 到 openspec/specs/,原 change 移到 changes/archive/

下一步

看核心概念理解 SDD 的任务、证据与 trace 闭环
看 Workbench / SDD 面板怎么用
看 Aiko Chat 怎么按 spec 写代码

30 分钟快速体验

On this page