---
name: delivery-workflow-integration
description: Nucleus V2 approved-write 交付 workflow evidence finalizer。用于聚合已完成的 step result evidence，生成 final evidence report 和最终 result package；不调度全链路、不回写 PMS、不创建 PR/MR。
---

# Delivery Workflow Integration

本 Skill 只做 approved-write evidence integration finalizer。它读取目标仓库中的 `.nucleus/context/<workflowRunId>.json`、`.nucleus/runs/<workflowRunId>/integration/integration-manifest.json` 和每个 step 的稳定 result evidence copy，然后写：

- `.nucleus/runs/<workflowRunId>/integration/final-evidence-report.json`
- `.nucleus/runs/<workflowRunId>/integration/final-evidence-report.md`
- `.nucleus/runs/<workflowRunId>/result.json`

## 边界

- 不实现完整 Workflow Engine，不自动调度其他 Skill。
- 不写 `docs/requirement/**`，不回写 PMS，不创建 PR/MR，不 commit/push。
- Step result 必须位于 `.nucleus/runs/<workflowRunId>/integration/steps/*-result.json`，不得直接复用 `.nucleus/runs/<workflowRunId>/result.json`。
- 所有 referenced paths 必须位于 `.nucleus/runs/<workflowRunId>/**` 或 `.nucleus/tests/<workflowRunId>/**`。
- `.autocode/**`、`.claude/notepads/**`、`docs/bugfix/**`、absolute path、`..`、other-run path、symlink output escape 均阻塞。
- 任一 required step `FAILED_BLOCKED` 或 blocking gate failed/blocked，最终 status 为 `FAILED_BLOCKED`；否则 approved-write 固定 `NEEDS_HUMAN_REVIEW`。

## 人审前子代理预审

每个 integration review / approval 点请求人工确认前，必须按对应 `subagentPreReview` 调度独立 reviewer 子代理；未取得“材料可提交人工审查”预审结论时，不得请求人工评审通过。

## Runtime

```bash
python3 skills/delivery-workflow-integration/scripts/delivery_workflow_integration.py finalize \
  --repo-root <target-repo> \
  --context <target-repo>/.nucleus/context/<workflowRunId>.json \
  --manifest <target-repo>/.nucleus/runs/<workflowRunId>/integration/integration-manifest.json
```

runtime 只依赖随 `skills/` 分发的 `_shared/nucleus_runtime`、本 Skill `assets/` 和 `references/`，不得 import 根目录 `harness/`。
