# ai-learning-coach

Adopt this skill: https://proskills.md/skills/productivity/sanhuang520-ship-it-awesome-chinese-ai-tools-skills-ai-learning-coach

Page: https://proskills.md/skills/productivity/sanhuang520-ship-it-awesome-chinese-ai-tools-skills-ai-learning-coach
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/ai-learning-coach/SKILL.md
size: 5797
sha: 49a6ed752b53ed6935d41f734fb30c442b684674
upstream: https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools/blob/main/skills/ai-learning-coach/SKILL.md

````text
---
name: ai-learning-coach
description: 用 AI 系统学习任何东西的教练。当用户要"学 XX""怎么入门""帮我制定学习计划""我想搞懂 XX""考证/备考""复习"时使用。不是直接讲答案，而是带着走完整的学习循环：定目标→输入→主动回忆→输出→纠错→间隔复习→项目交付。
metadata:
  author: sanhuang520-ship-it
  category: productivity
  tags: learning, education, chinese, productivity
---

# AI 学习教练

**核心区别：直接讲解 vs 让你真的学会。**

让 AI 讲一遍，你会觉得"懂了"，第二天忘光。这个技能做的是**带你走一遍完整的学习循环**，每一步都要你自己产出东西。

## 什么时候用

想学新技能、准备考试、入门新领域、读透一本书/一门课、把零散知识变成能力。

## 第一步：把"想学 X"变成可训练目标

用户说"我想学 Python"，这不是目标，是愿望。**必须先问清楚**（一次问完）：

1. **为什么学**（工作要用 / 转行 / 兴趣 / 应付考试）—— 决定深度和路径
2. **多久后要用上**（一周 / 一个月 / 三个月）—— 决定节奏
3. **现在什么水平**（零基础 / 看过教程 / 能写但不熟）
4. **每天能投入多久**（20 分钟和 2 小时是两种方案）
5. **怎么算学会了**（能做出什么？通过什么考试？）

然后**替他把愿望翻译成可检验的目标**：

| ❌ 愿望 | ✅ 可训练目标 |
|--------|-------------|
| 我想学 Python | 4 周内能独立写一个爬取指定网站数据并存成 Excel 的脚本 |
| 我想学英语 | 3 个月后能听懂 TED 演讲的 80%，不看字幕 |
| 我想懂 AI | 2 周内能说清楚 Transformer 的注意力机制，并跑通一个微调 demo |

> 目标必须有**产出物**和**验收标准**，否则学习没有终点，也没法判断进度。

## 核心：七步学习循环

每次学习会话都按这个走。**不要跳过第 2 步和第 5 步**，那是大多数人学不会的原因。

### 1️⃣ 输入材料
给出这轮要学的内容。控制体量——**一次只学一个概念**，讲太多等于没讲。

### 2️⃣ 主动回忆（最关键，不能跳）
讲完立刻合上材料，**让用户自己复述**：
> "先别看，用你自己的话说一遍：刚才那个概念解决的是什么问题？"

- 说得出来 → 进入下一步
- 说不出来 → **说明没懂**，换个角度重讲，不要往下走

> ⚠️ 这一步用户会想跳过（"我懂了，继续吧"）。**要坚持**。能"听懂"和能"复述"之间隔着一整个理解。

### 3️⃣ 分步讲解
针对回忆时卡住的地方，拆开讲。用类比，从他已知的东西出发。

### 4️⃣ 输出任务
给一个**必须动手**的小任务。不是选择题，是要产出东西：
- 学编程 → 写一段能跑的代码
- 学写作 → 写一段 200 字
- 学概念 → 用自己的话写一段解释，或画一张关系图

### 5️⃣ 反馈纠错（第二关键）
看他的产出，**指出具体问题 + 为什么错**，不是简单说"不对"。

重点是**归因**：
- 是概念没懂？
- 是粗心？
- 是知道但用不出来？

**不同的错因对应不同的补救**，这比重做十遍有用。

### 6️⃣ 间隔复习
本轮结束时，列出**下次开始时要考的 3 个问题**（来自本轮内容）。

节奏参考：第 2 天 → 第 4 天 → 第 7 天 → 第 15 天。

### 7️⃣ 项目交付
学到一定程度，**必须做一个完整的东西**。零散练习不等于能力。

## 场景模板

| 场景 | 常见误区 | 正确做法 |
|------|---------|---------|
| **学编程** | 跟着教程敲代码 | **做一个自己要用的小工具**，缺什么学什么 |
| **学写作** | 让 AI 代写 | 自己写 → AI 只做批注 → 你改 → 再批注（训练判断力） |
| **备考** | 刷题量堆积 | **建错因系统**：每道错题标原因，只补高频错因 |
| **行业研究** | 收集一堆资料 | 先建**判断框架**（这个行业靠什么赚钱？关键变量是什么？）再填资料 |
| **学语言** | 背单词 App 打卡 | 在**真实材料**里遇到→查→用出来，一周内用三次才算记住 |

## 一周执行模板（可选）

用户要计划时给：

```
周一  定目标 + 拆成 5 个小块
周二  学第 1-2 块 → 主动回忆
周三  学第 3-4 块 → 做输出任务
周四  纠错 + 补漏
周五  学第 5 块 + 迁移练习（换个场景用）
周末  复盘：哪些真会了？哪些还虚？下周调什么？
```

## 输出格式

每轮学习会话结束时，给一个**学习卡片**：

```
【本轮学了什么】
（一句话）

【你的产出】
（他做的东西 + 评价）

【暴露的问题】
1. XX 概念还没吃透 —— 表现是……

【下次开场要考】
1. ……
2. ……
3. ……

【下一步】
（具体到做什么，不是"继续加油"）
```

## 边界与提醒

1. **不替用户完成输出**。他让你直接写代码/写文章时，提醒他：这样学不会。可以给框架、给例子、给批注，但产出要他自己做。
2. **不确定的知识要说明**。技术细节、行业数据可能过时，提醒他去查一手资料（官方文档 / 论文 / 权威来源）。
3. **注意学术诚信**。用户在准备论文、考试、作业时，明确提醒相关规则，不代写。
4. **不做医学/法律/投资的专业指导**。可以帮他学习这些领域的知识框架，但涉及具体决策，建议咨询专业人士。
5. **进度诚实**。用户学得不好就说清楚，不要为了鼓励而假装他会了 —— 假的进度反馈会害了他。

## 参考

`references/error-log.md` —— 错因分析模板（备考/技能训练用）
````

## File: skills/ai-learning-coach/references/error-log.md
size: 2125
sha: 22e7ba9081d2c4c8f552b40289af8e480f619e68
upstream: https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools/blob/main/skills/ai-learning-coach/references/error-log.md

````text
# 错因分析模板

> 刷题刷不出成绩，是因为**没有分类错因**。同样是错，原因不同，补救方式完全不同。

---

## 错因五分类

| 错因 | 表现 | 补救方式 | 优先级 |
|------|------|---------|--------|
| **概念不清** | 不知道这题在考什么 | 回去补概念，**不要做同类题** | 🔴 最高 |
| **方法不会** | 知道考什么，不知道怎么下手 | 学解法套路 + 3 道同类题 | 🔴 高 |
| **计算/表达失误** | 思路对，过程错 | 限时训练 + 检查习惯 | 🟡 中 |
| **审题错误** | 看漏条件、理解偏 | 强制圈画关键词 | 🟡 中 |
| **纯粹粗心** | 会做，写错了 | 不用补，注意状态 | 🟢 低 |

> **关键**：60% 的人把"概念不清"当成"粗心"，然后继续刷题——这是无效努力。

---

## 错题记录表

| 日期 | 题目/知识点 | 我的答案 | 正确答案 | **错因分类** | 补救动作 | 复查日期 |
|------|-----------|---------|---------|------------|---------|---------|
| | | | | | | |

**填写要求**：

1. **错因必须具体**。写"不会"没有价值，要写"不知道什么时候用换元法"
2. **补救动作要可执行**。写"多练"没用，要写"做 P52 例 3-5 三道题"
3. **复查日期要写**。第 2 天、第 7 天各查一次

---

## 每周复盘

```
本周错题：__ 道

错因分布：
  概念不清 __ 道  ← 如果这项最多，说明学得太快，要回头
  方法不会 __ 道  ← 需要专项训练
  计算失误 __ 道  ← 需要限时练习
  审题错误 __ 道  ← 需要读题习惯
  粗心    __ 道  ← 忽略

高频错因 TOP 3：
1.
2.
3.

下周只补这 3 个，不要贪多。
```

---

## 一个提醒

**错题本最大的坑是"抄一遍就完了"。**

抄题 = 体力活，不产生学习。真正有用的是三件事：

1. **写清错因**（不是抄答案）
2. **隔天重做**（不看答案，能独立做出来才算过）
3. **一周后再查**（这时候还会，才是真会了）

如果时间有限，**只做第 2 件**：隔天重做错题，比抄十本错题本有用。
````

## File: README.md
upstream: https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools/blob/main/README.md

````text
<div align="center">

<img src="https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/assets/readme-banner.webp" alt="chinese-web-themes 的 4 套中式主题与 guofeng-threejs 水墨 shader 的真实渲染" width="100%">

# 中文 AI Skills 库

**13 个自己写的中文 Skill——用中文说人话，AI 就按规矩做事**

<sub>中文 Agent Skills 合集：可搜索、可安装、带实测证据 · Chinese Agent Skills / Chinese AI Skills directory with reproducible Codex evidence and explicit Claude Code / Cursor test gaps.</sub>

[English](README.en.md) · [English web guide](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/chinese-agent-skills/)

[![原创](https://img.shields.io/badge/本站原创-13%20个-86b894?style=flat-square)](EXAMPLES.md)
[![Skills](https://img.shields.io/badge/Skills-212%20个-e0795a?style=flat-square)](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/)
[![Weekly Check](https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools/actions/workflows/daily-check.yml/badge.svg)](https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools/actions/workflows/daily-check.yml)
[![License](https://img.shields.io/badge/License-MIT-83808d?style=flat-square)](LICENSE)

**[🌐 在线浏览与搜索](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/)**　·　[📦 安装与排错](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/install/)　·　[📋 看真实输出](EXAMPLES.md)　·　[🧪 看兼容性证据](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/compatibility/)

<sub>[📚 无 JavaScript？浏览完整静态目录](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/catalog/)</sub>

</div>

## 装一个，30 秒看到效果

```bash
npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill chinese-typography -g
```

重启客户端，然后**不要提 Skill 的名字**，直接把下面这段话丢给 AI：

> 请检查下面这段网页 CSS 的中文排版问题，只做审查，不修改文件。明确列出问题、理由和建议值：
> `body { font-family: Arial, sans-serif; font-size: 14px; line-height: 1.35; text-align: justify; word-break: break-all; }`

它应该指出行高偏小、`justify` 不适合中文、`break-all` 会截断英文单词，并给出建议值。
**如果它没有自动用上这个 Skill，那也是个有用的结果**——[按表单提交](https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools/issues/new?template=compatibility-result.yml)，成功和失败都收。

### 换一个场景试

只装一个当前需要的 Skill，重启客户端，然后直接说一条自然任务。不要在任务里写 Skill 名称，这样才能观察客户端是否会自动选择它。

| 你想试什么 | 安装 | 复制给 AI 的任务 | 本仓库记录 |
|---|---|---|---|
| 审查中文网页排版 | `npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill chinese-typography -g` | `请检查下面这段网页 CSS 的中文排版问题，只做审查，不修改文件。明确列出问题、理由和建议值：body { font-family: Arial, sans-serif; font-size: 14px; line-height: 1.35; text-align: justify; word-break: break-all; }` | [Codex 单任务实测](cases/chinese-typography-codex.md) |
| 整理一份不编数据的周报 | `npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill chinese-work-report -g` | `帮我把下面素材整理成给老板看的中文周报：本周修复了登录问题，做了两个页面；结果数据暂时没有；下周继续优化。请按结论先行组织，不要编造数字。` | [Codex 单任务实测](cases/chinese-work-report-codex.md) |
| 校对一版不编参数的商品文案 | `npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill ecommerce-copywriting -g` | `给一款普通保湿面霜写电商主图文案。已知只有：50g、无香型、89元。没有提供的参数、认证和功效不要编造；先列出可写、待补和不应发布的信息。` | [Codex 单任务实测](cases/ecommerce-copywriting-codex.md) |
| 制定不靠刷视频的学习计划 | `npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill ai-learning-coach -g` | `我想用两周入门 SQL，但不想再看完教程就忘。先了解我的目标和基础，再带我制定能动手练习的计划。` | [Codex 单任务实测](cases/ai-learning-coach-codex.md) |

这些任务在记录的 Codex 版本中发生过自动触发；它们不是“必定触发”的保证。若结果不同，请保留客户端版本和任务原文，按[兼容性实测表单](https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools/issues/new?template=compatibility-result.yml)提交成功或失败结果。

想先看有哪些：`npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --list`

---

> **和别的 awesome 列表有什么不一样**<br>
> ① 13 个 Skill 是我们自己写的，不是搬运<br>
> ② 不是只验证“能安装”：13/13 在 Codex 中自动触发，失败过程也公开<br>
> ③ 212 个 Skill 条目来自 164 个仓库，来源仓库**定期复检**一次还在不在（最近 2026-11-09），不转述无法复核的 AI 新闻

---

## ✍️ 本站原创 Skill（13 个）

这是这个仓库和其他 awesome 列表的区别：**下面这些是我们自己写的，不是搬运的。**

**[→ 按使用场景比较 13 个 Skill、实测状态和安全边界](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/guides/)**

**[→ 复制 7 条有逐字原文的首次测试任务](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/reproduce/)**（另外 6 条只有摘要，不反向补写）

**[→ 查看前瞻复测与修复闭环](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/retest/)**（6 条任务和门槛先公开；初次 4 条通过、2 条失败，针对性修复后两条用原任务均通过 4/4；旧失败不覆盖）

**[→ Agent Skill 测试失败后怎么修](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/fix-agent-skill/)**（不改题、不降门槛、不覆盖旧失败；含两条 3/4 → 4/4 的完整证据链）

**[→ 我们也测别人的 Skill](THIRD-PARTY-TESTING.md)**（只用对方自己声明的契约当标准；不打分、不排名）

**[→ 在一页选择全部 13 个首次试用任务](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/try-agent-skills/)**（单项安装、复制任务、历史证据或前瞻成功门槛）

| Skill | 做什么 |
|-------|--------|
| [`ai-learning-coach`](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/learning/) | 学习教练：先校准目标、基础、时间和验收标准，再进入主动回忆 → 输出 → 纠错归因 → 间隔复习；不直接代做学习产出 |
| [`book-digest-cn`](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/reading/) | 拆书三层法：作者在回答什么问题 → 核心主张与论证 → 我的行动、质疑和边界；不编造书中内容，不抄目录式笔记 |
| [`bookkeeping-cn`](skills/bookkeeping-cn/) | 记账整理。**明确不做**税务筹划、投资建议，不替代会计 |
| [`chinese-design-md`](skills/chinese-design-md/) | 中式 DESIGN.md 设计系统（本站原创）：8 套可直接丢进项目根目录的设计文档，AI 读了就按规范生成界面。含中文排版规则（行高 1.75 / 不用 justify / 着重号代替斜体 / CJK 避头尾），对比度逐项实测并标出不达标项 |
| [`chinese-lesson-plan`](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/lesson-plan/) | 中小学教案：先核对学段、教材版本和适用课标，再按核心素养、学习任务与评价证据组织目标；公开完整任务失败与缩小复测 |
| [`chinese-typography`](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/typography/) | 中文排版：中英间距、CJK 断行避头尾、字体栈、标点全半角，含错误对照与可直接复制的 CSS |
| [`chinese-web-themes`](skills/chinese-web-themes/) | 8 套中式网页主题（水墨/青绿/宋韵/敦煌/朱砂/新中式/竹韵/夜宴），对比度全过 WCAG AA |
| [`chinese-work-report`](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/work-report/) | 周报 / 述职 / 项目汇报，讲清楚做了什么、结果如何、下一步；没有结果数据时明确留空，不编数字 |
| [`ecommerce-copywriting`](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/ecommerce-copywriting/) | 电商文案上架前校样：区分可写、待补与不应发布；**不编造**材质、成分、认证、销量或功效 |
| [`github-readme-cn`](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/readme-audit/) | GitHub 中文项目门面优化（本站原创）：首屏结构、真实截图怎么截、命名与 topics、发布前自查清单。附 15 个高增长仓库的结构观察，明确区分相关性与不可验证的部分，不承诺涨星 |
| [`guochao-visual-cn`](skills/guochao-visual-cn/) | 12 种中国美学画风配方，输出可直接用的 AI 绘图提示词 |
| [`guofeng-threejs`](skills/guofeng-threejs/) | 国风 Three.js 渲染：水墨 shader 三技法。只做中式渲染，不做通用 Three.js 教程 |
| [`homework-tutor-cn`](https://sanhuang520-ship-it.github.io/awesome-chinese-ai-tools/homework/) | 家长辅导作业：**不生成给孩子直接抄写的成品**，先给引导话术，再单列家长核对结果；公开最终使用仍由人决定的边界 |

📋 **[看它们实际输出什么 → EXAMPLES.md](EXAMPLES.md)**

### 统一的设计原则：写清楚「不做什么」

写这些 skill 时最大的领悟是——**真正决定一个 skill 好不好用的，往往是它的边界。**

> 记账不做税务筹划 · 辅导作业不生成给孩子直接抄写的成品 · 学习教练不替你完成输出 · 国潮视觉不伪造文物

一个只写"能做什么"的 skill，用起来会发现它在你没问的地方也给意见，
在它不该确定的地方也很确定。

---

## 这是什么

**Skills 是给 AI 助手加的「专业技能包」。**

技术上就是一个文件夹 + 一份 `SKILL.md` 说明书，告诉 AI：什么时候该用、按什么步骤做。
支持 Skills 的客户端可以按任务自动激活；是否触发取决于客户端、版本、安装位置和任务措辞，需分别实测。

|  | 是什么 | 解决什么 |
|---|--------|---------|
| **Skills** | 一份工作说明书（Markdown + 可选脚本） | 教 AI **怎么做**某类任务 |
| **MCP** | 一个后台服务 | 让 AI **连上**外部系统（数据库、浏览器） |
| **插件** | 打包分发的组合 | 把 skills + MCP 打包一键装 |

---

## ⚠️ 一个实测发现：很多教程写的安装路径是错的

7 万星的 `awesome-claude-skills` 教你装到 `~/.config/claude-code/skills/`。
**我照做，装完没生效——那个目录在我这台 macOS 上根本不存在。**

用 Vercel Labs 的 `skills` CLI 实测（**1.5.23，2026-08-19 复测**）：

```bash
# 默认是「项目级」——装进你当前所在的那个目录，不是家目录
$ cd /tmp && npx skills add <repo> --skill <name>
✓ ./.agents/skills/<name>          # 落在 /tmp/.agents/skills/

# 要装成全局（用户级），必须加 -g
$ npx skills add <repo> --skill <name> -g
✓ ~/.agents/skills/<name>

$ ls -l ~/.claude/skills/
lrwxr-xr-x  <name> -> ../../.agents/skills/<name>   # 同级目录下的符号链接
```

CLI 帮助原文：`-g, --global  Install skill globally (user-level) instead of project-level`。
安装器会在同级的 `.claude/skills/` 建符号链接，所以两个路径能看到同一份文件。
**这只证明安装结果；本轮没有运行 Claude Code，不能据此声称自动触发。**

> **⚠️ 2026-08-19 更正**：这一节此前写的是「`npx skills add` 把文件装到 `~/.agents/skills/`」，
> 不准确。默认行为是装进**当前工作目录**；当初那次实测是在家目录下跑的，
> 于是把「当时的当前目录恰好是家目录」当成了「工具装到家目录」。
> 本次交叉验证：在 `/tmp` 下跑落在 `/tmp/
````
