入门
30 分钟快速体验
从需求到归档的一条最小 SDD 路径（spec 工作流）
✅ 已上线 — Aiko IDE 已可使用。本文用 spec 工作流走一条最小路径：起 change → 写规格 → 构建 → 验证 → 归档。
完整产品里，第一步通常是从 Aiko Studio 选择一份已确认的 PRD（SDD 面板「选择文档」落盘）；没有接 Studio 时，直接在会话里描述需求也可以，流程相同。
你将体验到
- 用
/aiko-spec起一个 spec change（open → build → verify → archive） - phase-guard 在各阶段放行/拦截写操作
.aiko.yaml状态随aiko-state.sh/aiko-guard.sh推进- tasks 勾选、验证报告、归档移动
前置条件
- Aiko IDE（开发版或正式版均可）
- 一个 git 工作区
- 已登录 Aiko（agent 走 new-api 网关）
1. 起 change（5 min）
新会话选 Claude 或 Aiko，发起 /aiko-spec，描述需求（或先选好 PRD 文档）。agent 会先跑：
aiko-state.sh init add-greeting spec <requirement-slug>.aiko.yaml 一步落盘：workflow=spec、phase=open、requirement 归属。
2. 写 open 产物（10 min）
agent 继续产出完整 OpenSpec 产物（此时 phase-guard 只放行规格文件，写源码会被拦）：
proposal.md— 动机 + 目标 + 范围design.md— 设计落点（复杂时它会问你要不要详细设计，走 brainstorming 讨论后写回「详细设计」章节）tasks.md— 业务任务清单specs/— delta spec
写完它会问你一次：TDD 要不要？代码审查要不要？（build 入口的两个可选决策）
3. 推进到构建（5 min）
aiko-guard.sh add-greeting open --apply # phase: build门禁检查 proposal/tasks 非空后放行源码。agent 按 design.md + tasks.md 实现，逐项勾选（你会看到面板进度 N/M）。
4. 验证与归档（10 min）
aiko-guard.sh add-greeting build --apply # phase: verify（要求 tasks 全勾 + 构建通过）
# 产出 .aiko/verify-report.md，set verification_report + branch_status handled
aiko-guard.sh add-greeting verify --apply # phase: archive（要求报告在 + verify_result: pass）
# change 目录移入 openspec/changes/archive/，delta spec 合并进主 spec