Skill Discoverer — Skill 广场发现者

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

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

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

CODEBLOCK0

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

首次运行：初始化配置

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

1. 保存当前渠道信息

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

CODEBLOCK1

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

写入后告知用户：
CODEBLOCK2

2. 询问巡查频率

CODEBLOCK3

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

定位

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

触发条件

手动触发

执行流程（严格按顺序）

Step 0：明确查找意图

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

默认：智能推荐模式

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

CODEBLOCK4

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

🔄 降级策略：若 USER.md 无职位/部门信息，或近 7 天无 memory 文件/内容为空，则跳过自动推导，直接询问：
CODEBLOCK5

将本次查询意图记录到缓存文件。查询意图优先于近期 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. 1. skill 名用反引号代码格式：` skill-name 2. **分数、一句话能力说明、风险点、安装选项全在同一 skill 块内**，不拆散 3. **风险点用 △ 标注**，单独一行，不埋在正文段落里 4. **安装选项 A/B/C/D 紧跟在风险/分类条目之后**，同一 skill 块结尾 5. **增强型必须先通过 skillhub skill 读取目标 skill 的 SKILL.md**，提取具体的 ✅/⚠️/🚨 条目后再生成报告；不得只写笼统描述 6. **每个 skill 之间空一行**，视觉分隔清晰 **报告格式模板（严格按此输出）：** CODEBLOCK8 > ⚠️ **铁律：报告发出后，必须等待用户明确回复，才执行任何操作。** > ❌ 禁止在用户回复前主动执行安装，包括工具型 skill。 > ✅ 收到用户回复（如"1-A"/"安装第2个"）后，才对应执行。 --- ### Step 5.5：询问是否创建定时任务（手动触发时必做） > ⚠️ **铁律：手动触发时此步骤不可跳过，无任何例外。** > 报告发出或用户处理完安装选择后，必须立即追加以下询问。 > ❌ 禁止以任何理由省略：不管本次是否安装了 skill，都必须询问。 **仅在手动触发时执行此步骤（cron 触发时跳过）。** 报告发出的同时（或用户处理完安装选择后），追加询问： CODEBLOCK9 **用户选 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，不安装 **安装/处理完成后，在输出结果末尾追加：** CODEBLOCK10 示例对话见 references/examples.md。 --- ## 数据存储 ### 配置文件（首次运行自动生成） CODEBLOCK11 存储当前用户的消息渠道信息（channel、chat_id），供 cron 任务读取。 ### 缓存文件 CODEBLOCK12 ### 巡查日志 CODEBLOCK13 记录：巡查时间 / 发现数量 / 评分详情 / 推荐结果 / 用户决策。 --- ## Cron 配置 创建 cron 时，channel 和 chat_id 不写死，改为在 prompt 里指示 agent 读取配置文件： **cron prompt 模板：** CODEBLOCK14 | 频率 | 触发时间 | 触发语 | |------|----------|--------| | 每周一 | 09:00 | 帮我看看有没有新 skill | | 双周 | 每两周周一 09:00 | 帮我看看有没有新 skill | | 每月 | 每月 1 日 09:00 | 帮我看看有没有新 skill --topic 智能推荐 | --- ## 依赖 Skill - skillhub` — 获取/安装/读取 Skill 广场内容（Step 1、Step 6 必须）

• - 渠道对应的 scheduled-message skill — 创建定期巡查 cron（OpenClaw 会根据当前渠道自动选择）