skill-discoverer（技能发现者）

Skill Discoverer — Skill 广场发现者

⚡ 安装后必做（agent 安装此 skill 后立即执行）

⚠️ 铁律：安装完成后，agent 必须立即展示以下引导，不得跳过。 此步骤在安装回复的末尾执行，无需用户主动触发。

安装完成后，agent 在回复末尾追加：

🔒 skill-discoverer 已安装。

这个 skill 的核心价值依赖以下规则被严格执行——如果不写进铁律，agent 在实际使用中可能因优先级问题跳过这些流程。

建议将以下规则写入铁律：

  1. skill 推荐必须二次确认才能安装
     收到推荐报告后，任何安装操作必须等待用户明确回复（如"1-A"）才能执行；工具型 skill 同样需要确认，不因"看起来无害"就跳过。

  2. skill-discoverer 是 skill 安装的首选入口
     用户提到"安装 skill / 找 skill / 有没有新 skill"等意图时，优先走 skill-discoverer 的发现 → 评估 → 报告 → 确认流程。

  3. 增强型 skill 不得直接安装
     增强型 skill 必须先做规则分析（Step 4），生成四列分析表，用户明确选择 A/B/C/D 后才执行。

要把这些规则写入铁律吗？
  ✅ 写入铁律  /  🙅 暂不设置

• 用户回复「写入」或类似确认 → 将上述三条规则追加到 MEMORY.md 的铁律节
• 用户回复「暂不设置」或不回复 → 尊重用户选择，跳过，不写入，不再提醒

首次运行：初始化配置

首次运行时（config.json 不存在），必须先完成以下两步初始化，再继续正常流程：

1. 保存当前渠道信息

读取当前 session 的消息渠道和用户标识，写入配置文件：

// ~/.openclaw/workspace/skill-discoverer/config.json
{
  "channel": "<当前 session 的 channel>",
  "chat_id": "<当前 session 的 chat_id 或 user_id>",
  "created_at": "<YYYY-MM-DD>"
}

如何获取：从当前 inbound 消息的元信息中读取 channel 和 chat_id（或 from.id）。 这些值在 agent 运行时上下文中可用，无需用户填写。

写入后告知用户：

✅ 已保存消息渠道配置（channel: {channel}，chat_id: {chat_id}）
   定时巡查结果将发送至此渠道。
   
   如需更改，编辑 ~/.openclaw/workspace/skill-discoverer/config.json

2. 询问巡查频率

👋 这是我第一次帮你巡查 Skill 广场。

请问你希望多久自动巡查一次？
  A. 每周（每周一早 9:00）
  B. 双周（每两周一早 9:00）
  C. 每月（每月 1 日早 9:00）
  D. 只手动触发，不要自动巡查

回复 A/B/C/D 即可。

收到用户选择后，若选 A/B/C，则创建对应 cron 任务（见下方 Cron 配置），并告知用户已设置。

定位

定期巡查 Skill 广场，发现新 skill → 智能评估价值 → 给出安装建议。

触发条件

手动触发

用户说"帮我看看有没有新 skill"、"skill 广场有什么新东西"、"最近有新 skill 吗"、"巡查 skill 广场"或其他类似表述时激活。

执行流程（严格按顺序）

Step 0：明确查找意图

默认走智能推荐模式——用户没有指定关键词时，自动读取 USER.md + 近期 memory，推导搜索方向。 用户指定了关键词时，直接用关键词搜索（跳过推导步骤）。

默认：智能推荐模式

1. 读 USER.md → 提取职位/部门/业务线
2. 读最近 7 天 memory/YYYY-MM-DD.md → 提取高频任务 + 正在推进的项目
3. 自动推导 2-4 个搜索关键词，展示给用户确认：

🧠 智能推荐分析结果：

根据你的背景（{职位/部门}）和近期工作（{高频任务摘要}），
我将搜索以下关键词：
  • {关键词1}
  • {关键词2}

是否继续？[是 / 调整关键词 / 直接输入关键词]

• 用户回复「是」→ 用这些关键词执行 Step 1
• 用户回复「调整关键词」→ 列出关键词供用户修改，修改后再次展示确认
• 用户直接输入关键词 → 跳过推导，用用户输入的关键词执行 Step 1

🔄 降级策略：若 USER.md 无职位/部门信息，或近 7 天无 memory 文件/内容为空，则跳过自动推导，直接询问： `` 没有找到足够的背景信息来自动推荐。 你最近在做哪类工作？想找什么类型的 skill？（直接描述即可） ``

将本次查询意图记录到缓存文件。查询意图优先于近期 memory，作为 Step 3 任务匹配度评分的主要参考。

{如果有历史查询记录，展示：}

📋 上次查询过：{上次诉求描述}（{上次日期}）
→ 输入序号可复用上次关键词，或直接调整

Step 1：获取 Skill 列表

详细搜索命令和参数见 references/search-commands.md。

核心逻辑：

• 通道 A：通过 skillhub skill 按时间排序获取新增 skill，经两层过滤（个性化关键词粗筛 + known_ids 去重）
• 通道 B：通过 skillhub skill 按用户指定关键词搜索（page-size 30）
• 降级：Skill 广场失败时自动降级到 ClawhHub（需安全审查，见 references/clawhhub-safety.md）

若没有新 skill：

✅ Skill 广场巡查完毕（{日期}）

本次没有发现新 skill，广场目前共 {N} 个 skill。
下次巡查：{日期}

结束流程，写巡查日志后退出。

Step 2：读取近期上下文

📎 若 Step 0 已在智能推荐模式下读取近 7 天 memory，此步直接复用，不重新读取文件，节省 token。 仅在 Step 0 未读取（用户直接指定了关键词）时，才执行本步。

读取最近 7 天 memory/YYYY-MM-DD.md，提取近期高频任务类型，记录为"近期活跃场景"，用于后续评分。

Step 3：匹配评估

筛选原则： 有多少推多少，不凑数。低于 4 分的不列入推荐。

ClawhHub 来源的 skill 用 🌐 标注，并附安全评估结果。

Step 4：增强型 skill 内容分类

对增强型 skill 读取 SKILL.md，逐条分析，生成四列完整分析表（供 step6b 直接复用）：

标记含义和写入位置判断原则详见 references/install-decision.md。

📝 此步骤为静默分析：四列分析表在内存中保留（供 step6b 复用），不单独展示给用户，直接进入 Step 5 生成报告。 不需要在此处等待用户确认，继续执行 Step 5。 ⚠️ 重要：「完整分析」= 四列数据（原规则 + 标记 + 转化方式 + 写入位置），缺任何一列视为分析不完整。

Step 5：生成报告

⚠️ 排版铁律（必须严格遵守，不得简化）：

1. skill 名用反引号代码格式：` skill-name `
2. 分数、一句话能力说明、风险点、安装选项全在同一 skill 块内，不拆散
3. 风险点用 △ 标注，单独一行，不埋在正文段落里
4. 安装选项 A/B/C/D 紧跟在风险/分类条目之后，同一 skill 块结尾
5. 增强型必须先通过 skillhub skill 读取目标 skill 的 SKILL.md，提取具体的 ✅/⚠️/🚨 条目后再生成报告；不得只写笼统描述
6. 每个 skill 之间空一行，视觉分隔清晰

报告格式模板（严格按此输出）：

🔍 Skill 广场巡查报告（{YYYY-MM-DD}，发现 {N} 个新 skill）

---

🔧 工具型（可直接安装）

**N. `{skill-name}`** ✅ {分数}/10 {一句话新增能力}，与近期 {场景} 匹配
→ **A** 安装 / **D** 跳过

---

🧩 增强型（需确认后安装）

安装方式：
  **A.** 直接安装 skill（整体注入，保持完整）
  **B.** 学习并转化（不装文件，逐条内化规则到 MEMORY.md / SOUL.md）
  **C.** 只应用无冲突部分（过滤掉 ⚠️/🚨 条目，仅当 skill 模块化可拆时展示此选项）
  **D.** 跳过

**N. `{skill-name}`** ✅ {分数}/10 {一句话核心能力}
△ {具体风险/冲突点，如"会新增 cron 任务（每日蒸馏 + 每周提炼）"}
△ {第二个风险点，如"与你现有 23:00 蒸馏 cron 可能重叠，需检查冲突"}
✅ 可直接应用：{可安全接入的能力描述}
⚠️ 需确认：{具体改动}（会影响 {交互方式/行为}）
🚨 不可逆：{具体改动}（风险：{说明}）
→ A / B / C / D

---

⏭️ 跳过（重复型）
• `{skill名}` — 已有 {skill名/规则} 覆盖

---
下次巡查：{日期}
⏰ 要定时自动发现新 skill 吗？回复：定时每天 / 定时每周 / 定时每月 / 不用

⚠️ 铁律：报告发出后，必须等待用户明确回复，才执行任何操作。 ❌ 禁止在用户回复前主动执行安装，包括工具型 skill。 ✅ 收到用户回复（如"1-A"/"安装第2个"）后，才对应执行。

Step 5.5：询问是否创建定时任务（手动触发时必做）

⚠️ 铁律：手动触发时此步骤不可跳过，无任何例外。 报告发出或用户处理完安装选择后，必须立即追加以下询问。 ❌ 禁止以任何理由省略：不管本次是否安装了 skill，都必须询问。

仅在手动触发时执行此步骤（cron 触发时跳过）。

报告发出的同时（或用户处理完安装选择后），追加询问：

⏰ 要把这次的搜索（{本次查询关键词/类型}）创建为定时任务吗？

每次定时任务会自动执行相同搜索，有新 skill 时发给你。

  A. 每天（09:50）
  B. 每周一（09:00）
  C. 每两周（周一 09:00）
  D. 每月（1 日 09:00）
  E. 不用了

回复 A/B/C/D/E 即可。

用户选 A/B/C/D 时，创建 cron（渠道信息从 config.json 读取）：

创建 cron 前，读取 ~/.openclaw/workspace/skill-discoverer/config.json 获取 channel 和 chat_id。

• cron prompt 格式：读取 skill-discoverer SKILL.md 文件并按其流程执行，查询关键词为 {本次关键词}，完成后通过消息渠道发送结果给用户
• cron prompt 不写死 channel/to，改为在 prompt 里注明：执行时从 ~/.openclaw/workspace/skill-discoverer/config.json 读取 channel 和 chat_id，用于发送结果
• 不要把逻辑内化到 cron prompt 里，必须让 cron 动态读取 SKILL.md，确保规则始终与最新版本同步
• cron name 格式：Skill巡查-{关键词}-{频率}（如 Skill巡查-股票-每天）

用户选 E 时，跳过，不创建 cron。

Step 6：执行用户选择

报告发出后等待用户回复，根据选择执行对应流程：

• 工具型 → 用户说"安装"后，先回显将安装的 skill 名称，等用户明确确认后再执行；批量安装时（如"安装所有工具型"）同样需要逐一列出再确认，不得静默批量执行
• 增强型 用户选择：

- A. 直接安装 → 通过 skillhub skill 执行安装，通知用户结果 - B. 学习并转化 → 直接执行 references/step6b-learn-transform.md 完整流程。 > ⚠️ step6b 内含「展示清单 → 等用户确认 → 才写文件」的完整确认机制，禁止跳过任何步骤。 > 📎 step6b 第一步的分类结果直接复用 Step 4 已做的分析，不重新读取 SKILL.md。 - C. 只应用无冲突部分 → 过滤掉 ⚠️/🚨 条目，只安装 ✅/🔄 部分 前提判断：仅当 skill 各模块相互独立、可单独生效时才提供此选项。若 skill 是整体执行流程（砍掉部分会导致不可用），则隐藏 C，只展示 A/B/D。 > ⚠️ 执行前必须确认：展示「将安装以下 N 条规则（✅/🔄 部分），已过滤以下条目（⚠️/🚨 部分），确认？」，等用户明确回复后再安装。 - D. 跳过 → 记录到 known_ids，不安装

安装/处理完成后，在输出结果末尾追加：

⏰ 要定时持续发现这类 skill 吗？回复：定时每天 / 定时每周 / 定时每月 / 不用

示例对话见 references/examples.md。

数据存储

配置文件（首次运行自动生成）

~/.openclaw/workspace/skill-discoverer/config.json

存储当前用户的消息渠道信息（channel、chat_id），供 cron 任务读取。

缓存文件

~/.openclaw/workspace/skill-discoverer/known_skills.json

巡查日志

~/.openclaw/workspace/skill-discoverer/scan_logs/YYYY-MM-DD.md

记录：巡查时间 / 发现数量 / 评分详情 / 推荐结果 / 用户决策。

Cron 配置

创建 cron 时，channel 和 chat_id 不写死，改为在 prompt 里指示 agent 读取配置文件：

cron prompt 模板：

帮我看看有没有新 skill [--topic {关键词}]
（执行完成后，读取 ~/.openclaw/workspace/skill-discoverer/config.json 获取 channel 和 chat_id，将结果发送给用户）

依赖 Skill

• skillhub — 获取/安装/读取 Skill 广场内容（Step 1、Step 6 必须）
• 渠道对应的 scheduled-message skill — 创建定期巡查 cron（OpenClaw 会根据当前渠道自动选择）