scout

COG Scout 技能

用途

轻量级 URL/工具初筛，介于“忽略”和 /url-dump 之间。评估某个 URL 或工具是否值得保存或跳过：检查知识库中是否已有相关内容，评估其与用户档案和兴趣的相关性，并推荐明确的下一步操作。

何时调用

• 用户想在完整保存前评估某个 URL 或工具
• 用户说“侦察一下这个”“评估一下这个”“我应该保存这个吗？”“这和我相关吗？”
• 用户分享一个或多个 URL，并希望快速评估相关性
• 用户提到某个工具/服务名称，想知道是否值得进一步了解

Agent 模式识别

检查 00-inbox/MY-PROFILE.md frontmatter 中的 agent_mode：

• 如果是 agent_mode: team — 将知识库扫描和网页抓取任务委派给并行子 Agent（一个负责搜索知识库，另一个负责抓取/分析内容）。汇总结果后给出建议。
• 如果是 agent_mode: solo（默认值）— 在对话中直接完成所有扫描和分析。不进行委派。

执行前检查

执行前，检查用户档案：

1. 在知识库中查找 00-inbox/MY-PROFILE.md 和 00-inbox/MY-INTERESTS.md
2. 如果未找到：

   Welcome to COG! Scout works best with a profile for relevance matching.
   
   Would you like to run /onboarding first, or should I evaluate with general criteria?
   

3. 如果找到：
   • 阅读 MY-PROFILE.md，了解正在进行的项目和角色
   • 阅读 MY-INTERESTS.md，了解感兴趣的主题
   • 阅读 00-inbox/MY-INTEGRATIONS.md，了解启用的集成（检查是否可用 web-fetch 和 web-search）

与 /url-dump 的分工

Scout 负责评估（“我应该保存这个吗？”）。URL-dump 负责保存（“现在就保存这个”）。

• Scout 检查已有内容、评估相关性，并推荐操作
• 如果建议是 Save，Scout 会将预填好类别的信息交接给 /url-dump
• 已经确定要保存的用户应直接使用 /url-dump

流程

1. 接收输入

接受以下一种或多种输入：

• URL： 要评估的直接链接
• 工具/服务名称： 将先搜索该工具
• 混合输入： URL 和名称的组合

（如果未提供输入）提示词：

What URL(s) or tool(s) would you like me to evaluate?
(You can paste URLs, tool names, or a mix)

批量模式： 一次调用中提供的多个 URL/名称会一并处理，并在最后附上汇总表。

2. 检查知识库覆盖情况

针对每个 URL 或工具名称，搜索整个知识库，查找已有内容。

搜索策略：

• 从 URL 中提取域名（例如，github.com/owner/repo → 搜索仓库名称）
• 在整个知识库中搜索工具/服务名称（grep 域名、仓库名称、工具名称）
• 匹配 frontmatter 中的 URL 字符串（url: 字段）和行内链接

如果找到：

🔍 Existing coverage found for [name]:
- [file path] — saved [date], category: [category]
- [file path] — mentioned in [context]

Want me to check if an update is needed, or skip this one?

3. 抓取并分析内容

如果提供了 URL 且 web-fetch 已启用：

• 使用 WebFetch 抓取 URL 内容
• 提取：标题、描述、内容类型、作者、日期

如果提供了工具名称（没有 URL）：

• 使用 WebSearch 查找该工具的主页面
• 抓取并分析排名第一的结果

内容类型识别：

• 工具/服务： 软件、SaaS、API、库、框架
• 文章/博客： 长篇内容、教程、观点文章
• 代码仓库： GitHub/GitLab 仓库（提取 star 数、最近提交、语言）
• 研究： 论文、研究、学术内容
• 新闻： 行业新闻、公告
• 参考资料： 文档、规范、标准

4. 评估相关性

根据用户背景评估相关性：

档案匹配（来自 MY-PROFILE.md）：

• 是否与某个正在进行的项目相关？与哪个项目相关？
• 是否符合用户的角色？
• 是否适合用户的技术栈？

兴趣匹配（来自 MY-INTERESTS.md）：

• 是否匹配任何已声明的兴趣主题？
• 相关性有多直接？

质量信号：

• 对于代码仓库：star 数、近期活跃度、维护者状况
• 对于工具：定价模式、成熟度、采用情况
• 对于文章：作者可信度、发布质量、时效性
• 对于所有内容：相较于知识库中已有内容的独特性

5. 给出建议

根据分析，推荐以下两种操作之一：

Save — 值得添加到知识库

✅ SAVE — [Title/Name]
Category: [suggested category for url-dump]
Relevance: [High/Medium] — [why it matters]
Projects: [affected project(s) if any]

Shall I hand off to /url-dump to save it?

Skip — 不相关或不值得投入时间

⏭️ SKIP — [Title/Name]
Reason: [clear explanation — wrong stack, low quality, already covered, irrelevant to interests]

6. 批量摘要（适用于多个项目）

处理多个 URL/工具时，最后附上摘要表：

## Scout Summary

| # | Item | Verdict | Reason |
|---|------|---------|--------|
| 1 | [Name 1] | ✅ Save | [brief reason] |
| 2 | [Name 2] | ⏭️ Skip | [brief reason] |

**Actions:**
- [X] items ready to save via /url-dump

7. 执行后续操作

根据用户确认：

• **保存项目：**将内容交给 /url-dump，并预填类别建议
• **跳过项目：**无需采取任何操作

备用处理方式

场景	处理方式
web-fetch 不可用	仅根据 URL 结构、域名信誉和知识库搜索结果进行评估。注明未能获取内容。
web-search 不可用	对于工具名称输入（不含 URL），请用户提供直接 URL。对于 URL 输入，正常处理——无需使用 web-search。
没有用户资料	根据一般质量/相关性标准进行评估，跳过个性化相关性评分
URL 需要付费访问	说明限制，根据可用预览和元数据进行评估
搜索未找到工具	请用户提供更多背景信息或直接 URL

不确定性处理

• **高置信度：**相关性明确或明显无关——直接给出建议
• **中等置信度：**部分匹配——列出优缺点，由用户决定
• **低置信度：**无法判断相关性——说明不明确之处，并请用户提供背景信息

与其他技能的集成

下游

• 保存 → 将内容交给 /url-dump，并预填类别

上游

• /daily-brief 可能会展示新工具/服务 → 用户可以运行 /scout 进行评估
• /auto-research 可能会在研究过程中发现工具 → scout 可以对其进行初步筛选

成功指标

• 快速初筛（独立模式下，单个 URL 用时不到 1 分钟）
• 建议清晰、可执行
• 准确检测知识库覆盖情况（不重复保存）
• 相关性评分符合用户预期
• 保存时可顺畅交接至 /url-dump

理念

Scout 体现了 COG 的“先评估，再积累”原则：

• 并非所有内容都值得收藏——要有所选择
• 创建重复内容前，应先展示现有覆盖情况
• 二选一的保存/跳过方式让决策更快速，避免折中
• 清晰的建议可减轻决策疲劳