这是一个用于个人 AI 学习的 pi 配置仓库,本质上是一个可直接作为 `.pi` 目录使用的学习系统模板。它把作者的 AI 辅助学习方法封装为技能、扩展和子 Agent,包括教学流程、提问弹窗、测验反馈、Markdown 日志、可视化图生成以及研究员/图表生成子代理。适合希望用 AI 构建个性化学习工作流的开发者参考或二次改造。
适用领域
AI 辅助学习 / Agent 工作流 / 个人知识管理 / 教育科技 / 开发者工具 / pi 配置与扩展 / 交互式学习系统
配置难度
中等。对于已经熟悉 pi、tmux 和 Agent 配置的开发者,上手较快;对于普通前端/后端开发者,需要先理解 pi 的目录结构、技能、扩展和子代理机制。如果只是克隆作为 `.pi` 使用较简单,但要稳定改造成自己的学习系统需要一定 Agent 工作流经验。
商业价值
该仓库更偏个人效率和学习系统模板,直接商业化价值有限,但对教育科技、AI Tutor、企业内部培训、开发者学习平台和个人知识管理产品有较高参考价值。它展示了如何把教学方法、交互提问、测验反馈、日志记录和多 Agent 可视化组合成一个可运行的学习工作流,可作为构建 AI 学习助手或企业培训 Agent 的原型。
01
技术亮点
- 结构清晰,按 skills、extensions、agents 分层组织,便于学习和改造。
- 开箱即用地提供一套 AI 学习流程,而不仅是零散 prompt。
- 支持交互式提问,让学习过程更接近一对一导师。
- 内置测验扩展,支持即时对错反馈、正确答案和解释。
- 支持 Markdown 日志,方便沉淀学习记录。
- 提供可视化子代理,可生成 SVG 或 Mermaid 图示辅助理解。
- 允许主 Agent 委派 researcher 子代理进行信息验证,提高学习内容可靠性。
- README 明确说明可裁剪使用,适合复制部分模块到已有 pi 配置。
02
目标用户
- 希望用 AI 系统化学习技术主题的开发者
- 正在使用或准备使用 pi 的用户
- 想搭建个人 AI Tutor / AI 教练的学习者
- 对多 Agent 协作、子代理、工具调用感兴趣的工程师
- 希望把学习过程记录到 Markdown 的知识管理用户
- 希望参考 AI 学习提示词和教学流程设计的人
03
配置要求
- 必须依赖 pi 运行,本仓库本身就是一个 `.pi` 配置目录。
- 完整功能需要支持 subagent 的实现,用于启动 researcher、svg-maker、mermaid-maker 等子代理。
- 推荐使用 pi-interactive-subagents,但该实现仅适用于 tmux 环境。
- 如果使用其他子代理实现,可能需要修改 agents 目录下的 agent 定义,例如 researcher.md 中使用的 safe_bash 工具是特定扩展相关的。
- ask-user-question 扩展建议使用仓库自带版本,否则不同弹窗扩展之间的 UI lock 可能无法正常串行化。
- 没有子代理也可以运行,但会失去研究员事实验证和自动可视化生成能力。
- 教学技能是作者按个人学习偏好编写的,实际使用前建议根据自己的学习方式修改 skills/teach。
04
适用场景
- 搭建一个基于 pi 的个人 AI 学习环境
- 让 AI 根据教学技能引导用户学习一个新概念
- 通过 UI 弹窗让 Agent 主动向学习者提问
- 生成带即时反馈的测验题,用于巩固知识
- 将学习会话链接到 Markdown 文件,形成学习笔记
- 调用 researcher 子代理进行事实核查或资料研究
- 调用 svg-maker 或 mermaid-maker 子代理生成简洁图示辅助理解
- 作为模板修改教学哲学、Agent 定义和扩展逻辑,构建自己的学习系统
05
部署与配置
- 确保本地已安装并可运行 pi:https://github.com/earendil-works/pi
- 进入你的学习项目根目录。
- 执行命令:git clone https://github.com/amosblomqvist/learn .pi
- 在该目录中打开并运行 pi。
- 如果已有自己的 pi 配置,也可以只复制需要的 skills、extensions 或 agents 到现有项目配置中。
- 如需完整功能,安装或配置子代理实现,推荐使用 pi-interactive-subagents。
- 如已有 ask-user-question 扩展,建议替换为本仓库内置版本,以保证 UI 弹窗锁机制一致。
06
风险与注意事项
- 项目是作者个人系统,声明为 shared as-is,通用性和稳定性可能有限。
- 强依赖 pi 生态,对未使用 pi 的开发者门槛较高。
- 完整体验依赖子代理实现,且推荐方案 pi-interactive-subagents 限定 tmux,Windows 或非 tmux 用户可能需要额外适配。
- 仓库没有明确 license,商业使用、分发或深度复用存在授权不确定性。
- TypeScript 占比虽标记为主语言,但仓库核心可能更多是配置、Markdown 技能和扩展,不能按常规 TypeScript 应用理解。
- 教学技能针对作者个人学习方式设计,直接使用未必适合所有人。
- 部分 agent 工具定义可能绑定特定扩展,例如 safe_bash,迁移到其他环境可能报错。
- 事实验证和可视化依赖 Agent 行为和模型质量,不能完全替代人工判断。
2026-08-27
第21名
新收录 · github_search