Study-Notes

多篇既有学习笔记的批量更新编排。用于用户想一次更新一个目录、文件列表、Obsidian vault 子目录或多篇旧笔记，例如“批量更新这些笔记”“多篇笔记过时了”“把一组笔记更新到新版本”“refresh multiple notes”。先生成更新清单和批量计划，经用户确认后逐篇调用 note-updater 局部 patch，避免全文重写和批量误覆盖。

旧笔记批量导入、盘点和规范化。用于用户已经有一堆 Markdown/Obsidian/零散学习笔记，想接入本项目工作区、按项目 Obsidian 规范补 frontmatter、标签、双链、Callout、MOC，并保留原始文件时使用。触发词：旧笔记导入、已有笔记、一堆笔记、批量整理、迁移到这个项目、按项目规范、import existing notes、normalize notes。

学习笔记需求澄清与引导。分析用户学习需求，引导明确学习目标和方向，调用 workflow-orchestrator 生成项目结构。触发词：想学、帮我整理、研究一下、了解一下、不知道从哪开始、research planning、explore topic。

业务工作流实例化器。由 planner 技能调用，接收 workflow_id、topic、project_slug 等参数，按 .claude/workflows/{workflow-id}/state-template.md 生成 workspace/workflow-runs/{run-id}.workflow.md。不直接面向用户；通用状态格式和状态流转由 workflow-todo-state 负责。

Create or retrofit reusable named workflow state machines for multi-step agent projects. Use when a project needs recoverable workflow state files, multiple workflow definitions, phase gates, restart-safe agent workflows, explicit skipped/blocked states, workflow routing rules, or reusable workflow templates across repositories.

自我学习阶段。回顾本次学习会话，记录学习心得和错误到 .claude/rules/learnings/，当文件超阈值时自动压缩去重，更新 RULES.md，促进系统持续改进。

为 Obsidian 生成或更新 MOC（Map of Content）目录笔记。用于用户要求“生成 MOC”“整理目录”“把新笔记加入目录”“每次加入笔记自动更新索引”等场景。只维护索引、分组、双链和简短说明，不复制正文。

Obsidian 笔记智能美化与发布。用于将最终学习笔记处理成 Obsidian Markdown，补 frontmatter、标签、Callout、双链，并保存到用户指定位置。触发词：美化、Obsidian、优化格式、笔记美化、发布到 vault、beautify。

更新过时的既有学习笔记。用于用户说“更新这篇笔记”“这篇笔记过时了”“根据新资料刷新旧笔记”“同步到 Obsidian 旧笔记”等场景。先定位旧笔记、判断过时段落、收集最小必要新资料，再局部 patch，避免重写整篇和浪费 token。

使用多策略进行高效资料收集：Fork Subagent 隔离收集、两阶段粗筛+精读、格式约束优化 token 消耗、本地缓存复用。触发词：收集资料、研究资料、搜集信息、资料整理、research、gather information、collect资料。

查看当前环境中可用于资料收集的工具，包括内置工具、MCP 工具和已安装的 skills。当用户想了解有哪些工具可以用来搜索、提取、分析资料时使用此技能。触发词：可用工具、有哪些工具、工具列表、收集工具、search tools、available tools。

维护 .learnings/ 经验库，把过多或反复出现的学习记录、错误日志、规则失效问题聚类诊断，追溯并修改对应 skill、模板、hook、校验脚本或项目规则；修复并验证后再归档或移除已解决记录；同时检查 Codex .agents/skills 与 Claude Code .claude/skills 的共享功能同步。用户提到 learnings 太多、错误反复犯、清理经验库、维护自我学习、压缩错误日志、从错误中修技能、同步 Codex 和 Claude Code 技能时触发。

多篇既有学习笔记的批量更新编排。用于用户想一次更新一个目录、文件列表、Obsidian vault 子目录或多篇旧笔记，例如“批量更新这些笔记”“多篇笔记过时了”“把一组笔记更新到新版本”“refresh multiple notes”。先生成更新清单和批量计划，经用户确认后逐篇调用 note-updater 局部 patch，避免全文重写和批量误覆盖。

旧笔记批量导入、盘点和规范化。用于用户已经有一堆 Markdown/Obsidian/零散学习笔记，想接入本项目工作区、按项目 Obsidian 规范补 frontmatter、标签、双链、Callout、MOC，并保留原始文件时使用。触发词：旧笔记导入、已有笔记、一堆笔记、批量整理、迁移到这个项目、按项目规范、import existing notes、normalize notes。

工作流编排器。由各 planner 技能调用，接收工作流名称和参数，从模板生成 todo.md。不直接面向用户。

美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。

收集学习资料阶段。根据用户的学习主题，使用 opencli 适配器搜索官方文档和社区内容，抓取并保存原始资料。触发时机：用户确认学习计划后，Phase 1。

整理学习资料阶段。遍历所有原始资料，按权威性/时效性/完整性/可读性打分，去重，分类归入核心概念/实战示例/进阶原理，标记信息缺口。触发时机：用户审核通过 collect 产出后，Phase 2。

安全删除 Obsidian 笔记文件。删除指定文件前自动搜索全库 [[双链]] 引用，清理所有指向该文件的链接，经用户确认后执行删除。触发时机：用户要求删除笔记、清理文件、移除内容时。

质量评估阶段。对已完成美化的笔记进行五维度评分（完整性/准确性/可读性/实用性/关联性），交叉验证已整理资料，生成结构化评估报告。触发时机：用户审核通过 beautify 产出并明确要求评估后，Phase 5。

分析指定文件夹内的 Obsidian 笔记，基于共享 tags 和内容相似度自动识别相关笔记对，生成 [[双链]] 互链。触发时机：用户要求建立笔记关联、生成文件夹内链接、连接相关内容时。

扫描目录生成 Obsidian MOC（Map of Content）索引笔记，包含按子目录分组的 wikilink 列表和 Mermaid 结构图。触发时机：用户要求创建 MOC、索引文件夹、映射目录结构、或导航 Obsidian vault 中的笔记时。

Use when writing an OpenCLI adapter for a new site or adding a new command to an existing site. Guides end-to-end from first recon through field decoding, adapter coding, and verify. Replaces opencli-oneshot / opencli-explorer. For ad-hoc browser driving (no adapter), see opencli-browser instead; for a top-level orientation to opencli, see opencli-usage.

Use when an agent needs to drive a real Chrome window via opencli — inspect a page, fill forms, click through logged-in flows, or extract data ad-hoc. Covers the selector-first target contract, compound form fields, stale-ref handling, network capture, and the agent-native envelopes the CLI returns. Not for writing adapters — see opencli-adapter-author for that.

Use at the start of any OpenCLI session — this is the top-level map of what `opencli` can do, how to discover adapters, what flags and output formats are universal, and which specialized skill to load next. Point here when an agent asks "what can opencli do?" or "how do I find the right command?".

更新已有笔记。支持两种模式：insert（插入新内容，匹配现有排版）和 refresh（刷新过时内容，可选 mini collect→curate→write 研究循环）。触发时机：用户要求修改、添加或更新已发布的笔记时。

写笔记阶段。根据整理好的资料和用户偏好的笔记类型（概念/实战/对比/速查/心得），选择模板，提取关键信息，用学习者友好的语言生成笔记初稿。触发时机：用户审核通过 curate 产出后（研究驱动型），或用户审核通过 review 产出后（心得笔记），Phase 3。

扫描目录生成 Obsidian MOC（Map of Content）索引笔记，包含按子目录分组的 wikilink 列表和 Mermaid 结构图。触发时机：用户要求创建 MOC、索引文件夹、映射目录结构、或导航 Obsidian vault 中的笔记时。