产品合同与体验

Asset

ADP-PLN-DOC-DOC-0005

Feature

work-item-types

领域

plane-core

文档状态

draft

文档 Owner

DOC

事实源

canonical-docs

更新

2026/10/14

类型与进度

Epic 不再是专用类型。Task、Bug 和普通 Issue 使用原生 Issue.state 表示唯一进度，状态定义的 progress_role 提供动作所需的语义。需求方案转由 OpenSpec 管理，Issue 负责实际工作、责任、依赖和交付。

新建省略 type 默认 Task，显式 null 创建普通 Issue；该默认只由创建边界解析，模型不得覆盖 null。Issue 与 DraftIssue 均允许无类型，草稿发布为 Issue 时保留其原 type/null。Task/Bug 类型选择只能接受当前活动目录，不能通过旧 Epic code、名字、模板、导入或 API 重新创建专用 Epic。原生状态、业务按钮、看板、列表和自动化使用相同服务端状态与权限规则。

保留业务按钮

Task 执行阶段使用单一“执行完成”按钮，替代“提交验收”和“标记阻塞”。点击仅二次询问“是否确认完成”，确认后进入专业验收，不要求填写交付证据。取消不产生写入。后续专业验收、测试/回归、打回、补充责任人、直接完成、强制完成、取消及适用关闭动作保留；已有证据与历史不改写。其他动作仍收集所需证据/原因并检查责任、CAS 和幂等；执行完成不取消人类验收决定。

自动化开启就是正式委托；Symphony 自动执行当前可执行工作，进入人工审核/验收后等待。打回且委托仍有效时自动返工。关闭开关撤销委托并保留已有交付。Agent 不能代签人类验收、强制完成或发布许可。

Bug 输入

Bug 创建/转换保留复现步骤、实际结果、期望结果、环境、版本和回归要求的结构化输入，服务端确定性合成 description。Bug 报告和补充说明页签保留未保存内容；创建后编辑最终 description。回归证据与关闭规则保留，但进度不能再存于独立 Bug status。

Properties、workflow 与 hierarchy

当前类型目录、property、workflow 和 hierarchy 继续由各自 owner 管理。父子关系不等于 Epic：任一允许的普通父项都不附带需求／方案阶段审批。类型切换不能逃逸已有审批或责任。

State.progress_role 是原生 State 的属性，不是 Issue 进度副本。完成时间和归档仍由原生状态组驱动，API 返回当前状态及命令版本，不从评论、标签或历史阶段推导替代真相。

OpenSpec 与 Issue

OpenSpec 保存需求、设计、任务拆解及变更依据；Issue 保存可执行工作和协作反馈。一个变更可以关联多个 Issue，父子和依赖由正常关系表达，不创建 Epic 影子类型或第二份审批台账。引用应固定到仓库、commit 和路径，不能只依赖可变文档链接。

Epic 退役与只读历史

存量 Epic 转无类型普通 Issue，保留 UUID、编号、父子/依赖、评论和交付链接。先完整归档原记录；Triage 保持人工接纳状态，原完成/取消保持终态角色，其余未完成进入 Todo/ready 并写明归档 activity。原需求、方案和审批记录只读归档，不提供继续、重做或重新请求旧阶段的入口。旧 Epic APIs、字段、菜单、业务按钮、计划关联和执行入口全部删除；历史链接只定位归档证据。

独立 Epic DraftIssue 草稿同样完整归档原 type/state/parent 等记录后转换为 type=null，保留 ID、parent 和正文；二进制内容以无损编码归档。归档保留来源与项目定位，无项目草稿不伪造原生状态。

历史审核

既有审核决定仍保留实际 actor、时间、原因、产物 identity 和 digest。归档不是重新批准，也不证明转换后的 Issue 已验收。新的需求方案不写旧 Epic 审批记录。

软件产品规格与交付计划

正式产品合同由 canonical docs 管理，变更需求方案使用 OpenSpec，并保留精确 Git 来源。Project Workspace 不复制候选正文；普通 Issue 和关系管理执行工作。旧 product_spec/delivery_plan Worker 和 Epic 计划物化路径退役，不把它们包装为新的普通 Issue 自动审批系统。

本轮不新增或扩写测试。本地验证：根据项目策略禁止执行。