Skip to content

About

启发式学习 Agent Skill:先补背景与例子,用一个问题引导推理,再解释、纠错与迁移。Adaptive guided learning for unfamiliar concepts.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

Guided Learning · 启发式学习

一个帮助你理解陌生专业知识的 Agent Skill:用背景与具体情境搭桥,通过一次推理或用自己的话讲回发现理解缺口,随后解释、修补,并在有价值时换个情境检验应用。

An Agent Skill for learning unfamiliar concepts through brief context, concrete examples or optional fables, one reasoning or explain-back task, and feedback that identifies gaps. It follows the learner's language and switches to a complete explanation whenever requested.

Skill 指令 · 教学示例 · 设计来源 · MIT License

点击任意图解可查看原图。

让 AI 陪你想明白:用具体情境搭桥,在推理与讲回中修补理解 创作初衷:给自己的思考留一点空间,从回答中找出遗漏的原因与条件

它如何帮助你 / How it helps

默认节奏:背景与情境 → 一次推理或讲回 → 定位缺口与解释 → 必要时修补和迁移。根据你的基础与已有回答调整,不要求每次走完固定流程。

学习节奏:从情境开始,逐步讲清楚,按需修补与迁移 互动示例:通过机会成本的解释,先保留正确部分,再修补关键理解缺口

  • 初次接触一个领域:先解释必要术语,给出具体案例;抽象关系难以直观理解时,可用短寓言呈现,再说明其对应关系与边界。
  • 检验自己的理解:用自己的话或简图讲清一条机制,检查是否只记住故事、遗漏因果关系或忽略关键条件;修补时只聚焦最影响判断的一处。
  • 已经有自己的判断:直接检验你的依据与推理。
  • 完全不知道或卡住了:补充背景、示范完整思路;同一学习点默认最多追加一次得到帮助后的尝试,提示后再猜与修补后再讲回共用次数。
  • 希望继续应用:换一个关键条件检验应用或识别失效,分别观察讲回与迁移的表现。
  • 需要直接答案或实际交付物:立即满足请求,可以随时退出提问模式。

适合希望理解概念、原理、机制和判断条件的学习请求。只查事实、赶时间或需要完成工作时,不强制进入教学流程。

安装到 Codex / Install in Codex

此 skill 由指令、示例与图片资源组成,无需安装运行依赖或填写 API 密钥。使用 Git 将仓库放入个人 skills 目录即可。

Windows(PowerShell)

$skillRoot = Join-Path $env:USERPROFILE '.agents/skills'
New-Item -ItemType Directory -Force -Path $skillRoot | Out-Null
git clone https://github.com/cliffffffffff/guided-learning.git (Join-Path $skillRoot 'guided-learning')

macOS / Linux

mkdir -p ~/.agents/skills
git clone https://github.com/cliffffffffff/guided-learning.git ~/.agents/skills/guided-learning

也可以在 Codex 中让内置安装器处理:

用 $skill-installer 安装 https://github.com/cliffffffffff/guided-learning
仓库根目录里的 skill,名称为 guided-learning。

安装后用 $guided-learning 显式调用,也可由 Codex 根据你的学习请求自动选择。若新安装的 skill 未出现,重启 Codex。安装目录与发现方式见 OpenAI 官方 skills 文档。

使用示例 / Try it

调用方法:用 $guided-learning 带我理解数据库索引,说出自己的基础与卡点 学习节奏由你决定:可以先示范、检查理解,或直接获得完整解释

用 $guided-learning 带我理解:为什么输电要提高电压?
我是新手,先给必要背景和例子,再提出一个问题让我尝试。
用 $guided-learning 带我理解数据库索引。我写过 SQL,但不清楚索引为何能加快查询。
用 $guided-learning 帮我检查对机会成本的理解。我认为它就是选错以后少赚的钱。
请从我的解释中找出关键缺口,帮我修补,再按需换个情境检验。
Use $guided-learning to help me understand HTTP caching.
I'm new to it. Give me a concrete example, then one question to reason through.

随时可以说“我完全不知道,先示范”或“我赶时间,直接讲完,不用提问”。

仓库内容 / Files

guided-learning/
├── SKILL.md                         核心指令与触发范围
├── agents/openai.yaml               界面元数据与调用策略
├── assets/
│   ├── icon.svg                    图标
│   └── intro/                      八张介绍图(01.png–08.png)与提示词、来源
├── references/
│   ├── teaching-examples.md          寓言映射、推理、讲回修补和迁移示例
│   └── design-basis.md               寓言、费曼式学习及研究证据边界
├── README.md
└── LICENSE

设计依据与贡献 / Design and contributions

创作初衷参考 Renx 发布于“启元洞见”的《当 AI 代替人类承担“思考的阵痛”,它在如何重塑人类认知架构?》。我们希望在 AI 分担记忆、计算等任务时,仍为学习者保留尝试推理、检查依据和条件的空间;同时尊重用户的基础、意愿与学习节奏。

认知卸载与认知投降:借助 AI 分担任务,同时保留自己的判断 寓言学习的启发:Amanda Askell 的个人用法,以及本技能按需讲清机制与边界的改编

这是可调整的教学流程。寓言部分通过 fable-writing 技能,借鉴“数字生命卡兹克”发布的《分享一个很实用的寓言故事prompt,5分钟帮你理解任何新概念。》(文末署名:卡兹克、tashi)中的寓言写作 Prompt,将故事、概念映射和理解/迁移检验改编为按需使用、每轮一个核心任务的教学方式。

该文章追溯的上游启发是 Anthropic 的 Amanda Askell 在 Newcomer 访谈(53:20 起)中的个人使用分享:先让寓言间接呈现概念,再在故事后揭晓和解释概念。本技能进一步加入短寓言的按需选择、机制与边界说明,以及推理、讲回或迁移检查。八张图的完整提示词与补充参考来源见 图解制作记录。

同时借鉴费曼式学习中的解释、发现缺口与修补。这些都是设计启发;原文中的学习效果描述不构成本 skill 的实证依据。没有实证证明此 skill 能改善长期记忆或认知能力,流畅复述也不能代替新情境应用的证据。完整来源关系、费曼本人表述与流行四步法的区分,以及研究能支持的结论见 设计来源与证据边界。

欢迎通过 Issues 反馈具体学习情境,也欢迎提交 PR 改进指令和示例。请说明原有行为、期望行为与具体例子,并保留用户随时获得直接答案的选择。

The instructions and examples are written in Chinese; the skill asks the agent to use the learner's language. Share concrete learning scenarios in Issues or PRs. This is an instructional design, with no claim of proven long-term cognitive or memory benefits.

许可证 / License

MIT — Copyright (c) 2026 cliffffffffff. 外部链接所指文章和论文仍适用各自的版权与使用条款。

About

启发式学习 Agent Skill:先补背景与例子,用一个问题引导推理,再解释、纠错与迁移。Adaptive guided learning for unfamiliar concepts.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors