参考
术语表
SDD 与 Aiko IDE 常用术语速查
角色与入口
| 术语 | 含义 |
|---|---|
| Aiko Chat | IDE 内建 AI Coding Agent（执行层） |
| Aiko（opencode） | 默认 agent 后端，跨模型走 new-api 网关 |
| SDD 面板 | IDE 侧的结构化进度视图（需求/阶段条/进度/活动日志） |
| Studio | Aiko Studio 平台侧（BRD/PRD 协同与导出） |
规格与状态
| 术语 | 含义 |
|---|---|
| change | 一次开发任务，openspec/changes/<id>/（proposal/design/tasks/specs） |
| workflow | 工作流预设：full / spec / hotfix / tweak |
| phase | 阶段：open / design / build / verify / archive |
.aiko.yaml | change 的唯一权威状态文件（workflow/phase/requirement/各模式字段） |
| requirement | .aiko.yaml 里的需求归属键（sdd-input slug 或 chat） |
| delta spec | change 的 specs/<capability>/spec.md，归档时按 ADDED/MODIFIED/REMOVED 合并进主 spec |
| brainstorm 检查点 | .aiko/handoff/brainstorm-summary.md，设计确认前的草案挂点 |
| Design Doc / plan | Superpowers 设计产物（docs/superpowers/specs/ 与 docs/superpowers/plans/，仅 full） |
| verify-report | .aiko/verify-report.md，归档前的验证证据 |
| archive | change 目录移入 openspec/changes/archive/<date>-<id>/ 并合并 spec |
脚本与门禁
| 术语 | 含义 |
|---|---|
| aiko-state.sh | 状态机工具（init/set/transition/get/check/status/next），唯一写 .aiko.yaml 的入口 |
| aiko-guard.sh | 阶段过渡门禁（<change> <phase> --apply），校验齐才推进 |
| phase-guard | 写文件门禁（aiko-hook-guard.sh），按 phase 白名单放行/拦截 |
| 写后校验 | 每次 init/set/transition 后跑 aiko-yaml-validate.sh，坏文件当场失败 |
| mtime 管辖 | 多 change 并行时，源码写入由 mtime 最近的活跃 change 管辖 |
| sdd / vibe | 会话工作流模式（AIKO_SDD_MODE）：sdd 门禁生效，vibe 全放行；创建时定，不可中途切 |
| MARKER_VERSION | skill 资产版本标记，版本差触发 ~/.aiko/claude-auth 资产重拷 |
模型与工具
| 术语 | 含义 |
|---|---|
| new-api 网关 | 统一模型网关（对话模型 + 能力别名） |
| 能力别名 | image-recognition（识图）/ web_search（搜索）/ image-generation（生图） |
| effort（思考层级） | 支持模型的推理档位（各家枚举不同，见模型页） |
| modelContexts | aiko.newapi.modelContexts，各模型上下文/输出/effort 的本地 schema |
| hiddenModels | aiko.newapi.hiddenModels，按 id/glob 隐藏模型的列表 |
验证
| 术语 | 含义 |
|---|---|
| 确定性 e2e | test/manual/sdd-e2e/run-all.sh，无 LLM 的门禁/状态机/面板矩阵 |
| 真实 e2e | sddRealSdk.integrationTest.ts，真模型驱动完整流程（手动开启） |