req-outcome
上线后对照 intake 写下的预期效果收集证据,判断是否达成;没达成就写清差距和下一步;只有拿到证据才关闭需求。Use after the observation window of a shipped requirement, when someone asks 这个需求效果怎么样 / 可以关了吗, or before closing a work item.
SKILL.mdstacks/req-tpm/skills/req-outcome/SKILL.md
GitHub效果验收(req-outcome)
需求的终点是效果,不是上线。我们只在证据对上 intake 的预期效果之后关闭需求。
1. 取回预期效果
lark-cli docs +fetch --as user --doc <URL> --keyword "预期效果" --context-after 3
读出每一行的指标、基线、目标、测法、观察窗口。观察窗口没到,就只记中期读数,不下结论。
2. 按原测法取数
用 intake 写的同一个测法、同一个口径取数,自己复算一次。换了口径要写明,并说明为什么。不允许用「感觉好多了」「用户反馈不错」代替指标;定性反馈可以附上,但不算达成证据。
3. 逐条判定
| 预期 | 基线 | 目标 | 实测(来源) | 结论 |
|---|---|---|---|---|
| ... | ... | ... | ...(看板链接/查询) | 达成 / 未达成 / 无法判断 |
- 未达成:写差距、可能原因(带证据)、下一步(继续优化 / 新需求 / 接受现状),下一步要有人和时间。
- 无法判断:通常是没埋点或口径变了,写清缺什么,回到
req-ship补可观测性。
4. 写回并关闭
把表格写进「9. 效果验收」。
全部达成,或提出人和负责人书面接受了未达成项,才推进到关闭状态(命令同 req-ship 第 3 节)。未达成且有后续时,在工作项评论里写下一步和新需求链接:
meegle comment add --project-key <PK> --work-item-id <ID> --content "<验收结论 + 文档链接>"
输出
验收表、结论、关闭与否;没关闭时写下一次验收时间。
用到的命令
先确认身份和空间(每个会话一次):
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。