# ship

把一次变更从说明推进到配置允许的 PR、合并、构建或部署。范围清楚的小改动直接做；复杂需求先评审 PRD，再拆任务交付。

## 什么时候使用

```text
给列表页加一个导出按钮，测完后发 PR。
```

或：

```text
用 ship long 模式处理动态编辑需求：先做 PRD，批准后拆任务开发，最后完整回归并部署测试环境。
```

用户可以在任务里写 `short 模式` 或 `long 模式`。没写时 Agent 先自己判断，判断不了再问；默认 short。

## 使用前准备

- 同时安装 `delivery-loop`。复杂需求还要安装 `specifier`。
- 目标已经说清，或有可复现的问题描述、截图、日志；复杂需求需要相关项目上下文。
- 项目已配置测试环境和所需 builder/tester/deployer 能力。
- 若要外部发布，明确允许的停止点或使用项目 profile。

## Agent 会做什么

主会话只判定 short/long、建 ship 记录、按步骤开新 agent 并等待结果。改代码、写 PRD、测试、
开合 PR、构建和部署都在新会话里做，不会堆进同一个上下文。一次交付一个 ship id。
`kind: long` 的集成回归会发现父仓库及子项目的 tester catalog，并执行项目声明的原生测试套件。

## 如何判断完成

你会得到 ship id、说明或 PRD、测试证据、PR/合并/tag、产物和部署状态；不会只收到“本地测试通过”。