Learn 技能

一个把文章、网页和文本整理成可执行知识笔记的 Codex 技能。

---

概览

learn 是一个用于“内容分析 + 笔记沉淀”的 Codex 技能。

它适合处理四类输入：网页、文章、本地文件、直接粘贴的长文本。技能会先做结构化分析，再把内容拆成适合回顾和执行的知识结果；如果你确认需要保存，它会继续把结果整理成一篇适合放进 Obsidian 的笔记。

这个技能的重点不是复述原文，而是回答三个更有价值的问题：

• 这篇内容值不值得学
• 核心观点到底是什么
• 哪些部分真的可以落地执行

预览

下面这张图展示的是 learn 处理内容后的典型输出形态：

这个技能能做什么

• 分析文章、网页或本地文本的价值
• 提取 3-5 个核心论点
• 总结 5-8 条关键要点
• 从“能不能落地”的角度提炼可实践方法
• 推荐 Obsidian 的目录、标题和标签
• 在用户确认后，保存为 Obsidian 笔记

适用场景

• 看完一篇文章，想快速判断值不值得继续深挖
• 想把网页内容沉淀成自己的知识笔记
• 想把一段长文本整理成结构化摘要
• 想把“信息”变成“可执行的方法”
• 想把分析结果直接存进 Obsidian

工作流程

learn 的默认流程如下：

flowchart TD
    A[输入内容] --> B{输入类型}
    B -->|URL| C[抓取正文]
    B -->|本地文件| D[读取文件]
    B -->|直接文本| E[直接分析]
    C --> F[价值评估]
    D --> F
    E --> F
    F --> G[提取核心论点]
    G --> H[提炼可实践方法]
    H --> I[总结关键要点]
    I --> J[推荐标题 目录 标签]
    J --> K[展示摘要等待确认]
    K -->|确认保存| L[写入 Obsidian]
    K -->|仅分析| M[结束]

Loading

用一句话概括，就是：

输入内容 -> 结构化分析 -> 用户确认 -> 保存笔记

快速开始

1. 克隆仓库

git clone https://github.com/Ally1212/Learn-skills.git

2. 放到本地技能目录

mkdir -p ~/.codex/skills
cp -R Learn-skills ~/.codex/skills/learn

只要目标目录里保留 SKILL.md，大多数本地 Skill 加载方式都可以识别它。

怎么使用

你可以显式触发这个技能：

用 $learn 分析这篇文章：https://example.com/article

也可以直接用自然语言触发：

learn 这篇内容：https://example.com/article
帮我分析并沉淀这篇文章
把这段内容整理成可执行的笔记
把这个网页保存到 Obsidian

典型用法

分析网页

用 $learn 分析这篇文章：https://example.com/article

分析本地文件

用 $learn 分析这个文件：/path/to/article.md

分析直接粘贴的文本

用 $learn 分析下面这段内容，并提炼可实践方法：
[在这里粘贴正文]

分析后保存到 Obsidian

用 $learn 分析这篇文章，并保存到 Obsidian

输出内容

默认会先给出一份结构化结果，通常包括：

• 价值评估
• 核心论点
• 可实践方法
• 关键要点
• 推荐标题
• 推荐目录
• 推荐标签

如果你要求保存，确认后生成的 Obsidian 笔记通常包括：

• 标题
• 来源信息
• 价值评估
• 核心论点
• 可实践方法
• 关键要点
• 标签
• 记录日期

使用建议

• 如果你只是想判断“值不值得读”，先做分析，不必立刻保存
• 如果你想长期沉淀，建议在保存前手动调整目录和标签
• 如果文章偏空泛，learn 会更关注少量可执行的部分，而不是机械复述全文
• 如果当前环境没有预设 Obsidian 仓库路径，首次保存前需要先确认目标位置

仓库结构

.
├── SKILL.md
├── README.md
├── agents
│   └── openai.yaml
└── assets
    └── learn-preview.svg

核心文件

• SKILL.md: 技能定义与执行规则
• agents/openai.yaml: UI 元数据与默认触发提示
• assets/learn-preview.svg: README 预览图