Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
custom-notify — Claude Code 通知系統
透過 Telegram 或 Discord 接收 Claude Code 的重要事件通知。
指令
/notify init — 初始化設定
引導使用者建立通知設定檔。詢問使用者要啟用哪些頻道（可多選）。
Telegram 設定步驟：
- 請使用者提供 Telegram Bot Token（從 @BotFather 取得）
- 請使用者提供 Chat ID（可用 @userinfobot 取得）
Discord 設定步驟：
- 請使用者提供 Discord Webhook URL（從 Discord 頻道設定 → 整合 → Webhook 取得）
設定檔範例 ~/.config/claude-notify/config.json：
{
"channels": {
"telegram": {
"enabled": true,
"bot_token": "<使用者提供的 token>",
"chat_id": "<使用者提供的 chat_id>"
},
"discord": {
"enabled": true,
"webhook_url": "<使用者提供的 webhook URL>"
}
},
"events": {
"task_complete": true,
"task_failed": true,
"needs_input": true,
"tool_rejected": true
}
}建立完成後，自動執行 /notify test 驗證連線。
注意：
- 確保目錄存在：
mkdir -p ~/.config/claude-notify - 如果使用者只要其中一個頻道，另一個設
"enabled": false或不寫即可 - 如果已有設定檔，詢問是否要新增頻道或覆蓋
/notify test — 測試連線
執行以下命令發送測試訊息：
node "<skill_path>/scripts/notify.js" --test- 成功：告知使用者「測試訊息已發送，請檢查通知頻道」
- 失敗：顯示錯誤訊息並協助排查
/notify <訊息> — 手動發送通知
當使用者輸入 /notify 後面接任何文字時，發送該文字作為通知：
node "<skill_path>/scripts/notify.js" --manual --message "<使用者的訊息>"範例：
/notify 部署完成，請來檢查/notify 測試全部通過
/notify config — 查看目前設定
讀取並顯示 ~/.config/claude-notify/config.json 的內容（隱藏 bottoken 和 webhookurl 的中間部分）。
/notify toggle <event> — 開關事件通知
修改 ~/.config/claude-notify/config.json 中的 events 設定。
可用的 event 名稱：
task_complete— 任務完成通知task_failed— 工具執行失敗通知needs_input— 需要使用者決策通知tool_rejected— 工具被拒絕通知
範例： /notify toggle task_complete — 切換任務完成通知的開關狀態
自動通知
npx skills 只安裝本 skill，不會安裝 Claude Code plugin。自動通知由 `custom-skills-notify` plugin 處理，監聽以下 Claude Code hook 事件：
| 事件 | 觸發時機 |
|---|---|
Notification | 需要權限、閒置提示、需要回答問題 |
Stop | Claude 完成回應 |
PostToolUseFailure | 工具執行失敗 |
需要自動通知時，另外執行：
claude plugin marketplace add https://github.com/ValorVie/custom-skills.git
claude plugin install custom-skills-notify@custom-skills這個 plugin 安裝是獨立操作，不屬於 npx skills add 的結果。
腳本路徑
通知腳本位於：<skill_path>/scripts/notify.js
使用 <skill_path> 代表此 skill 的根目錄路徑。在執行命令時，用實際的絕對路徑替換。
