mcpField
S
ship

ship

github.com/open-horizon-labs云与 DevOps3117 次安装12 周前更新
代码仓库

关于 ship

这项面向交付的技能指导已完成的工作从代码走向可验证的用户端安装，也可诊断停滞的交付流水线而不执行部署。

主要功能

  1. 01梳理交付路径
  2. 02评估交付环节的阻力
  3. 03触发并监控 CI/CD 工作流
  4. 04验证部署状态与用户访问
  5. 05转交发布后的发现

适用场景

  1. 01在评审和测试通过后交付已完成的工作
  2. 02诊断停滞流水线中的交付延迟
  3. 03确认部署变更正在运行且可访问

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/open-horizon-labs/skills --skill ship

安装后在 Claude Code 中输入/ship确认已加载。

附带文件agents/openai.yamlreferences/reality-contact.md

详细介绍

/ship

优化从工作完成到成功安装的交付路径。当执行成本低时，交付就是工作本身。

Ship 是执行阶段的最后一步。代码如果没有交到用户手中，就没有创造价值。

适用时机

当执行已完成、测试通过、评审结束，并且需要将变更交付给用户时，调用 /ship。也可单独用于诊断：对停滞的交付流水线运行 /ship，以发现交付路径成本，无需部署任何内容。

不要在以下情况下使用： 仍在开发中。Ship 适用于已完成的工作。

JIT 参考

仅当交付暴露出与预期不同的目标环境、用户行为、所有权问题或交付路径成本时，才加载 references/reality-contact.md。

Ship 流程

步骤 1：确定交付路径

梳理从代码到成功安装的路径：

“此变更的交付路径为：[本地] → [PR/评审] → [合并] → [CI/CD] → [预发布/生产] → [用户安装]。”

具体说明。列出每个步骤，以及负责该步骤的人或系统。

步骤 2：评估交付路径成本

交付路径成本是拖慢速度的阻力。找出各环节的时间损耗：评审队列、合并冲突/稳定性、门禁/扫描耗时（串行还是并行、是否不稳定）、审批瓶颈、部署时长、回滚准备情况，以及人工步骤。

步骤 3：执行 Ship
有 CI/CD 上下文时
  1. 引用流水线 — 指出具体的构建/部署配置
  2. 触发相应工作流 — 为 PR 添加标签、推送到部署分支等
  3. 监控流水线 — 留意失败情况并报告状态
  4. 验证部署 — 确认变更已上线
没有 CI/CD 上下文时
  1. 列出部署步骤 — 说明需要按什么顺序执行
  2. 执行每个步骤 — 或提供要执行的命令
  3. 验证每个阶段 — 确认成功后再继续
  4. 报告最终状态 — 确认面向用户的变更已上线
步骤 4：交付后验证

只有完成以下验证，交付才算完成：

  • 它在运行吗？ — 已部署并正在执行
  • 它能正常工作吗？ — 预期行为已实现
  • 用户能访问它吗？ — 用户可以访问/使用它
  • 是否交付了所承诺的特性？ — 已交付结果符合 /execute 中声明的成功标准
  • 实际情况是否符合预设？ — 用户/运维人员确实遇到了我们认为已解决的问题；隐藏约束或所有权问题已转交给合适的学习产物

必要时创建临时验证测试——关键在于获得信心，而非构建永久基础设施。验证应对应工作所声称的交付内容，而不仅是确认部署已完成。

Ship 仍以交付为重点：将验证失败或回滚经验转交给 /salvage；将更广泛的实际情况相关经验转交给 /aim、/problem-space、guardrails 或 metis。除非验证失败，否则不要重新开启已交付的工作。

输出格式

## Ship

### Ship Report

**Shipped:** [what was shipped]
**Target:** [where it was shipped to]
**Path:** [the delivery path taken]

### Delivery-Path Tax Identified
- [Friction point 1]: [time/effort cost]
- [Friction point 2]: [time/effort cost]

### Ship Actions Taken
1. [Action 1 - result]
2. [Action 2 - result]

### Verification
- [x] Deployed successfully
- [x] Running in target environment
- [x] User-facing functionality confirmed

### Delivered Characteristics Validation
- [x] [Declared criterion/characteristic 1]
- [ ] [Declared criterion/characteristic 2, if not yet verified]

### Reality Contact Check
- Frame match: [matched | partially matched | missed]
- Different problem encountered: [none | describe]
- Hidden constraints / ownership failures: [none | describe]
- Learning routed to: [`/salvage` | `/aim` | `/problem-space` | guardrail | metis | none]

### Recommendations
[Any suggestions for reducing delivery-path tax in future]

会话交接

如果正在使用会话文件，请替换或追加 ## Ship。保留交付路径成本、验证状态、已交付特性验证、实际情况相关结果以及经验转交路径。

评论

支持 Markdown