Workbench 是什么、怎么用

打开 Aiko IDE 你会看到 5 个垂直 sidebar —— 每个对应一个角色和一组文档

Workbench 是 Aiko IDE 主界面的工作流面板。打开 IDE 你第一眼就能看到左侧栏有 5 个 sidebar，每个对应一组角色和文档。

Sidebar	你是谁就开这个	在这里写哪些文档
全景 (Panorama)	全员通用	不写文档，看本次 change 的全部产物 / 当前状态
PD	产品 / BA	10 件 PD 制品（vision / requirements / acceptance 等）
架构 (Architect)	架构师	3 件架构制品（architecture / adr / quality-attributes）
开发 (Dev)	开发	4 件 dev 制品（proposal / specs / design / tasks）
测试 (Tester)	QA	2 件 test 制品（test-cases / test-evidence）

每个 sidebar 是独立面板，互不打扰；不需要的角色可以折叠隐藏。

全景树（Panorama）：你打开 IDE 第一眼看到的

openspec/changes/
└── add-coupon-discount/
    ├── 📋 .openspec.yaml         change-type=s, group=coupon, status=draft
    ├── 📦 add-coupon-discount-pd/        ← PD 包 (10 件)
    │   ├── ✅ vision.md
    │   ├── ✅ stories.md
    │   ├── ✅ requirements.md
    │   ├── ✅ nfr.md
    │   ├── ✅ acceptance.md
    │   ├── ⚪ product-design.md     (s 档可选)
    │   ├── ⚪ risks.md
    │   ├── ✅ rollout.md
    │   ├── ✅ glossary.md
    │   └── ⚪ ai-spec.md            (无 AI 能力声明,可跳)
    ├── 📦 add-coupon-discount-test/      ← Test 包 (2 件)
    │   ├── ✅ test-cases.md
    │   └── ⏳ test-evidence.md      (§5 才回填)
    └── 📦 add-coupon-discount/           ← Dev 包 (4 件 + pipeline)
        ├── ✅ proposal.md
        ├── ✅ specs/coupon-discount.md
        ├── ✅ design.md
        ├── ⏳ tasks.md              (按 pipeline 推进)
        └── 🔄 aiko.pipeline.yaml    (node=impl)

图标含义：

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

点任意一个文档名 → 跳到对应 sidebar 的编辑器。

起一个新 change

在 Aiko Chat 里：

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

走完选档向导后，Workbench 全景树立刻出现一棵新树，所有矩阵要求的文档骨架已生成（空内容）。你接下来逐个填。

档位自动联动

.openspec.yaml 里 change-type 字段决定每个 sidebar 要写哪些文档：

档位	你会看到
xs	PD 只显示 requirements/acceptance 两个高亮，其他灰
s	PD 高亮 vision/stories/requirements/acceptance/rollout/glossary，架构隐藏
tech	PD 隐藏，架构高亮全部 3 件
m	全部高亮，nfr / risks / quality-attributes 都是必填
l	全部高亮 + 触发额外评审

详细矩阵看怎么选档。

编辑器里能干啥

每个 sidebar 打开的 MDX 编辑器自带：

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	紧急修复