req-ship

上线前做就绪检查(回滚方案、可观测性、完成定义 DoD),全部有证据后再推进 Meegle 状态或节点。Use before a requirement is deployed or marked done, when someone says 可以上线了吗 / 准备发布, or before transitioning the work item to a released state.

SKILL.md

GitHub

上线就绪(req-ship)

「代码合了」不等于「可以上线」,更不等于「需求完成」。这一步把上线前必须有的东西逐条对证据,缺一条就不推进状态。

1. 就绪清单

项 要的证据 缺了怎么办
完成定义(DoD) design 里的检查点逐条打勾,附 PR、测试输出链接 回 design 或实施
回滚方案 具体操作(回退版本号、开关名、命令)和谁有权限执行 写出来再上
可观测性 能看到 intake 预期效果指标的看板或查询,上线前截一次基线 先补埋点,否则 outcome 无法验收
影响面通知 波及面里列的人或团队已知会(链接) 提出人去通知
发布窗口 时间、负责人 和负责人对齐

证据看真实输出:CI 是在最终提交上跑的吗?测试有没有被过滤跳过?

2. 写回文档

把清单和证据写进「8. 上线记录」。

3. 推进 Meegle

先查这个工作项是状态流还是节点流、当前能去哪里、需要什么必填项:

# 状态流
meegle workflow list-state-transitions --project-key <PK> --work-item-id <ID> --format json
meegle workflow list-state-required --project-key <PK> --work-item-id <ID> --state-key <目标状态 key> --format json
meegle workflow transition-state --project-key <PK> --work-item-id <ID> --transition-id <transition_id>

# 节点流
meegle workflow get-node --project-key <PK> --work-item-id <ID> --format json
meegle workflow transition --project-key <PK> --work-item-id <ID> --node-id <节点 key> --action confirm

list-state-required 默认返回全部必填项;加 --mode unfinished 只看还没填的。

流转前把命令和目标状态给提出人看,确认后执行;流转后用 workitem get 读回状态。

注意:推进到「已上线」不是「已完成」。关闭留给 req-outcome。

输出

就绪清单(每项:通过/缺失 + 证据链接)、执行了哪条流转命令及读回的状态、上线时截的基线。

用到的命令

先确认身份和空间(每个会话一次):

meegle project search --project-key "<空间名或 key>" --format json
meegle workitem meta-types --project-key <PK> --format json
lark-cli docs +fetch --as user --doc <需求文档 URL> --scope outline

字段 key、状态 key、transition_id 一律现查,不要凭记忆填,见 templates/meegle-field-mapping.md。