# Notification Preferences

> Notification Preferences is an Agent Skill for apps & automation published in the B-M-Capital-Research/honeclaw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

管理当前用户的市场事件推送偏好,把中文自然语言映射到 notification_prefs 工具

- Skill name: `Notification Preferences`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/B-M-Capital-Research/honeclaw/blob/HEAD/skills/notification_preferences/SKILL.md
- Repository: B-M-Capital-Research/honeclaw (742 GitHub stars when collected)

## SKILL.md

## 职责

管理当前 actor(也只能是当前 actor——工具在构造时已绑定身份)对市场事件推送的个人偏好。

## 合法 kind tag

`allow_kinds` / `block_kinds` 的值必须从以下里选,其它值会被工具直接拒绝:

```
earnings_upcoming, earnings_released, earnings_call_transcript,
news_critical,
price_alert, weekly52_high, weekly52_low,
dividend, split,
sec_filing, analyst_grade,
macro_event, social_post
```

## 常见意图 → 工具调用

| 用户说法 | 调用 |
|---------|------|
| "先别推了" / "静音" | `notification_prefs(action="disable")` |
| "恢复推送" / "开回来" | `notification_prefs(action="enable")` |
| "只看重要的" | `notification_prefs(action="set_min_severity", value="high")` |
| "一般的也推吧" | `notification_prefs(action="set_min_severity", value="medium")` |
| "只推我持仓相关的" | `notification_prefs(action="set_portfolio_only", value=true)` |
| "什么都推" | `notification_prefs(action="set_portfolio_only", value=false)` |
| "不要新闻 / 不要分析师评级" | `notification_prefs(action="block_kinds", value=["news_critical","analyst_grade"])` |
| "只要财报和 SEC" | `notification_prefs(action="allow_kinds", value=["earnings_released","earnings_upcoming","sec_filing"])` |
| "别再限制 kind 了" | `notification_prefs(action="clear_allow")` 或 `clear_block` |
| "看看现在是什么设置" | `notification_prefs(action="get")` |
| "全部恢复默认" | `notification_prefs(action="reset")` |

## 工作流

1. 对非 `get` / `reset` 的改动,先调一次 `get` 看当前状态,避免误覆盖。
2. 应用对应 action。一次对话里可以连续调多个 action(例如先 `set_min_severity` 再 `block_kinds`)。
3. 用返回的 `prefs` 字段给用户复述生效后的设置,确认是否还有需要调整的。

## 注意

- 用户一次说"只要财报",`allow_kinds` 的数组里需要包含 `earnings_upcoming` **和** `earnings_released`——两者是不同的 kind,只填一个会漏。
- `block_kinds` 优先级高于 `allow_kinds`。如果用户之前设过白名单,之后 block 一个重叠的 kind 也会生效。
- 全局(部署方)可能在 `config.yaml` 里把某个 kind 关了——那类事件无论如何都不会推给任何人,即使用户把它放进 `allow_kinds`。这条解释给用户,不要误以为是工具问题。
- 用户没说"所有人"、"全局"时,不要尝试改别人的配置——本工具构造时已硬绑定到当前用户,也没有这个能力。

---

Source: https://www.openparable.com/skill/apps-automation/notification-preferences (OpenParable). Cite the canonical URL above.
