chore: sync pouch skill workflows
This commit is contained in:
@@ -23,7 +23,8 @@
|
||||
|
||||
## Agent 会做什么
|
||||
|
||||
建立 ship 记录,写短需求说明,改代码并验证,再继续完成配置允许的交付阶段。一次交付一个 ship id。
|
||||
主会话只建 ship 记录、写短说明、按步骤开新 agent 并等待结果。改代码、测试、开合 PR、
|
||||
构建和部署都在新会话里做,不会堆进同一个上下文。一次交付一个 ship id。
|
||||
|
||||
## 如何判断完成
|
||||
|
||||
|
||||
+23
-23
@@ -8,7 +8,8 @@ description: >-
|
||||
|
||||
# Short Ship:单次变更到交付
|
||||
|
||||
把一次范围清楚的改动推进到项目配置允许的停止点。
|
||||
当前会话只做管理:建账本、问用户、按 `next_step.py` 开新 agent 并等待。不要把
|
||||
hunt / 改代码 / 测试 / 交付读进本会话。
|
||||
|
||||
## 何时使用
|
||||
|
||||
@@ -24,36 +25,35 @@ description: >-
|
||||
|
||||
## 工作规则
|
||||
|
||||
1. 读取已安装的 `ship` skill。没有 `ship-id` 就从需求生成候选 slug,用
|
||||
`scripts/create_ship.py --kind short` 建 `.pouch/ship/<id>/`;已有目录则校验后复用。
|
||||
写 `spec.md` 四段:要做什么、不做什么、可观察验收、怎么验。有故障证据时加复现和根因。
|
||||
任务保持恰好 1 条。功能任务不要写入 `.pouch/ack/tasks.yaml`。
|
||||
2. 有故障证据时使用 `hunt` 确认根因、复现和验收信号。纯小需求跳过 hunt。
|
||||
3. 修改代码并补或更新回归用例;行为、API、图片、UI 改动不得只跑编译。
|
||||
4. 使用 `tester` 做黑盒、浏览器或真机验证;涉及资源加载时检查真实 URL、状态、类型、
|
||||
内容和截图。跑完立刻用 ship `append_evidence.py --kind testRun` 追加指针。
|
||||
5. 读取并执行 `delivery-loop`。停止点由用户或项目 delivery profile 决定,canonical
|
||||
为 `verified`、`validation_ready`、`review_ready` 或 `released`。每个完成阶段都要把
|
||||
对应指针写入该 ship 的 `current.yaml`;缺指针则阶段未完成。需要产物时只调用
|
||||
builder `obtain.sh --sha <merged-or-pushed-commit>`。
|
||||
6. 范围涨到需要 PRD 或多条任务时,同一 `ship-id` 把 `kind` 改为 `long`,交给
|
||||
`long-ship`,不要另开 id。
|
||||
1. 读取已安装 ship 的 [manager.md](../ship/references/manager.md)。派发 worker 时再读
|
||||
[worker-prompt.md](../ship/references/worker-prompt.md)。没有 `ship-id` 就生成
|
||||
slug,跑 `create_ship.py --kind short`。功能任务不要写入 `.pouch/ack/tasks.yaml`。
|
||||
2. 主会话只写 `spec.md` 四段和那一条 task。有故障证据时 `next_step.py` 会给出
|
||||
`hunt` worker,不要在本会话读 hunt。
|
||||
3. 之后只跑:
|
||||
|
||||
```bash
|
||||
python3 <ship-skill>/scripts/next_step.py \
|
||||
--project-root <root> --ship-id <id> --entry short
|
||||
```
|
||||
|
||||
`actor: worker` 就开新 agent 并等待;`ask_user` / `blocked` 就停下来问用户。
|
||||
需要字段含义时再读 [record.md](../ship/references/record.md)。
|
||||
4. 范围涨到需要 PRD 或多条任务时,同一 `ship-id` 把 `kind` 改为 `long`,改用
|
||||
`--entry long`。
|
||||
|
||||
不要读取 `delivery-loop`、`tester`、`builder`、`deployer`、`check`、`hunt`。
|
||||
这些由对应 worker 按 JSON 的 `skill` 加载。
|
||||
|
||||
## 安全门
|
||||
|
||||
- 没有 ship-id、spec.md 四段不齐、验收不可观察时停止。
|
||||
- 开不出新 agent 时停止;worker 失败时不要自己把该步做完。
|
||||
- 根因不清、测试缺失、真机不可达、CI/回归失败或工作树有无关改动时停止并说明。
|
||||
- 不强推、不覆盖他人分支、不绕过 PR 审核,不把测试环境成功当生产成功。
|
||||
- 数据迁移、破坏性 API、权限/密钥、安全修复和不可逆生产操作需要额外确认。
|
||||
|
||||
## 必读资料
|
||||
|
||||
- 记录格式:已安装的 `ship` skill 与 `references/record.md`。
|
||||
- 交付阶段:已安装的 `delivery-loop` 及其状态机 reference。
|
||||
- 测试、构建、部署、提交前审查:项目的 `tester`、`builder`、`deployer`、`check`、
|
||||
`releaser`。
|
||||
|
||||
## 完成报告
|
||||
|
||||
报告 ship id、spec 路径、根因(若有)、变更、测试/真机证据指针、停止点、commit、
|
||||
PR/tag、产物摘要、部署状态和未完成项。
|
||||
PR/tag、产物摘要、部署状态和未完成项。数字来自账本,不要复述 worker 技能正文。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
interface:
|
||||
display_name: "Short Ship"
|
||||
short_description: "Ship a small change or bug fix through verification and delivery"
|
||||
default_prompt: "Use $short-ship to implement this small change, verify it, and continue to the configured delivery stop."
|
||||
default_prompt: "You are the short-ship manager: keep the ship record, spawn a fresh agent for each next_step, and wait. Do not hunt, code, test, or deliver in this session."
|
||||
policy:
|
||||
allow_implicit_invocation: true
|
||||
|
||||
Reference in New Issue
Block a user