用途
synthesizing-knowledge 用于针对某一特定主题生成一份综合性的 Markdown 知识文档。其目标是通过网络与视频来源进行深度检索，再把发现综合整理为结构清晰、带有可验证且可访问参考链接的报告。
主要能力
- 对主题进行网络与视频来源的检索，并综合为 Markdown 报告。
- 支持并行研究子代理：当涉及 3 个以上子主题或 5 次以上检索时，派发并行研究子代理；否则直接检索。
- 附带
## References参考链接部分，并区分「Websites & Articles」与「Videos & Media」。 - 提供引用索引规则与参考链接质量校验流程，包括运行 resolve 脚本解析链接。
使用方式
该技能规定了一套严格的分步流程，必须一次只执行一步，不得跳步：
- 环境检查：先判断操作系统是 Linux、macOS 还是 Windows，以及 shell 是 Bash、Zsh 还是 PowerShell，并据此调整脚本与命令。Unix 下运行
echo $SHELL和uname -a；Windows 下查看$PSVersionTable。Unix 下用command -v <tool>验证工具是否存在，Windows 下用Get-Command <tool>。 - 分析：识别主主题、子主题与检索关键词。
- 研究：检索网络与视频来源；若达到阈值则派发并行子代理。每个子代理提示必须包含：「Provide the full URL to the specific article (e.g., https://example.com/articles/foo), NOT the domain homepage.」
- 草稿：在最终报告之前，先写入
<working_dir>/bibliography_draft.md，包含所有 URL 与事实。在 Antigravity 中该路径为 scratch/ 目录；在 Claude Code 或 OpenCode 中可选择任意会话级临时目录。 - 验证 URL：运行 resolve 脚本；对仅返回首页的结果重新检索。
- 综合：仅使用草稿中已定义的索引撰写报告，并追加
## References。
resolve 脚本需同步运行（脚本机制取决于所用工具，请至少预留 links × 10 秒、最少 60 秒）：
python <skill_folder>/scripts/resolve_markdown_links.py <path-to-report.md>
等待 === SCRIPT COMPLETE ===；在定稿前处理任何 [HOMEPAGE WARNING] 或 [BROKEN LINK WARNING]。该脚本绝不能作为后台任务运行，否则文件不会及时更新。
URL 质量处理规则：
- 具体文章路径：✅ 接受。
- Webcache / Smart redirect：✅ 接受，运行 resolve 脚本，它会自动从 webcache 与 vertexaisearch 链接中提取规范 URL 并干净替换。
- 仅首页（如 https://example.com）：❌ 需重新检索
site:example.com [keyword]；两次失败后标注[Homepage fallback]。 - 绝不要重建或猜测 URL 子路径。
引用规则：先写参考文献，仅使用其中的索引进行内联引用；不要引用大于参考文献总条目数的 [N]；同一来源的多个事实复用同一索引；每条直接引语、统计数字或关键事实都需要内联 [N]；保持 90% 保真度，不要扭曲、夸大或误述来源。
报告模板：
# [Topic Title]
> **Summary**: [2–3 sentences]
> **Last Updated**: [date]
## 1. Overview
[High-level intro]
## 2. [Sub-topic]
[Details with citations, e.g. "78% of users prefer dark mode [1]."]
## References
### Websites & Articles
- [1] [Article Name](URL) — brief description
### Videos & Media
- [2] [Video Title](YouTube URL) — brief description
适用场景
- 用户需要关于特定主题的知识文档、摘要或报告。
- 需要模型记忆之外的较新或较深入信息。
- 需要可验证、可点击的参考来源以保证可信度。
限制与铁律
- 若来源为 YouTube 转录或会议纪要，应改用 youtube-minutes-synthesis。
- 草稿之前不得出报告：在 bibliography draft 保存前，禁止使用文件写入工具写最终报告。
- 无标注不得引用首页：两次检索仍找不到文章 URL 时标注
[Homepage fallback]。 - resolve 脚本不得后台运行：始终同步执行，等待
=== SCRIPT COMPLETE ===后再继续。 - 常见错误包括：幻觉链接、猜测规范 URL、引用首页、在父级顺序执行 5 次以上检索、跳过草稿、
[N]越界、语言混杂、后台运行 resolve 脚本。 - 关于收费、价格、平台支持范围等细节，资料暂未提供。