Skip to content
Back to search

ai-learning-coach

AI private learning coach for Codex: learn through real projects, adaptive dialogue, debugging, evidence-based mastery, and visible progress.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chrichuang218--ai-learning-coach/badge.svg)](/listings/chrichuang218--ai-learning-coach)

HTML

<a href="/listings/chrichuang218--ai-learning-coach"><img src="/api/listings/chrichuang218--ai-learning-coach/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

codex plugin marketplace add chrichuang218/ai-learning-coach
codex plugin add ai-learning-coach@ai-learning-coach

使用 Claude Code:

claude plugin marketplace add chrichuang218/ai-learning-coach
claude plugin install ai-learning-coach@ai-learning-coach

Cursor、Gemini CLI 等其他 Agent 可以只装 Skill,见 [安装说明](docs/install.md#其他-agentcursorgemini-cliopencode-等)。

安装后**新开一个会话**,直接说:

我会 Java,想通过真实 Agent 项目学习 TypeScript。帮我选择第一个源码入口,然后带我开始。

已有项目时把路径一起发给教练,就从你的项目开始。没有项目时,教练会从 [起步路线](plugins/ai-learning-coach/skills/learning-coach/STARTER-TRACKS.md) 中选一个真实仓库(TypeScript Agent、Python、Go、前端、Rust);也可以先试 [缓存失效首次体验](examples/first-session/README.md):固定真实源码版本、一个可运行测试、一个下一入口,学习预算约 15 分钟。

状态工具(记录证据、到期复习、周复盘、自动计算进度)通过 [uv](https://docs.astral.sh/uv/) 启动,装好 uv 即可,依赖会自动准备;没有 uv 时,普通 Skill 教学通过文件工具照常进行。完整的环境、skills.sh 分发区别和排障见 [安装说明](docs/install.md)。

公共命令安装远端发布版本。本版包含首次体验与可选状态工具;开发者可用隔离环境验证本地源码:

python scripts/release_smoke.py

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "ai-learning-coach",
  4. "description": "AI private learning coach skills for real-project learning.",
  5. "owner": {
  6. "name": "chrichuang218"
  7. },
  8. "plugins": [
  9. {
  10. "name": "ai-learning-coach",
  11. "description": "Learn through real projects with a coach that remembers evidence, schedules reviews and shows progress.",
  12. "source": "./plugins/ai-learning-coach",
  13. "category": "learning"
  14. }
  15. ]
  16. }
README.md · README · 102 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # AI Learning Coach
  2. [![GitHub stars](https://img.shields.io/github/stars/chrichuang218/ai-learning-coach?style=social)](https://github.com/chrichuang218/ai-learning-coach/stargazers)
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  4. [![Validate skills](https://github.com/chrichuang218/ai-learning-coach/actions/workflows/validate.yml/badge.svg)](https://github.com/chrichuang218/ai-learning-coach/actions/workflows/validate.yml)
  5. [English](README.en.md) · [第一次体验](examples/first-session/README.md) · [安装说明](docs/install.md)
  6. **用真实 Agent 项目学会 TypeScript。教练记住你卡在哪里,带你预测、调试、修改,并用实际证据判断下一步。**
  7. 首要面向已经会 Java 或其他后端语言、希望进入 TypeScript / Agent 开发的开发者。你不需要先设计课程、挑文件或整理学习档案;教练先读项目,再给一个当前能动手的切片。
  8. <p align="center">
  9. <img src="assets/product/coaching-session.png" alt="教练围绕真实 TypeScript Agent 源码逐步讲解,用户在同一现场提问和调试" width="100%">
  10. </p>
  11. ## 一分钟看懂
  12. | 当你…… | 教练会…… |
  13. | --- | --- |
  14. | 想开始,但不知道读哪里 | 根据背景和真实源码选择一个可观察的小任务 |
  15. | 当场答对,隔天却讲不清 | 找到丢失的关系,调整讲法和掌握判断 |
  16. | 亲自跑通了教练给的测试 | 记录执行证据,保留“独立设计测试”这个待验证边界 |
  17. | 过几天回来继续 | 读取最近证据、核对当前源码,从正确入口接上 |
  18. [观看学习过程重演](docs/demo.md):预测 → 观察 → 记录帮助程度 → 下一次继续。重演用于展示流程,不代表新用户试用结果。
  19. ![48 秒缓存学习过程重演](assets/product/learning-loop.gif)
  20. ## 安装,然后开始
  21. ```bash
  22. codex plugin marketplace add chrichuang218/ai-learning-coach
  23. codex plugin add ai-learning-coach@ai-learning-coach
  24. ```
  25. 使用 Claude Code:
  26. ```bash
  27. claude plugin marketplace add chrichuang218/ai-learning-coach
  28. claude plugin install ai-learning-coach@ai-learning-coach
  29. ```
  30. Cursor、Gemini CLI 等其他 Agent 可以只装 Skill,见 [安装说明](docs/install.md#其他-agentcursorgemini-cliopencode-等)。
  31. 安装后**新开一个会话**,直接说:
  32. ```text
  33. 我会 Java,想通过真实 Agent 项目学习 TypeScript。帮我选择第一个源码入口,然后带我开始。
  34. ```
  35. 已有项目时把路径一起发给教练,就从你的项目开始。没有项目时,教练会从 [起步路线](plugins/ai-learning-coach/skills/learning-coach/STARTER-TRACKS.md) 中选一个真实仓库(TypeScript Agent、Python、Go、前端、Rust);也可以先试 [缓存失效首次体验](examples/first-session/README.md):固定真实源码版本、一个可运行测试、一个下一入口,学习预算约 15 分钟。
  36. 状态工具(记录证据、到期复习、周复盘、自动计算进度)通过 [uv](https://docs.astral.sh/uv/) 启动,装好 uv 即可,依赖会自动准备;没有 uv 时,普通 Skill 教学通过文件工具照常进行。完整的环境、skills.sh 分发区别和排障见 [安装说明](docs/install.md)。
  37. 公共命令安装远端发布版本。本版包含首次体验与可选状态工具;开发者可用隔离环境验证本地源码:
  38. ```bash
  39. python scripts/release_smoke.py
  40. ```
  41. ## 进展有依据,回来能继续
  42. 学习档案称为 **Learning Lab**:你自己的 Markdown 文件,可按需创建,无需安装第二个产品。
  43. - **使命**:你想独立完成什么。
  44. - **证据**:你的预测、解释、Run、Debug 或修改,以及获得了多少帮助。
  45. - **当前状态**:已能做到什么、还需验证什么、下一处真实入口。
  46. - **稳定知识**:值得复习的结论,可被 Obsidian 等工具继续使用。
  47. 打卡记录节奏,能力来自证据。百分比只是约定里程碑的汇总,由工具计算,证据不足时工具会拒绝升级;需要复验的边界到期后,教练会在下次开始时先带你回忆。中文和英文档案都能读取。
  48. [查看本地进度页与诊断工具](docs/learning-lab.md) · [单轨道初始示例](examples/workspaces/first-session/README.md) · [多轨道示例](examples/workspaces/minimal-multitrack/README.md)
  49. ## 一个插件,两个教练
  50. | 你当前的请求 | 负责的 Skill |
  51. | --- | --- |
  52. | 开始、继续、这行没懂、怎么 Debug、学完了 | learning-coach:日常学习与证据记录 |
  53. | 方向太多、先学什么、是否继续投入 | focus-coach:阶段目标与主线取舍 |
  54. 中文优先;可明确要求其他语言。写作、语言、考试、研究等扩展方法见 [跨领域示例](examples/cross-domain-sample-outputs.md)。当前最完整的实战材料集中在源码学习。
  55. ## 验证和参与
  56. 已有静态校验、隔离安装冒烟、两种宿主启动配置下的 MCP 全工具冒烟,以及可按需运行的自动行为评估(12 个场景,见 [评估与复现](evals/README.md))。真人首次完成率与七日复用仍待自愿试用反馈,不用 Star 或文件数量代替。
  57. ```bash
  58. python -m pip install pyyaml
  59. python scripts/validate_repo.py
  60. python -m unittest discover -s tests -v
  61. ```
  62. [第一次使用成功了或卡住了?](https://github.com/chrichuang218/ai-learning-coach/issues/new?template=first_experience.yml) 只需告诉我们你的场景和做到哪一步。
  63. [使用与设计指南](docs/guide.md) · [评估与复现](evals/README.md) · [贡献](CONTRIBUTING.md) · [更新记录](CHANGELOG.md)
  64. ## 致谢
  65. 受到 Matt Pocock 的 [teach Skill](https://github.com/mattpocock/skills/blob/main/skills/productivity/teach/SKILL.md) 启发,并根据真实长期学习反馈演进。感谢 [LINUX DO](https://linux.do/) 社区的支持与讨论。
  66. [MIT License](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.