---
name: deliverable
description: 通用交付件概念规范——交付件定义、通用评审生命周期、与任务/仓库的关系、评审标准。agent 处理交付件时据此操作。产线可用同名 skill 覆盖。触发：提交/评审/驳回交付件，或提到交付物、产出物、评审。
capability: deliverable_capability
tools: [submit_deliverable, approve_deliverable, reject_deliverable, reopen_deliverable, list_deliverables, set_deliverable_state]
---

# 交付件（通用概念）

## 一、概念定义

交付件 = 任务产出的**可评审物**（代码、文档、配置、测试报告等）。
交付件是任务的直接产出，经评审（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 覆盖具体评审流程。