Files
.pouch/skills/delivery-loop/SKILL.md
T
laily af6e139d30 feat: rename bugfix-ship/requirement-flow to short-ship/long-ship with shared ship records
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.
2026-10-13 23:11:58 +08:00

1.9 KiB

name, description
name description
delivery-loop 为修复、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、测试与回归证据、产物摘要、部署 目标和回滚指针。若停在中间状态,明确下一步和阻塞原因。