参考
术语表
Aiko IDE / SDD 关键术语速查
角色与制品
| 术语 | 含义 |
|---|---|
| PD | 产品设计角色（Product Design），负责 PD 包 10 件制品 |
| Architect | 架构师角色，负责架构包 3 件制品 |
| Dev | 开发角色，负责 dev 包 4 件 + 跑 aiko.pipeline |
| Tester | 测试角色，负责 test 包 2 件 + L1-L4 测试分层 |
| PD 包 | 同一 group 下的 <feature>-pd/ 目录，含 10 件 PD 制品 |
| Arch 包 | <feature>-arch/ 含 3 件架构制品（m/l 档才有） |
| Test 包 | <feature>-test/ 含 test-cases + test-evidence |
| Dev 包 | <feature>/ 含 proposal + specs + design + tasks + aiko.pipeline |
change 与档位
| 术语 | 含义 |
|---|---|
| change | OpenSpec 下的一次原子变更单元，位于 openspec/changes/<name>/ |
| change-type | 5 档之一：xs / s / tech / m / l |
| xs | 1 天内完成的小改 |
| s | 单功能小改（默认档） |
| tech | 工程主导（重构 / 升级），跳过 PD 包 |
| m | 跨子模块 / 调 NFR / 引新能力 |
| l | 跨多业务线 / 战略级 |
| group | 把同一能力的 PD/Arch/Test/Dev 四包绑成一个原子单元的字段 |
| workflowProfile | 需求类型的完整编排（new-feature-s / defect-xs / …） |
| gitPath | Git 路径 profile（git-enterprise / git-saas-trunk / …） |
pipeline 与测试
| 术语 | 含义 |
|---|---|
| aiko.pipeline | dev 包的执行流水线状态机 |
| DoR | Definition of Ready，feature 拉出来前的就绪条件 |
| §1 impl | 实现 capability 节点 |
| §2 tdd | 单测节点（L1） |
| §3 e2e_gen | 按 test-cases 生成 E2E 脚本节点 |
| §4 e2e_run | 跑 E2E gate 节点（L2） |
| §5 evidence | 回填 test-evidence 节点（L4） |
| ready | 可归档节点 |
| advance-node | 唯一能写 pipeline node history 的脚本 |
| L1 | 单测层（单 API / 单规则） |
| L2 | 本 group ACC 链路 E2E |
| L3 | 多 feature 集成回归 |
| L4 | 正式发布证据 |
SSoT 与 ID 规范
| 术语 | 含义 |
|---|---|
| SSoT | Single Source of Truth，单一事实源准则 |
| VISION-* | vision.md 的事实 ID |
| GOAL-* | vision.md 的目标 ID |
| REQ-FN-* | requirements.md 的功能需求 ID |
| REQ-NFR-* | nfr.md 的非功能需求 ID |
| ACC-* | acceptance.md 的验收标准 ID |
| ARCH-* | architecture.md 的架构节点 ID |
| ADR-* | adr.md 的关键决策 ID |
| QA-* | quality-attributes.md 的 NFR 实现策略 ID |
| TC-* | test-cases.md 的测试用例 ID |
| EV-* | test-evidence.md 的证据 ID |
| GLOSS-* | glossary.md 的术语 ID |
| trace graph | 跨制品 ID 引用关系的有向图（自动生成） |
Validator 与 schema
| 术语 | 含义 |
|---|---|
| Validator | 机器化校验规则，14 个，本地 + CI 跑同一套 |
| matrix Validator | 档位×制品矩阵守门 |
| trace Validator | ID 引用必须存在 |
| ssot Validator | 事实归属准则守门 |
| pipeline-gate Validator | tasks § 与 node 一致性守门 |
| entity-schema Validator | 制品 yaml 块字段 type/tier/enum 守门 |
| dev-coverage Validator | PD 的 REQ-FN-* / ACC-* 须被 dev 包引用 |
| bundle-references Validator | group 单元的 references 与模板一致 |
| nfr-acceptance-coverage | NFR 引用的 ACC 必须存在 |
| ai-constraints Validator | AI 能力声明必须有 fallback / 禁公网 LLM |
| perf-budget Validator | 性能指标五字段 + 谓词方向 |
| scenario-quality Validator | Scenario GWT 结构 + 名不重复 |
| id-uniqueness Validator | 同 change 内 id 不重复 |
| language Validator | UTF-8 NFC |
| glossary-usage Validator | m/l 档 GLOSS 引用（INFO） |
| entity schema | 制品字段定义 yaml，位于 openspec/schemas/<lane>/entities/*.yaml |
| tier (core/extended/full) | entity schema field 的级别，随 change scale 联动 |
Aiko IDE 组件
| 术语 | 含义 |
|---|---|
| Aiko Workbench | IDE 内建的工作流面板，5 个 sidebar |
| Aiko Chat | IDE 内建的 AI Coding Agent |
| Plan Mode | Aiko Chat 写代码前先出 plan 让用户审批 |
| Recall Mode | Aiko Chat 基于 task node 的上下文检索机制 |
| Subagent | Aiko Chat 通过 Task 工具派发的子 agent |
| Diff Approval | 文件改动落地前的 unified diff 预览 |
| Permission Rules | settings.json 里的 allow/deny 规则 |
| YOLO Mode | 一键 auto-approve 所有 tool calls（ephemeral） |
| Custom Agent | .claude/agents/*.md 项目级或用户级 agent 定义 |
| Skill | AI 起草制品的标准操作剧本（aiko-pd-package / aiko-apply-dev 等） |
| Hook | shell 脚本，在 tool 调用 / pre-commit / session 事件触发 |
三层门禁
| 术语 | 含义 |
|---|---|
| 本地 pre-commit | git commit 时跑 aiko-validate + hygiene |
| Validator 引擎 | OpenSpec validate + Aiko 14 Validator |
| CI 门禁 | MR / push 时跑 validate + E2E + pipeline check |
| L0 硬检验 | validate 一跑就必须过 |
| L1 条件硬检验 | 按 schema / tier / group / 内容自动触发 |
| L2 流程门禁 | 挂在 merge 边的可编排 gate |
| bulk-archive | main 上把 ready-to-archive 的 group merge 进 openspec/specs/ |
关联阅读
- 核心概念 — 同样内容的解释版
- 19 制品 + entity schema
- 12 Validator