Workbench / SDD 面板是什么、怎么用

打开 Aiko Studio IDE，你会在 Workbench 里用统一 SDD 面板管理变更类型、开发任务和证据归档

Workbench 是 Aiko Studio IDE 主界面的工作流面板。现在它的核心就是 SDD 面板：从 Studio 选择需求文档后，在同一个面板里决定本次变更类型、生成对应 SDD 任务、推进开发与测试，并把证据归档回知识库。

SDD 面板支持哪些变更

类型	适用场景	SDD 面板会生成什么
新功能	新增或改动用户可感知能力	需求 trace、开发任务、测试用例、证据回填
hotfix	线上紧急修复、回滚、阻断性 bug	最小修复任务、验证步骤、发布证据
日志与小调整	文案、日志、配置、小范围行为微调	轻量任务清单、变更说明、自测证据
full 完整流程	复杂需求、跨模块改动、需要评审的能力	设计、详细设计、开发任务、测试与归档证据

不同类型会自动决定要补齐多少设计和验证材料。小变更不被流程拖慢，full 流程则会把设计和详细设计补齐，避免复杂需求只靠一句 prompt 直接开写。

SDD 面板里你会看到什么

openspec/changes/
└── add-coupon-discount/
    ├── 📋 .openspec.yaml       type=new-feature, status=draft
    ├── ✅ prd.md               Studio 需求映射后的产品事实
    ├── ✅ architecture.md      full 流程才需要的设计 / 架构决策
    ├── 🔄 dev.md               方案、详细设计、任务清单
    ├── ✅ specs/coupon/spec.md 对外行为契约与场景
    └── ⏳ test.md              测试用例与证据对账表

图标含义：

图标	含义
✅	已就绪、validate 通过
⏳	进行中
🔄	pipeline 当前节点
⚪	这个档位不要求这件文档（不写也没事）
❌	validate 不通过

点任意一个文档名 → 在 SDD 面板中打开对应编辑器。

从 Studio 选择需求文档生成 SDD

完整 Aiko 链路里，Workbench 起手不是让你从空目录写需求。你先在 Studio 里把 BRD / PRD 写到可评审状态，再回到 IDE：

在 Workbench / SDD 面板点「从 Studio 导入」
选择项目、文档类型和具体文档版本（如某个已确认 PRD）
IDE 读取文档章节、实体字段、血缘锚点和资源目录
选择变更类型：新功能、hotfix、日志与小调整或 full 完整流程
SDD 面板生成本次 change 所需的设计、详细设计、任务和测试骨架
Aiko Chat 根据生成的 specs、dev.md 和 test.md 进入开发 pipeline

这样做的好处是：需求文档仍由 Studio 管理、评审和演进；IDE 只接管“把这份需求变成可验证开发任务”的部分，归档结果再回流给知识库。

起一个新 change

在 Aiko Chat 里：

> /aiko-new-change add-coupon-discount

走完向导后，SDD 面板立刻出现本次 change 的任务树，所需文档骨架已生成。你接下来逐个补齐，或让 Aiko Chat 先起草再人工确认。

类型自动联动

.openspec.yaml 里的类型字段决定 SDD 面板要打开哪些材料：

类型	你会看到
新功能	需求 trace、行为契约、开发任务、测试证据
hotfix	问题定位、最小修复方案、验证证据、发布记录
日志与小调整	轻量任务、变更说明、自测记录
full 完整流程	设计、详细设计、行为契约、开发任务、测试与归档证据

详细矩阵看怎么选档。

编辑器里能干啥

SDD 面板里的编辑器自带：

Spec Card 渲染：yaml 块自动渲染成可视化卡片
PlantUML / Mermaid 预览：内嵌图块实时渲染
字段类型校验：按 entity schema 校 type / required / enum
ID 自动补全：打 ACC- 弹出 acceptance.md 已存在的 ID 列表
跨文档跳转：Cmd / Ctrl 点击 ID 跳到主笔文档
实时 diff 校验：与远端 specs/ 对比看差异
hover 看上游：鼠标悬停 ID 显示主笔文档的对应段落

工作流模板：让 profile 替你管

如果同类需求经常出现，可以在 openspec/config.yaml 里写 workflowProfile：

aiko:
  workflowProfiles:
    new-feature-s:
      tier: s
      packages: [pd, test, dev]
      gates: [validate, l2-e2e, ci]

起新 change 时挂 workflowProfile: new-feature-s，全部默认选好。

分支怎么走：gitPath

gitPath 决定你的代码分支怎么流转，跟工作流 profile 正交：

profile	分支路径	适合
`git-enterprise`（默认）	feature → develop → release → main	企业内部
`git-saas-trunk`	feature → main	SaaS 快速 trunk
`git-simple`	feature → develop → main	无 release
`git-hotfix`	hotfix → release → main	紧急修复

接下来去哪

想了解 change 类型 → 怎么给你的 change 选档
想看开发推进 → 推进开发任务到 ready
想理解 Chat 如何执行 → Aiko Chat 总览

Workbench / SDD 面板是什么、怎么用

On this page