# Inbox Emit

> Inbox Emit（原子）

- **Type:** Skill
- **Install:** `agentstack add skill-xinyiai0724-tools-inbox-emit`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xinyiai0724](https://agentstack.voostack.com/s/xinyiai0724)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [xinyiai0724](https://github.com/xinyiai0724)
- **Source:** https://github.com/xinyiai0724/tools/tree/main/skills/cr/inbox-emit

## Install

```sh
agentstack add skill-xinyiai0724-tools-inbox-emit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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
   ```
2. 将 `to` 列表合并进 `notify-pending`（已在列表中的不重复添加）
3. 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](https://github.com/xinyiai0724)
- **Source:** [xinyiai0724/tools](https://github.com/xinyiai0724/tools)
- **License:** Apache-2.0

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xinyiai0724-tools-inbox-emit
- Seller: https://agentstack.voostack.com/s/xinyiai0724
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.