收集学习资料阶段。根据用户的学习主题，使用 opencli 适配器搜索官方文档和社区内容，抓取并保存原始资料。触发时机：用户确认学习计划后，Phase 1。
npx skills add https://github.com/Treasoni/Study-Notes --skill collectانسخ والصق هذا الأمر في Claude Code لتثبيت المهارة
美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。
写笔记阶段。根据整理好的资料和用户偏好的笔记类型（概念/实战/对比/速查/心得），选择模板，提取关键信息，用学习者友好的语言生成笔记初稿。触发时机：用户审核通过 curate 产出后（研究驱动型），或用户审核通过 review 产出后（心得笔记），Phase 3。
扫描 Obsidian vault 中所有失效的 [[双链]]（目标文件不存在），呈现死链清单，提供删除链接、创建占位笔记、替换为正确链接三种修复方式。触发时机：用户发现链接失效、手动删除文件后需清理、定期 vault 健康检查时。
安全删除 Obsidian 笔记文件。删除指定文件前自动搜索全库 [[双链]] 引用，清理所有指向该文件的链接，经用户确认后执行删除。触发时机：用户要求删除笔记、清理文件、移除内容时。
分析指定文件夹内的 Obsidian 笔记，基于共享 tags 和内容相似度自动识别相关笔记对，生成 [[双链]] 互链。触发时机：用户要求建立笔记关联、生成文件夹内链接、连接相关内容时。
扫描目录生成 Obsidian MOC（Map of Content）索引笔记，包含按子目录分组的 wikilink 列表和 Mermaid 结构图。触发时机：用户要求创建 MOC、索引文件夹、映射目录结构、或导航 Obsidian vault 中的笔记时。
| name | collect |
| description | 收集学习资料阶段。根据用户的学习主题，使用 opencli 适配器搜索官方文档和社区内容，抓取并保存原始资料。触发时机：用户确认学习计划后，Phase 1。 |
用户确认学习计划后。
topic: 学习主题direction: 概念理解 / 实战上手 / 体系梳理 / 问题排查depth: 入门 / 进阶 / 深入原理每次执行前先运行 opencli list -f json 确认当前可用的搜索源，以下为常用源（以 live registry 为准）：
| 站点 | 用途 | 命令示例 |
|---|---|---|
google | 通用搜索 | opencli google search "<query>" -f json |
github | 代码仓库 / 开源项目 | 使用 mcp__github__search_code 或 mcp__github__search_repositories |
mdn | Web 标准文档 | opencli mdn search "<query>" -f json |
stackoverflow | 编程问题 / 报错 | opencli stackoverflow search "<query>" -f json |
reddit | 社区讨论 / 经验 | opencli reddit search "<query>" -f json |
hackernews | 技术社区讨论 | opencli hackernews search "<query>" -f json |
medium | 技术博客 | opencli medium search "<query>" -f json |
devto | 开发者社区 | opencli devto search "<query>" -f json |
arxiv | 学术论文 | opencli arxiv search "<query>" -f json |
linux-do | 中文技术社区 | opencli linux-do search "<query>" -f json |
v2ex | 中文技术社区 | opencli v2ex search "<query>" -f json |
wikipedia | 概念定义 / 背景 | opencli wikipedia search "<query>" -f json |
youtube | 视频教程 | opencli youtube search "<query>" -f json |
bilibili | 中文视频教程 | opencli bilibili search "<query>" -f json |
| 站点 | 适用场景 |
|---|---|
grok | 英文互联网、Twitter/X 语境、热点追踪 |
gemini | 全球网页、英文资料、背景综述 |
doubao | 中文语境、中文热点与问答 |
| 工具 | 用途 |
|---|---|
defuddle parse <url> --md | 提取网页正文 Markdown，去广告去导航 |
opencli web read --url <url> | 备选方案，一次性的页面 Markdown 读取 |
opencli google search "{topic} official documentation" -f jsonopencli google search "{topic} official guide tutorial" -f json根据 depth 调整搜索词：
{topic} getting started tutorial{topic} advanced guide best practices{topic} deep dive internals architecture锁定官方文档入口 URL（从搜索结果中提取）。
用 defuddle parse 抓取官方文档关键页面，保存为 raw/doc-NN.md。
至少覆盖：
defuddle parse "<url>" --md -o "{SYSTEM_ROOT}/0-inbox/{topic}/raw/doc-01.md"
根据主题类型选择合适的源。每次搜索前先运行 <site> -h 确认参数：
技术类主题：
# 近期教程
opencli google search "{topic} tutorial 2025 2026" -f json
# GitHub 项目
github__search_repositories({query: "{topic} stars:>100"})
# 最佳实践
opencli google search "{topic} best practices" -f json
# 常见陷阱
opencli google search "{topic} common pitfalls mistakes" -f json
# 深度解析
opencli google search "{topic} deep dive advanced guide" -f json
# 社区问答（中英文各一）
opencli stackoverflow search "{topic}" -f json
opencli v2ex search "{topic}" -f json
非技术类主题：用 smart-search skill 路由到合适的专用源。
视频内容（实战上手方向优先）：
opencli youtube search "{topic} tutorial" -f json
opencli bilibili search "{topic} 教程" -f json
对每个入选来源，用 defuddle parse 抓取并保存：
defuddle parse "<url>" --md -o "{SYSTEM_ROOT}/0-inbox/{topic}/raw/doc-NN.md"
写入 {SYSTEM_ROOT}/0-inbox/{topic}/：
# Sources for {topic}
| # | Title | URL | Author | Date | Type | Notes |
|---|-------|-----|--------|------|------|-------|
# {Title}
- **Source**: {URL}
- **Author**: {name}
- **Date**: {date}
- **Type**: {official|blog|tutorial|discussion}
---
{raw content}
-h 确认本阶段任务完成。向用户展示收集结果摘要（来源数量、覆盖的子主题、明显缺口）。
严禁调用 /curate。严禁进入 Phase 2。
必须等待用户明确确认（"继续" / "进入下一阶段" / "开始整理"）后才能进入 curate。