1. 项目概述一个能让你真正学会编程的AI伙伴如果你用过Cursor、Claude Code或者GitHub Copilot这类AI编程助手大概率有过这样的体验你抛出一个问题它瞬间给你一段完美的代码。你复制粘贴程序跑起来了那一刻你感觉自己“会了”。但一周后当你要自己从头实现一个类似功能时大脑却一片空白。这种“我懂了”的错觉在认知科学里有个专门的名字叫做“能力错觉”。我们的大脑很容易把“阅读流畅性”误认为是“掌握程度”——就像反复阅读笔记的学生总比那些通过自我测试来学习的学生感觉更自信但实际考试成绩却往往更差。agentic-learning这个项目就是为了对抗这种“能力错觉”而生的。它不是一个普通的代码生成工具而是一个基于神经科学和认知心理学原理设计的“学习型技能包”。简单说它给你的AI编程助手Agent装上了一套“教学大脑”让它从一个“有求必应的答题机”转变为一个“引导你思考的教练”。它的核心目标不是帮你更快地写完代码而是确保你在写代码的过程中真正理解背后的原理构建起扎实、持久的知识体系。这个技能包适用于所有兼容 AgentSkills 标准的AI编程助手比如 Cursor、Claude Code、Windsurf、GitHub Copilot 等。无论你是编程新手希望打下坚实基础还是经验丰富的开发者想要深化对某个复杂系统如一个新的框架或算法的理解agentic-learning都能通过一系列结构化的互动让你从被动的代码消费者变为主动的知识构建者。2. 核心理念与科学基础为什么“费力”才是真学习在深入使用之前理解agentic-learning背后的科学理念至关重要。这能让你明白为什么它设计的交互方式看起来有点“反直觉”——不直接给答案反而让你先解释、先尝试、先犯错。2.1 对抗“能力错觉”从流畅感到掌握度我们的大脑天生喜欢省力。当AI给出一个结构清晰、语法正确的答案时我们处理这些信息非常“流畅”这种流畅感会欺骗我们让我们误以为自己已经理解了。agentic-learning的核心策略就是主动打破这种流畅感引入“合意难度”。它通过让你“生成”答案即使可能是错的、进行“检索练习”主动回忆等方式增加学习过程的认知负荷从而将信息从短期记忆“挤压”进长期记忆。2.2 九大学习科学支柱项目文档中提到了九种经过实证检验的学习技巧它们构成了所有交互动作的理论基石。理解这些你就能更好地运用每一个功能检索练习主动从记忆中提取信息远比被动重复阅读有效。这是quiz测验和explain-first你先解释动作的核心。间隔重复将学习内容分散在多个时间段进行复习效果远好于一次性填鸭式学习。space间隔计划动作就是为此而生。生成效应尝试自己产生一个答案哪怕不完全正确比单纯阅读一个现成答案能建立更强的记忆痕迹。learn你先学和struggle挣扎阶梯完美体现了这一点。反思对学习过程、目标达成情况和知识缺口进行结构化思考。reflect反思和either-or二选一决策引导你进行元认知。交错练习混合练习不同主题或类型的问题比长时间死磕单一主题效果更好能提升知识的辨别和迁移能力。interleave交错测验专门为此设计。认知负荷管理人的工作记忆容量有限。cognitive-load认知负荷动作会将一个复杂概念分解成适合工作记忆的小块逐步讲解。元认知对“自己如何学习”的觉察和调控。整个agentic-learning的使用过程都在培养这种能力。口语表达用自己的话阐述想法能暴露出仅靠内心检索无法发现的认知漏洞。explain-first强制你进行这一步。形成性反馈关注学习过程和目标的反馈而非简单的对错判断。learn和struggle中的提示和纠正都遵循这一原则。实操心得不要把这些动作当成任务去完成而是把它们视为一套“学习健身器械”。就像健身需要组合不同的器械来锻炼不同肌群一样组合使用这些动作才能全方位锻炼你的“认知肌群”。例如在学习一个新库时可以先learn然后用quiz自测几天后用space安排复习并在实际编码中穿插使用explain-first来巩固。3. 核心动作深度解析与使用指南agentic-learning提供了多个动作每个都针对特定的学习场景。下面我将逐一拆解其设计意图、最佳使用场景和实操中的细微技巧。3.1learn以教为学暴露认知盲区触发命令agentic-learning learn 主题这是最核心的动作之一。它的流程不是你问它答而是反过来的你先向AI解释你对某个主题的理解。比如你想学“Python的装饰器”你应该先组织语言告诉AI你认为装饰器是什么、怎么用、解决了什么问题。AI会做什么首先它会倾听阅读你的解释。然后它会指出你解释中的正确部分、模糊之处以及错误。最后它会填补你缺失的知识提供一个更完整、准确的解释。为什么有效这强制你进行“生成”和“口语表达”。在组织语言的过程中你必须主动梳理脑海中的知识网络这本身就是一个强大的学习过程。而AI的纠正则提供了精准的“形成性反馈”。注意事项很多用户一开始会感到尴尬或困难觉得“我要是会还用问你吗”这正是关键——你不需要“完全会”只需要有初步的、可能片面的理解。哪怕你的解释漏洞百出这个过程的价值也已经产生了。关键在于开始“说”出来。3.2quizinterleave主动检索巩固记忆触发命令agentic-learning quiz针对当前文件或最近讨论的主题生成测验题。agentic-learning interleave混合多个相关主题生成更复杂的测验题。quiz是一个标准的检索练习工具。AI会根据上下文比如你正在编辑的代码文件生成选择题、填空题或简答题。你必须从记忆中提取答案而不是去翻看文档。interleave是quiz的进阶版。例如你最近学习了“列表推导式”、“lambda表达式”和“map/filter函数”。interleave生成的题目可能会混合这些概念要求你在不同情境下辨别和应用它们。这种“混淆”能极大提升学习深度和灵活性。使用技巧定时使用在结束一个编码会话前运行一次quiz作为本次学习的“结业考试”。用于复习打开一周前写的老代码文件运行quiz看看自己还记得多少。挑战模式对于自认为掌握牢固的主题使用interleave来检验是否真的达到了融会贯通。3.3struggle挣扎阶梯在求助前榨干自己的思考触发命令agentic-learning struggle 具体任务这是我最欣赏的功能它完美模拟了资深工程师辅导新人的过程。比如你输入agentic-learning struggle 写一个函数来解析这个JSON配置文件并验证必填字段。AI不会直接给你代码而是会搭建一个“提示阶梯”第一级提示最抽象可能会问你“要处理JSON你首先需要导入什么库这个库里哪个方法负责将字符串转化为Python数据结构”如果你说“more hints”它会给出第二级提示稍微具体一点比如“考虑一下解析后你得到一个字典。你打算用什么方法来检查‘必填字段’是否都存在是直接使用if key in dict还是用dict.get()”第三级提示会更进一步可能涉及错误处理“如果字段缺失你希望函数返回什么是抛出异常还是返回一个包含错误信息的元组”只有当你再次请求提示或直接说“show me”时它才会给出完整的解决方案。设计哲学这个过程的目的是让你在“完全不会”和“直接抄答案”之间尽可能长时间地保持“productive struggle”有成效的挣扎。这种挣扎是形成深刻理解的关键。每一次你根据提示自己推演出一点进展都是对知识网络的一次强力加固。3.4explain-firstreflect培养元认知与表达力触发命令agentic-learning explain-first在AI解释代码前你先口头叙述一遍代码的功能和逻辑。agentic-learning reflect进行结构化反思学到了什么、下一步目标、还存在什么缺口。explain-first特别适合用在阅读他人代码或回顾自己旧代码时。强迫自己先解释经常会发现“我以为我懂但一说就卡壳”的地方。这比单纯让AI注释代码有效得多。reflect动作则是一个强大的学习闭环工具。它引导你回答三个问题我刚刚学到了什么巩固收获我接下来的学习/编码目标是什么明确方向我意识到自己还有哪些知识缺口发现盲点定期进行这种结构化反思能让你从无意识的“埋头苦干”模式切换到有策略的“持续成长”模式。3.5spacecognitive-load规划学习与分解难题触发命令agentic-learning space将当前学习的概念标记安排在未来某个时间点复习。AI会写入docs/revisit.md文件。agentic-learning cognitive-load 复杂主题将一个令人望而生畏的大主题分解成一系列小步骤。space利用了“间隔效应”。当你学完一个难点比如理解了React Hooks的闭包陷阱运行这个命令。AI会帮你记录并建议在1天、1周、1个月后回顾。docs/revisit.md就成了你的个人化复习日程表。cognitive-load则是面对庞杂知识时的“破冰锤”。例如agentic-learning cognitive-load Docker容器网络模型。AI不会一股脑地扔出所有概念而是会像这样分解第一步理解单个容器内部的网络栈localhost。第二步理解默认的桥接网络以及容器间如何通过容器名通信。第三步理解用户自定义网络及其优势。第四步理解端口映射-p参数如何连接容器和主机。第五步理解更复杂的Overlay网络用于Swarm/K8s。这种分解符合人类工作记忆的限度让学习过程变得可控。3.6brainstormeither-or设计思维与决策记录触发命令agentic-learning brainstorm 设计想法围绕一个想法展开设计对话记录到docs/brainstorm/。agentic-learning either-or 决策问题记录一个两难决策的双方论据写入docs/decisions/。brainstorm不仅记录最终方案更记录思考过程。AI会以对话形式引导你思考不同方案的优势、权衡和潜在风险。生成的Markdown文档是宝贵的设计文档。either-or的哲学意味很浓它源于克尔凯郭尔。在软件开发中我们每天都在做小决策用A库还是B库先做X功能还是Y功能。这个动作强迫你写下正反两方面的理由。几个月后回看这些记录不仅能帮你复盘决策质量更能让你看清自己技术决策的偏好和模式。3.7explain构建项目知识图谱触发命令agentic-learning explain这个动作会让AI智能读取并分析你当前项目的代码库然后生成或更新一份docs/project-knowledge.md文件。这份文件不是简单的目录树而是AI理解后的项目概述、核心模块解析、关键依赖关系和数据流说明。最佳实践在接手一个遗留项目或者一个自己很久没碰的项目时首先运行这个命令。它能帮你快速重建上下文比盲目阅读代码高效得多。你也可以定期运行将此文件作为项目动态更新的“活文档”。4. 安装与配置实战详解agentic-learning的安装非常灵活支持多种方式。你需要根据自己使用的AI助手Agent类型来选择。4.1 环境准备与概念澄清首先明确两个安装目录的概念工作区安装技能仅对当前项目目录生效。技能文件会安装在当前项目的.agents/skills/目录下。这是最常用的方式便于项目管理。全局安装技能对你的整个系统所有项目生效。技能文件会安装到AI助手指定的全局目录例如Claude Code的~/.claude/skills/。你的AI助手必须兼容AgentSkills标准。目前主流的如 Cursor、Claude Code、Windsurf、GitHub Copilot (Cursor模式) 等都兼容。你可以在 agentskills.io 查看完整列表。4.2 安装方法选择与步骤方法一使用npx skillsCLI最推荐这是官方推荐的最简单方法前提是你的系统已安装Node.js和npm。# 在当前项目目录下执行 npx skills add FavioVazquez/agentic-learning这条命令会自动检测你的环境并将技能安装到正确的位置通常是工作区目录.agents/skills/。安装后重启你的AI助手如Cursor或Claude Code技能就应该可用了。方法二使用curl一键安装脚本这个方法通用性最强不依赖Node.js通过下载并执行GitHub上的安装脚本完成。# 1. 工作区安装最常用 curl -fsSL https://raw.githubusercontent.com/FavioVazquez/agentic-learning/main/install.sh | bash # 2. 全局安装对所有项目生效 # 针对 Claude Code curl -fsSL https://raw.githubusercontent.com/FavioVazquez/agentic-learning/main/install.sh | bash -s -- --global --agent claude # 针对 Windsurf curl -fsSL https://raw.githubusercontent.com/FavioVazquez/agentic-learning/main/install.sh | bash -s -- --global --agent windsurf # 通用全局回退路径 curl -fsSL https://raw.githubusercontent.com/FavioVazquez/agentic-learning/main/install.sh | bash -s -- --global # 3. 卸载技能 curl -fsSL https://raw.githubusercontent.com/FavioVazquez/agentic-learning/main/install.sh | bash -s -- --uninstall方法三手动git clone适合喜欢完全手动控制或处于网络受限环境的用户。# 工作区安装 git clone --depth 1 https://github.com/FavioVazquez/agentic-learning .agents/skills/agentic-learning # 全局安装 - Claude Code git clone --depth 1 https://github.com/FavioVazquez/agentic-learning ~/.claude/skills/agentic-learning # 全局安装 - Windsurf git clone --depth 1 https://github.com/FavioVazquez/agentic-learning ~/.codeium/windsurf/skills/agentic-learning注意事项安装完成后必须重启你的AI助手应用如关闭Cursor或Claude Code窗口再重新打开它才能加载新安装的技能。如果技能未生效首先检查技能是否被安装到了正确的路径。你可以查看AI助手的官方文档确认其读取技能的标准路径是什么。4.3 验证安装与初步测试安装并重启后你可以通过一个简单命令来测试技能是否加载成功。在你的AI助手聊天框中输入agentic-learning help或者尝试一个简单动作agentic-learning quiz如果AI助手能识别该命令并开始与你互动例如开始出题说明安装成功。如果提示“未知命令”请检查安装路径是否正确并确认已重启AI助手。5. 实战工作流将技能融入日常开发单独使用某个动作有效但将它们组合成一个连贯的工作流才能最大化agentic-learning的价值。下面我以学习一个新技术栈例如学习用FastAPI构建后端API为例展示一个完整的学习周期。5.1 阶段一初期探索与概念构建启动与概览新建一个项目目录运行agentic-learning explain。虽然项目是空的但你可以让AI基于你的目标“学习FastAPI”生成一个初始的docs/project-knowledge.md列出学习路径和核心概念。主动学习核心概念针对关键概念如“依赖注入”、“Pydantic模型”、“路径操作装饰器”使用agentic-learning learn 概念。务必自己先尝试解释哪怕只是只言片语。分解复杂主题如果觉得“FastAPI中间件和依赖注入的关系”很复杂使用agentic-learning cognitive-load FastAPI中间件与依赖注入的关系让AI帮你拆解。5.2 阶段二动手实践与深度互动边写边学开始编写第一个路由。在写app.get(“/)之前先对着一行注释或空函数运行agentic-learning explain-first强迫自己说出你打算怎么写、为什么这么写。遇到难题时使用“挣扎阶梯”当卡在“如何验证请求体”时不要直接搜索答案。输入agentic-learning struggle 实现一个验证用户注册信息的POST端点。跟着AI的提示阶梯一步步思考。及时进行设计讨论在决定使用SQLAlchemy还是Tortoise-ORM作为异步ORM时使用agentic-learning brainstorm 为FastAPI项目选择异步ORM。让AI引导你记录下权衡过程生成docs/brainstorm/下的文档。5.3 阶段三巩固、反思与规划每日/每周小测每天编码结束时对当天接触的主要概念运行agentic-learning quiz。每周结束时运行agentic-learning interleave混合测试路由、模型、依赖等多个主题。结构化反思在完成一个功能模块如用户认证模块后运行agentic-learning reflect。认真回答三个问题把“知识缺口”记录下来。安排间隔复习对反思中发现的薄弱点或者quiz中答错的概念使用agentic-learning space将其加入复习计划。docs/revisit.md文件会成为你的学习指南。记录关键决策在项目中选择了一个有争议的方案例如用JWT而非Session做认证使用agentic-learning either-or 选择JWT而非Session-Cookie做认证。记录下这个决策以备日后复盘。5.4 生成的项目文档结构遵循这个工作流你的项目目录下会自然生长出一套宝贵的个人学习文档your-project/ ├── .agents/ │ └── skills/ # agentic-learning技能安装在这里 ├── docs/ # **你的学习资产库** │ ├── brainstorm/ │ │ └── 2023-10-27-async-ORM-choice.md │ ├── decisions/ │ │ └── 2023-10-28-auth-method-decision.md │ ├── project-knowledge.md # 不断更新的项目理解 │ └── revisit.md # 个性化的复习时间表 └── (你的源代码文件...)这些文档的价值远超普通的代码注释。它们记录了你的思考过程、决策理由和认知演变是真正属于你的“第二大脑”外挂。6. 高级技巧与疑难排查6.1 如何定制化技能行为agentic-learning的技能逻辑定义在其安装目录的skill.json和相应的提示词模板文件中。高级用户可以通过修改这些文件来微调AI的行为。例如你觉得quiz的题目太简单可以找到生成问题的提示词部分增加“生成更具挑战性、涉及边界条件的问题”的指令。但是强烈建议先熟悉默认行为。这些默认设置是基于大量学习科学文献优化过的。在你有明确且合理的个性化需求如适配公司内部技术栈的测验时再考虑修改。6.2 常见问题与解决方案问题现象可能原因解决方案输入命令无反应1. 技能未安装到正确路径。2. AI助手未重启。3. 命令格式错误。1. 检查.agents/skills/或对应的全局目录下是否存在agentic-learning文件夹。2. 完全关闭并重新打开Cursor/Claude Code等。3. 确保命令前缀正确如agentic-learning learn Python装饰器。AI回复不符合预期如直接给答案1. AI助手自身的“性格”或设置过于主动。2. 技能提示词未被正确加载或覆盖。1. 检查AI助手是否有“自动补全”或“过于积极”的模式尝试将其调至更中性的协作模式。2. 尝试在命令中更明确地要求例如agentic-learning struggle 任务请严格按照阶梯提示进行。space或explain生成的文件位置不对技能的工作目录判断有误。确保你在正确的项目根目录下运行命令。这些命令生成的文件总是相对于你运行命令时的当前目录。感觉流程繁琐想跳过不习惯“费力”的学习模式仍处于“追求流畅感”的旧习惯中。这是最需要克服的一点。给自己设定小目标比如今天在求助前至少使用一次struggle并坚持到第二级提示。习惯的养成需要时间但认知收益是巨大的。6.3 与其他工具和习惯的整合与笔记软件结合将docs/project-knowledge.md和docs/brainstorm/下的内容定期整理到你的Obsidian、Logseq或Notion知识库中形成跨项目的知识网络。与待办事项结合docs/revisit.md中的复习项可以手动或通过脚本同步到你的日历或Todoist等GTD工具中确保执行。团队共享学习在团队技术分享或代码评审前鼓励大家使用explain-first来准备讲解内容。使用either-or记录重要的技术决策并放入团队文档作为决策上下文存档。7. 理念升华从工具依赖到认知自主使用agentic-learning一段时间后我最大的体会是它不仅仅是一个AI技能更是一种思维训练。它强迫我改变与AI交互的默认模式——从“索取答案”变为“引导思考”。这种转变的初期确实需要额外的意志力就像健身初期肌肉会酸痛一样。但一旦习惯养成你会发现自己对技术的理解深度、解决问题时的独立思考能力、以及知识留存率都有了显著提升。AI从此不再是让你思维懒惰的“拐杖”而是真正放大你认知能力的“杠杆”。你不再只是知道某个API怎么调用而是理解它为何这样设计在什么场景下更优以及它如何融入更大的技术图景。最终这个技能的目标是让自己变得不再那么需要它。当你内化了“先解释”、“先尝试”、“多反思”、“有计划地复习”这些元学习策略后即使在没有这个技能辅助的日常学习和工作中你也能自觉地运用这些方法成为一个更高效、更自主的终身学习者。这或许就是agentic-learning这个项目在提供实用工具之外带给我们的更深层礼物。