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:
+16
-17
@@ -1,26 +1,25 @@
|
||||
# long-ship
|
||||
# long-ship(已弃用)
|
||||
|
||||
把复杂需求从 PRD 评审、任务拆分、协作开发推进到集成回归和配置允许的发布部署。
|
||||
`long-ship` 已并入 [ship](../ship/README.md)。本目录只是兼容占位,
|
||||
让旧项目里的 `.pouch.yaml`、已经装好的旧软链和旧说法不至于失效;真正的说明和流程都在
|
||||
`ship/`。命中后按 **long 模式** 执行。
|
||||
|
||||
## 什么时候使用
|
||||
## 使用示例
|
||||
|
||||
```text
|
||||
把动态编辑需求做成 PRD,批准后拆任务开发,最后完整回归并部署测试环境。
|
||||
使用 long-ship,把动态编辑需求做成 PRD,批准后拆任务开发。
|
||||
```
|
||||
|
||||
## 使用前准备
|
||||
Agent 命中后会立刻转到 `ship`,按 long 模式执行。新请求建议直接用 `ship`,需要时可写
|
||||
`long 模式`。
|
||||
|
||||
- 同时安装 `ship`、`specifier` 和 `delivery-loop`。
|
||||
- 需求目标和相关项目上下文。
|
||||
- 用户愿意评审并明确批准某个 PRD 版本。
|
||||
- 项目已配置测试环境和需要的构建/部署能力。
|
||||
## 迁移
|
||||
|
||||
## Agent 会做什么
|
||||
```bash
|
||||
pouch add ship # 新名,当前项目
|
||||
pouch add ship -g # 新名,全局
|
||||
```
|
||||
|
||||
主会话只建 ship 记录、让你批 PRD、按步骤开新 agent 并等待。写 PRD、改代码、验证和
|
||||
交付都在新会话里做。同一 ship id 串起任务和证据。
|
||||
集成回归会先发现父仓库及子项目的 tester catalog,逐个测试根执行并分别记录快照,不会因父仓库没有 catalog 而跳过 `app` 等子项目;项目 profile 或 `.pouch/ack/project.md` 声明的原生测试套件也必须逐项执行并记录证据。
|
||||
|
||||
## 如何判断完成
|
||||
|
||||
你会得到 ship id、PRD 版本、任务与依赖、各任务验证、集成回归、最终 PR/合并、产物和部署证据。
|
||||
- 旧软链保持有效,不需要先删除。
|
||||
- 各项目 `.pouch.yaml` 里的 `long-ship` 可以分批改成 `ship`。
|
||||
- 确认没有项目再按旧名启用后,删除本目录即可;它是纯占位,删除不丢内容。
|
||||
|
||||
Reference in New Issue
Block a user