2.0 KiB
2.0 KiB
| name | description | capability | tools | ||||||
|---|---|---|---|---|---|---|---|---|---|
| deliverable | 通用交付件概念规范——交付件定义、通用评审生命周期、与任务/仓库的关系、评审标准。agent 处理交付件时据此操作。产线可用同名 skill 覆盖。触发：提交/评审/驳回交付件，或提到交付物、产出物、评审。 | deliverable_capability |
|
交付件（通用概念）
一、概念定义
交付件 = 任务产出的可评审物（代码、文档、配置、测试报告等）。 交付件是任务的直接产出，经评审（approved/rejected）后才算任务完成。
二、通用生命周期（评审状态）
| 状态 | 语义 |
|---|---|
| pending | 待评审 |
| approved | 评审通过 |
| rejected | 评审驳回 |
通用流转：pending → approved / rejected。驳回后修改重新提交回 pending。
三、与其他概念的关系
- 交付件挂项目（project_id）+ 可选任务（task_id）。
- 交付件类型（deliverable_type）：code / doc / config / test-report 等。
- 交付件可关联仓库（repo_name）+ 仓库内路径（target_path）。
- 交付件评审状态（review_status）与任务状态（task.state 的 review/approved）联动。
四、评审标准（通用）
- 满足对应阶段的需求/设计规格。
- 代码交付件：可编译、可运行、规范合规。
- 文档交付件：结构完整、无歧义。
- 评审附意见（review_comment），驳回时意见必填。
五、配套能力（工具）
已固化的 deliverable 能力（deliverable_capability）：
submit_deliverable / approve_deliverable / reject_deliverable / reopen_deliverable / list_deliverables / set_deliverable_state（CAS 兜底）。
状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。
六、分层覆盖
本 skill 是通用交付件概念规范；产线可用同名 deliverable skill 覆盖具体评审流程。