30 分钟快速体验

🚧 预览 — 完整 Aiko IDE 安装包内测中。本文用 aiko-sdd 仓库作为最小复刻路径，让你在公开仓库里跑通整条 SDD 流程。

你将体验到

选 change-type 档位（5 档决策树）
起草 PD 包（vision / requirements / acceptance）
Workbench 生成 Test 包 + Dev 包骨架
跑 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）

按 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. 生成 Test 包 + Dev 包（5 min）

# 调 aiko-pd-to-test Skill: 自动生成 test-cases.md
# 调 aiko-pd-to-dev Skill:  自动生成 dev 包骨架(specs + tasks + aiko.pipeline)

Workbench 全景树会显示新生成的两个包，状态 draft。

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/