laily
af6e139d30
short-ship and long-ship share one ship-id record under .pouch/ship/<id>/. specifier writes PRDs into spec/; delivery-loop appends evidence pointers. Old names stay as deprecation stubs so existing installs keep working.
36 lines
1.9 KiB
Markdown
36 lines
1.9 KiB
Markdown
---
|
|
name: delivery-loop
|
|
description: >-
|
|
为修复、PR 和需求任务提供可配置的验证、发 PR、合并、回归、构建、发布与部署状态机。
|
|
仅作为 short-ship、pr-ship、long-ship 的共享执行规则使用。
|
|
---
|
|
|
|
# Delivery Loop：共享交付状态机
|
|
|
|
这是三个交付入口共用的内部规则，不直接替用户选择生产发布，也不替项目保存环境事实。
|
|
|
|
## 使用方式
|
|
|
|
只有在入口 skill 明确要求执行交付时才读取
|
|
`references/state-machine.md`。入口 skill 负责确定任务类型和目标；本 skill 负责阶段、
|
|
停止点、证据和安全门。
|
|
|
|
## 不可违反的规则
|
|
|
|
- 复用现有 `hunt`、`tester`、`check`、`builder`、`deployer`、`releaser` 和
|
|
`orchestration` 能力；不要在本 skill 里复制它们的实现。`artifact_built` 只调用
|
|
builder `obtain.sh`，不要在本 skill 里 poll GitLab/GitHub。
|
|
- 先读取项目的 delivery profile、分支策略和当前工作树，再决定可执行的停止点。
|
|
- `stopAt` 未配置或与用户目标冲突时停止并报告缺口，不猜测是否应合并或部署。
|
|
- 提交、推送、合并、打 tag、发布产物和生产部署都必须同时满足项目配置与当前请求的授权。
|
|
- 不绕过审核、CI、测试失败、脏工作树、冲突、未确认的迁移或不可回滚的外部变更。
|
|
- 每个阶段都保存可复核证据；没有证据不得把阶段标为完成。入口已绑定 `ship-id` 时，把
|
|
指针写入 `.pouch/ship/<id>/current.yaml` 的 `evidence`（规则见 ship `record.md`）；
|
|
缺指针则该阶段未完成。
|
|
- 失败时保留现场和回滚信息，不用重试掩盖失败，不伪造发布或部署成功。
|
|
|
|
## 结果
|
|
|
|
完成时返回状态机最终状态、停止点、变更 commit、PR/tag、测试与回归证据、产物摘要、部署
|
|
目标和回滚指针。若停在中间状态，明确下一步和阻塞原因。
|