Skip to content
Back to skills

Notification Writing

ASecurity

告警、任务提醒、成功/失败/阻塞通知与未送达补偿的表达规范:每条通知用「发生了什么、影响谁、现在谁做什么、不做会怎样」四要素,接受回执不等于交付。触发:"通知怎么写 / 告警文案 / 任务提醒 / 成功通知 / 失败通知 / 阻塞通知 / 未送达 / 通知回执 / alert / notification"。

  • 8 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsnode

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add webkubor/writing-standard-skills --skill notification-writing --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Notification Writing?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Notification Writing
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/webkubor-notification-writing/badge)](https://www.skillsdirectory.com/skills/webkubor-notification-writing)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: notification-writing
version: "1.0.0"
description: 告警、任务提醒、成功/失败/阻塞通知与未送达补偿的表达规范:每条通知用「发生了什么、影响谁、现在谁做什么、不做会怎样」四要素,接受回执不等于交付。触发:"通知怎么写 / 告警文案 / 任务提醒 / 成功通知 / 失败通知 / 阻塞通知 / 未送达 / 通知回执 / alert / notification"。
---

# 通知与告警表达

## 适用范围

适用于主动推送给人看的告警、任务提醒、恢复通知、成功/失败/阻塞回执,以及通知失败后的补偿说明。它只管文字是否能让人行动;触发阈值、去重、升级、审批和通道实现由使用方自己的流程负责。

## 核心判据

一条通知要能回答四件事,缺一项就先补信息再发:

1 **发生了什么**:一句人话,不只放哈希、键名或错误码。
2 **影响谁**:写业务、系统或时间后果,不只重复现象。
3 **现在谁做什么**:给可执行动作、命令或链接。
4 **不做会怎样**:写后果、截止时间或影响范围。

### 严重级别

- 🔴 **需要动作**:不处理会继续扩大或造成明确损失。
- 🟡 **需要知道**:有变化或风险,但暂不强制立即操作。
- 🟢 **已恢复**:状态已经收口,写清恢复依据。

分不进三档的内容不作为告警推送;改写成日报、任务记录或状态说明。

## 四要素模板

```text
<级别> <一句人话结论> · <状态或时效>
· 影响:<谁/什么受影响,影响多久>
· 现在:<接收者> <具体动作、命令或链接>
· 不做:<后果或截止时间>
· 溯源:<对象、时间、记录入口>
```

“现在”必须能直接执行。没有动作的通知往往不该推给 owner,应该进入日报或任务记录。

## 成功、失败、阻塞模板

### 成功

```text
🟢 已完成:<结果>
· 影响:<用户或系统现在能做什么>
· 现在:<查看/使用入口;无需动作则写“无”>
· 不做:<无>
· 溯源:<验证命令、产物、提交或版本入口>
```

成功通知只写已经验证的结果。代码提交、任务关闭、构建通过、部署完成、业务验收是不同层级,不能在一个“成功”里混报。

### 失败

```text
🔴 未完成:<失败点>
· 影响:<哪项能力不可用、谁受影响>
· 现在:<失败后的重试、回滚或交接动作>
· 不做:<影响会持续多久>
· 溯源:<错误原文、日志、退出码或请求记录>
```

失败回执要保留原始错误摘要,不只写“失败了”。错误来自哪个主体也要写清,避免把宿主报错误当成项目报错。

### 阻塞

```text
⏸ 已阻塞:<卡点>
· 影响:<当前不能推进什么>
· 现在:<需要谁补充材料、授权或决定]
· 不做:<卡住的时间与后果]
· 溯源:<证明阻塞的命令、输出或任务记录>
```

只有五类必停项可以升级为拍板项:花钱、删生产数据、对外发布、凭据变更、项目方向。其他阻塞写交接、补料、重试或挂单动作。

## 未送达补偿

通知没有送达时,不把“已尝试”写成“已通知”。补偿说明写清四点:原目标、失败原因、当前可用入口、下一步补送或人工确认。多个通道只写实际读回过的状态;没有读回就写“未知”。

```text
🟡 通知未确认送达:<目标>
· 原因:<通道错误、超时或回执缺失>
· 影响:<接收者尚未看到什么>
· 现在:<可用入口或补送动作>
· 不做:<可能错过什么>
```

**接受回执不等于交付。** “消息已接受”“接口返回成功”“有人点了接受”只证明某一步被接收,不证明任务完成、发布成功或业务验收通过。交付结论仍按 `task-reporting` 的三段证据写。

## 反例与正例

### ❌ 反例:只有指标,没有动作

> `node_release_mismatch: a315eab80bd3 != 5ff5b43b00b5`

读者看不出两个值是什么关系、谁要做什么、不做会怎样。

### ✅ 正例:四要素齐全

> 🔴 执行器仍是旧版本,落后目标版本一个发布 · 持续 1 天
> · 影响:自动任务仍运行旧逻辑,错误率可能继续上升
> · 现在:运行部署更新并读回版本
> · 不做:旧逻辑继续处理新任务
> · 溯源:版本读回与部署记录

### ❌ 反例:成功回执冒充交付

> 接口返回 200,任务已完成,可以放心使用。

HTTP 200 只证明请求被接受,不证明功能正确或用户可见结果正确。

### ✅ 正例:区分接受与结果

> 🟢 已完成:接口已接受请求;部署版本读回为 `v2.5.0`,核心测试通过。业务验收尚未执行。

## 与流程机制的边界

- 告警触发、去重键、升级策略、审批、订阅和通道路由属于流程或系统机制;本 skill 只写四要素、级别和状态措辞。
- 触达 owner 的通道选择属于流程。本 skill 只写措辞,路由按使用方自己的规则;不在通知正文里假设具体渠道一定可达。
- 汇报格式以 `task-reporting` 为准;`executive-briefing` 只叠加 `✅/⏸` 与拍板项。
- 停手/上报只认五类必停项:花钱、删生产数据、对外发布、凭据变更、项目方向。

## 自检清单

- [ ] 发生了什么用一句人话写清了吗?
- [ ] 影响写的是后果,不是只重复现象吗?
- [ ] “现在”是可执行动作、命令或链接吗?
- [ ] 不做会怎样有具体后果或截止时间吗?
- [ ] 级别是否属于需要动作、需要知道、已恢复三档?
- [ ] 成功、失败、阻塞是否分别写了证据和下一步?
- [ ] 未送达是否保留失败原因和补送入口?
- [ ] 是否没有把接受回执写成交付完成?
- [ ] 五类必停项以外的内容是否没有被升级成拍板项?
- [ ] 通知能否让第一次读的人直接判断优先级?

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.