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
-22
@@ -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`。
|
||||
- 确认没有项目再按旧名启用后,删除本目录即可;它是纯占位,删除不丢内容。
|
||||
|
||||
Reference in New Issue
Block a user