Inbox Emit

Inbox Emit Skill（原子）

Pipeline 所有关键节点的 inbox 写入单一入口： 向 _backlog.yml 目标 CR 条目追加 notify-log 事件，并更新 notify-pending 列表。 原子职责：只写 inbox 记录，不负责外部通知触达（邮件/IM/推送等由 pipeline 外部 handler 订阅）。

触发意图

不直接由用户触发，由各 pipeline / 原子 Skill 在关键节点调用：

• review-requirement 完成 → event=requirement-reviewing
• approve-requirement 完成 → event=requirement-approved
• review-tech-design 完成 → event=tech-design-review-pending
• approve-tech-design 完成 → event=tech-design-reviewed
• approve-dev-start 完成 → event=developing
• review-code 完成 → event=code-reviewing
• approve-code 完成 → event=code-approved
• cr-review-record 拒绝或撤回 → event=rejected / event=withdrawn
• cr-archive 完成 → event=archived
• feedback-writeback 完成 → event=feedback-writeback-done
• cr-sla-watchdog.pipeline → event=overdue

读取契约（启动序）

1. 读 AGENTS.md、dir-graph.yaml
2. 读 change-requests/_backlog.yml — 定位目标 CR 条目
3. 读 change-requests/_config.yml — 取 SLA 阈值（仅 event=overdue 时需要）

输入参数

| 参数 | 必填 | 说明 | |---|---|---| | cr-id | 是 | 例 CR-2026-001 | | event | 是 | requirement-reviewing \| requirement-approved \| tech-design-review-pending \| tech-design-reviewed \| developing \| code-reviewing \| code-approved \| rejected \| withdrawn \| archived \| feedback-writeback-done \| overdue | | to | 是 | 收件人列表，例 ["umasuo", "reviewer-2"] | | payload | 否 | 附加 JSON 信息，例 { "decision": "approve", "notes": "..." } |

操作步骤

1. 在 _backlog.yml 目标 CR 条目中追加 notify-log 条目：

```yaml notify-log:

• at: "YYYY-MM-DDTHH:mm:ss+HH:mm" # ISO8601 带时分秒和时区，例 2026-05-05T14:30:00+08:00

event: {event} to: {to} payload: {payload} handled: false ```

1. 将 to 列表合并进 notify-pending（已在列表中的不重复添加）
2. Commit：[cr] inbox-emit {CR-ID} event={event} to={to}

不做

• 不计算谁该收到通知（调用方 pipeline 负责传入 to）
• 不订阅事件（外部 handler 自行订阅 notify-log 变更）
• 不发送邮件/IM/推送（外部集成层职责）
• 不校验 to 列表中的用户是否存在

幂等性

同一 cr-id + event + at 组合若重复调用，追加独立的 notify-log 条目（不去重）， 上层 handler 负责判断 handled: false 的条目是否已处理。

输出

• _backlog.yml 目标 CR 的 notify-log 追加新条目
• notify-pending 更新（合并新收件人）

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xinyiai0724
• Source: xinyiai0724/tools
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.