feat(ship): merge short-ship and long-ship into one entry

Promote ship to the user-facing delivery skill. Kind is short or long
from an explicit mode, then self-judgment, then a question, defaulting
to short. Old names remain deprecation stubs.
This commit is contained in:
2026-10-24 14:27:19 +08:00
parent 7d6f3fe8e5
commit a15a046e4e
33 changed files with 331 additions and 315 deletions
+16 -22
View File
@@ -1,31 +1,25 @@
# short-ship
# short-ship(已弃用)
把一次范围清楚的改动(小功能、文案、已确认的 bug)从说明推进到配置允许的 PR、合并或部署。
`short-ship` 已并入 [ship](../ship/README.md)。本目录只是兼容占位,
让旧项目里的 `.pouch.yaml`、已经装好的旧软链和旧说法不至于失效;真正的说明和流程都在
`ship/`。命中后按 **short 模式** 执行。
## 什么时候使用
## 使用示例
```text
给列表页加一个导出按钮,测完后发 PR。
使用 short-ship,给列表页加一个导出按钮,测完后发 PR。
```
或:
Agent 命中后会立刻转到 `ship`,按 short 模式执行。新请求建议直接用 `ship`,需要时可写
`short 模式`。
```text
修复这个线上回归,完整验证并部署到测试环境。
## 迁移
```bash
pouch add ship # 新名,当前项目
pouch add ship -g # 新名,全局
```
## 使用前准备
- 同时安装 `ship`(记录格式)和 `delivery-loop`。
- 目标已经说清,或有可复现的问题描述、截图、日志。
- 项目已配置测试环境和所需 builder/tester/deployer 能力。
- 若要外部发布,明确允许的停止点或使用项目 profile。
## Agent 会做什么
主会话只建 ship 记录、写短说明、按步骤开新 agent 并等待结果。改代码、测试、开合 PR、
构建和部署都在新会话里做,不会堆进同一个上下文。一次交付一个 ship id。
## 如何判断完成
你会得到 ship id、说明、测试证据、PR/合并/tag、产物和部署状态;不会只收到“本地测试通过”。
- 旧软链保持有效,不需要先删除。
- 各项目 `.pouch.yaml` 里的 `short-ship` 可以分批改成 `ship`。
- 确认没有项目再按旧名启用后,删除本目录即可;它是纯占位,删除不丢内容。