建立通知插件流程

簡介

這個 skill 會引導您建立包含三個作業系統版本的通知插件（Windows、macOS、Linux）。

重要：你必須嚴格按照以下步驟順序執行，不可跳過任何步驟。

執行步驟

1. 收集插件資訊

第一步：你必須立即使用 AskUserQuestion tool 一次性收集所有必要資訊。

使用以下格式向用戶詢問：

必須詢問的問題清單：

1. 插件 ID（問題：「請輸入插件 ID（英文識別名稱，例如：mario、my-sound）」）

   • header: "插件 ID"
   • 提供選項建議，但允許用戶自訂

2. 插件名稱（問題：「請輸入插件顯示名稱（例如：瑪利歐音效、我的音效）」）

   • header: "插件名稱"
   • 提供選項建議，但允許用戶自訂

3. 作者名稱（問題：「請輸入作者名稱」）

   • header: "作者名稱"
   • 提供選項：預設值 "Lucas Yang" 或自訂

4. 作者 Email（問題：「請輸入作者 Email」）

   • header: "作者 Email"
   • 提供選項：預設值 "yangchenshin77@gmail.com" 或自訂

5. notification.wav 音檔路徑（問題：「請輸入 notification.wav 音檔的完整路徑」）

   • header: "通知音檔"
   • 說明：當 Claude Code 執行結束時播放
   • 提供常見路徑建議或自訂

6. stop.wav 音檔路徑（問題：「請輸入 stop.wav 音檔的完整路徑」）

   • header: "停止音檔"
   • 說明：當 Claude Code 被停止時播放
   • 提供常見路徑建議或自訂

注意：

• 插件描述已固定為「當 Claude Code 執行結束或停止時，自動播放提示音通知用戶」
• 你必須等待用戶回答所有問題後才能繼續下一步

2. 驗證音檔路徑

第二步：你必須使用 Bash tool 驗證用戶提供的音檔路徑是否存在。

執行以下命令（將

{notificationAudioPath}

和

{stopAudioPath}

替換為用戶提供的實際路徑）：

test -f "{notificationAudioPath}" && echo "✅ Notification audio exists" || echo "❌ Notification audio NOT found"
test -f "{stopAudioPath}" && echo "✅ Stop audio exists" || echo "❌ Stop audio NOT found"

重要檢查點：

• 如果任何一個音檔不存在，你必須：

  1. 停止執行
  2. 向用戶顯示錯誤訊息，明確指出哪個音檔不存在
  3. 請用戶檢查路徑並重新執行 skill
  4. 不可繼續執行後續步驟

• 只有兩個音檔都存在時，才能繼續下一步

3. 執行 Node.js 腳本建立插件

第三步：你必須使用 Bash tool 執行 Node.js 腳本來建立插件。

執行命令格式：

node scripts/create-notification-plugin.js \
  --id "{id}" \
  --name "{name}" \
  --author-name "{authorName}" \
  --author-email "{authorEmail}" \
  --notification-audio "{notificationAudioPath}" \
  --stop-audio "{stopAudioPath}"

重要說明：

• 將所有

  {...}

  佔位符替換為步驟 1 收集到的實際值
• 腳本路徑位於

  scripts/create-notification-plugin.js

• 如果作者名稱或 Email 用戶選擇使用預設值，仍然要傳遞參數
• 必須等待腳本執行完成後才能繼續下一步
• 如果腳本執行失敗，向用戶顯示錯誤訊息並停止執行

4. 顯示建立結果

第四步：解析腳本輸出並向用戶顯示完整的建立結果。

腳本執行成功後，你必須向用戶清楚地顯示：

1. 已建立的插件目錄（通常會有三個）：

   • plugins/{id}-win

   • plugins/{id}-mac

   • plugins/{id}-linux

2. 已更新的檔案：

   • .claude-plugin/marketplace.json

   • README.md

3. 安裝指令（提供三個平台的安裝命令）：

   • /plugin install {id}-win@ycs77-notifications

   • /plugin install {id}-mac@ycs77-notifications

   • /plugin install {id}-linux@ycs77-notifications

顯示格式範例：

✅ 插件建立成功！

已建立的插件：
  - plugins/{id}-win
  - plugins/{id}-mac
  - plugins/{id}-linux

已更新的檔案：
  - .claude-plugin/marketplace.json
  - README.md

安裝指令（根據您的作業系統選擇）：
  Windows: /plugin install {id}-win@ycs77-notifications
  macOS:   /plugin install {id}-mac@ycs77-notifications
  Linux:   /plugin install {id}-linux@ycs77-notifications

重要提示

執行限制：

• 插件 ID 應使用小寫字母和連字符，例如

  my-sound

• 音檔必須是 WAV 格式
• 腳本會自動更新

  .claude-plugin/marketplace.json

  和

  README.md

• 如果插件目錄已存在，腳本會自動覆蓋（有警告訊息）

故障排除：

• 如果步驟 3 沒有執行，請確認音檔驗證通過
• 如果腳本執行失敗，檢查錯誤訊息並向用戶說明問題