前言¶

做個股或策略跟蹤時，條件往往寫在腦子裏或散落在對話裏：跌幅到某個比例要通知、財報前要再看一眼、榜單異動要推送。若只靠通用日曆或手寫 cron，很難和行情、選股、XS 腳本綁在一起；每次改條件還要自己拼接口和鑑權。

下面介紹 SkillHub 上的 到時候提醒我（@user_d83d7c97/wm-reminder）。它把「研究提醒」收成一套 Agent 可執行的 action，覆蓋列表、創建、更新、啓停等操作，並支持個股、選股、榜單以及自定義 XS；XS 場景下通過 call 模式的 return 控制是否推送。需要說明的是：這是提醒產品的技能說明，不是獨立調度引擎的文檔。

這是什麼¶

到時候提醒我 是面向 WinMale / 贏麻了提醒能力的 SkillHub 技能（社區來源，座標 @user_d83d7c97/wm-reminder，當前版本 0.2.7）。SkillHub 分類爲 professional，標籤標明 requires_api_key=false；頁面統計爲評分 100000、下載 1968 次（以 SkillHub 展示爲準）。

技能在宿主側以 reminder.* 爲能力入口；Agent 通過統一門面調用，而不是自行拼 HTTP。manifest 中作者爲「贏麻了官方」，SkillHub 頁面展示作者爲 Eliaszhou。

核心功能¶

適用對話場景¶

技能說明中列出的典型意圖包括：

• 「我有哪些提醒」
• 「跌幅到 5% 提醒我」「財報前看茅臺」
• 「用一段 XS 自定義提醒條件」

與兄弟技能的分工¶

下列情況不要用本技能，避免和別的 wm 技能搶職責：

Action 一覽¶

manifest.json 中 inputs_schema 還支持 limit（默認 20，最大 50）、sub_id、update、create 等字段。

創建時的 type¶

自定義邏輯優先 type=xs，並遵循 notify 協議 技能包內的 references/notify-protocol.md。調度仍依賴 push_control.push_time 或事件；沒有獨立的 earnings_window 引擎（舊字段僅作文案提示）。

XS Call Notify 協議（v1）¶

type=xs 在調度觸發時以 call 模式執行，頂層 return 決定是否推送：

return MAP{
  "v": 1,
  "notify": true|false,   // 必填：false=記 run 不推；true=推送
  "title": "...",
  "body": "...",
  "payload": { ... }      // 可選，兼容選股 ScreeningPayload
}

若無 notify 鍵但仍有 JSON(result) DataView，可走舊選股摘要推送；pr_stock / strategy_screening / 榜單類型不走本協議。PushControl（免打擾、日限、間隔）由服務端兜底。

權限與回執約定¶

• 讀操作需要 user:reminder:read；創建/更新/啓停需要 user:reminder:write；手動觸發需要 user:reminder:execute（技能默認不代用戶 trigger）。
• 運行技能本身還需要 analysis:skills:run（見 manifest required_scopes）。
• 若返回 SCOPE_DENIED，響應體含 grant_url（console?appId=&action=scopes&scope=）。對人只貼鏈接並說明「授權後重新換 token」，不要長篇口述控制台路徑。
• 列表/創建/get 回執含 deeplinks（id=reminder → https://app.winmale.com/profile/subscriptions）。對人原樣貼 deeplinks[].markdown（已帶 wmToken）；禁止手搓 /subscription、/reminders 等舊路徑。

技能明確禁止：默認 trigger、代配 push_channel 密鑰、缺權限時口述控制台路徑、手搓提醒落地 URL。

安裝與啓用¶

通過 SkillHub CLI 安裝¶

先確認本機是否已有 CLI（完整步驟見 SkillHub 安裝文檔）：

command -v skillhub && skillhub --version

安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別：

skillhub install @user_d83d7c97/wm-reminder --dir ~/.cursor/skills/

各客戶端常用路徑（摘自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可按 SkillHub 頁面提示，讓 AI 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_d83d7c97/wm-reminder。

調用方式¶

技能要求優先使用統一門面 wm.sh run，禁止手搓 curl 或自行拼鑑權 HTTP。示例路徑爲 Cursor 下的 wm-skillhub 腳本（需已安裝對應宿主技能）：

bash .cursor/skills/wm-skillhub/scripts/wm.sh run wm-reminder \
  '{"action":"list"}' --result

包裝參數時，可將 args 放在第二參，例如 examples/request.json：

{
  "args": { "action": "list", "limit": 20 }
}

典型用法¶

1. 列出提醒¶

對 Agent 說「看看我有哪些提醒」，或執行：

bash .cursor/skills/wm-skillhub/scripts/wm.sh run wm-reminder \
  '{"args":{"action":"list","limit":20}}' --result

回執中的 items 與 quota、以及 deeplinks 用於跳轉訂閱管理。

2. 創建 XS 類提醒¶

技能文檔中的創建示例（名稱與腳本內容按你的研究場景替換）：

{
  "args": {
    "action": "create",
    "create": {
      "name": "PCB 跌 5%",
      "type": "xs",
      "script_content": "return MAP{\"v\":1,\"notify\":true,\"title\":\"跌幅觸發\",\"body\":\"…\"}"
    }
  }
}

更復雜的條件可在 XS 裏先計算再 return，例如協議文檔中的模式：條件滿足時 notify: true，否則 notify: false 僅記錄 run。

3. 創建前校驗（宿主 eval）¶

若你在 XS 環境直接調宿主，可先 reminder.validate 再 create（菜譜見技能包 references/recipes.md）。測試探針應使用 notify: false，避免刷推送渠道。

4. 管理已有提醒¶

對指定 sub_id 使用 get、update、enable、cancel。update 的 patch 不要整份 create spec 原樣塞入；type / catalog / symbol 等爲 create 專用字段。

刪除、runs / push_logs、經用戶確認後的 trigger 等未全部封裝在技能 action 內，需按菜譜經確認後用 eval 調宿主，並具備對應 scope。

適用場景與注意¶

適合誰：已在 WinMale / 贏麻了體系內做研究跟蹤、希望用自然語言或 Agent 維護提醒列表與 XS 條件、且能接受 OAuth scope 與 wm.sh 統一調用的用戶。

限制與坑：

• 本技能不替代調度引擎文檔；推送時間、事件與 PushControl 仍在服務端。
• 與自選分組、盤中開關、即時行情卡片分工明確，選錯技能會繞遠路。
• 無權限時依賴 grant_url，不要口述冗長控制台步驟。
• 渠道密鑰屬於 push_channel.*，本技能禁止代配。

結尾¶

到時候提醒我 把研究提醒從「口頭約定」收成可列表、可創建、可啓停的產品操作，並在 type=xs 時用 return 協議精確控制是否推送。若你在 Cursor 等環境裏已配置 SkillHub 與 wm-skillhub，安裝後即可用對話或 wm.sh run 管理提醒。

• SkillHub 頁面：https://www.skillhub.cn/skills/user_d83d7c97/wm-reminder
• 技能 API 座標：https://api.skillhub.cn/user_d83d7c97/wm-reminder
• 安裝說明：https://skillhub.cn/install/skillhub.md