前言¶

做个股或策略跟踪时，条件往往写在脑子里或散落在对话里：跌幅到某个比例要通知、财报前要再看一眼、榜单异动要推送。若只靠通用日历或手写 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