agent-notifier

Agent Notifier 技能

为 AI 编码 Agent 提供确定性、由钩子驱动的通知。Agent 需要输入或完成任务时，绝不错过。

原因

基于大模型的“完成时播放声音”提示词并不可靠——上下文压缩会丢弃这些提示词，而且模型对“完成”的判断并不一致。此技能使用各平台的钩子系统，确保通知触发。

前提条件

• Python 3（仅使用标准库，无外部依赖）
• 至少一个受支持的 AI Agent 平台

支持的平台

平台	钩子事件
Claude Code	Notification（idle_prompt、permission_prompt）
GitHub Copilot CLI	sessionEnd、postToolUse
Cursor	stop、afterFileEdit
Codex	agent-turn-complete
Aider	--notifications-command
OpenCode	session.idle（插件）

快速开始

# Interactive setup — detects platforms, configures channels, installs hooks
python3 skills/agent-notifier/setup.py

Copilot CLI 用户

Copilot CLI 从项目的 .github/hooks/ 目录加载钩子（不支持全局钩子）。请在每个需要通知的项目中创建钩子文件：

mkdir -p .github/hooks
cat > .github/hooks/agent-notifier.json << 'EOF'
{
  "version": 1,
  "hooks": {
    "sessionEnd": [
      {"type": "command", "bash": "python3 $HOME/.claude/skills/agent-notifier/notify.py"}
    ],
    "postToolUse": [
      {"type": "command", "bash": "python3 $HOME/.claude/skills/agent-notifier/notify.py"}
    ]
  }
}
EOF

OpenCode 用户

OpenCode 使用 JavaScript 插件系统。将插件复制到你的插件目录：

mkdir -p ~/.config/opencode/plugins
cp skills/agent-notifier/opencode-plugin.js ~/.config/opencode/plugins/agent-notifier.js

手动使用

# Test with simulated Claude Code event
echo '{"notification_type":"idle_prompt","message":"Waiting for input"}' | python3 skills/agent-notifier/notify.py

# Test with simulated OpenCode event
echo '{"platform":"opencode","event_type":"session.idle","message":"Session completed"}' | python3 skills/agent-notifier/notify.py

# Test with command-line args (Aider style)
python3 skills/agent-notifier/notify.py "Task completed"

通知渠道

渠道	默认状态	要求
声音	已启用	macOS（afplay）或 Linux（paplay/aplay）
macOS 通知	已启用	仅限 macOS
Telegram	已禁用	Bot token + Chat ID
电子邮件	已禁用	SMTP 凭据
Slack	已禁用	Incoming Webhook URL
Discord	已禁用	Webhook URL
钉钉	已禁用	Webhook URL + 可选 Secret

配置

配置文件按以下顺序查找：

1. ~/.claude/notify-config.json
2. skills/agent-notifier/notify-config.json（模板）

运行 python3 skills/agent-notifier/setup.py 进行交互式配置，或直接编辑 JSON 文件。

输出

通知会并发发送到所有已启用的渠道。单个渠道的失败会记录到 stderr，不会影响其他渠道。