前言¶
很多开发者第一次接触 Agent，会先装 LangChain、CrewAI 一类框架，把 ReAct、工具调用包在抽象层里。能跑通 demo，但改一行逻辑就要翻文档，也不清楚「循环里到底发生了什么」。若你的目标是手搓一个最小可运行的 Agent，并一路做到更复杂的形态，框架教程往往对不上这条路径。
下面介绍 SkillHub 上的 build-your-own-agent：社区来源（user_00c9b356）的教育类 Skill，版本 1.0.1，用 10 关课程把心智模型讲清楚，再从约 80 行的极简 Agent 写到自进化 Agent；技术栈是 纯 Python + Claude API，不依赖 Agent 框架。
这是什么¶
build-your-own-agent 在 SkillHub 上的坐标是 @user_00c9b356/buddy-build-your-own-agent，分类为 education。它不是替你生成业务 Agent 的脚手架工具，而是一套挂在 AI 助手里的渐进式 Agent 构建课程：在对话里学原理、写代码、查进度、对照参考实现。
官方简介与页面一致：10 关、无框架、Claude API。Skill 标签为 requires_api_key=false（指 Skill 本身安装不要求在 SkillHub 侧配置 API Key）；课程内容仍围绕 Claude API 编写 Agent，运行示例代码时你需要自行准备可用的 Claude API 访问方式。
核心功能¶
以下能力均来自 SkillHub 页面与 API 元数据，未展开未列出的关卡细目。
10 关渐进式课程¶
课程从 心智模型 起步，终点是 自进化 Agent。路径强调「自己写循环、自己接工具」，而不是套用 LangChain 等封装。具体每一关的标题与作业说明在启用 Skill 后由课程引导给出，此处不臆造关卡名单。
四种教学模式¶
同一套内容可按习惯选学习方式：
- 自由探索：按自己的节奏翻关、试代码。
- 导师引导：由 Skill 以导师方式推进讲解与答疑。
- 挑战模式：在约束下完成关卡目标。
- 速通：压缩讲解，适合已有基础的复习或快进。
11 个参考实现文件¶
Skill 提供 11 个参考实现文件，对应各关的完整代码及设计决策说明。学某一关卡住时，可对照参考实现理解「为什么这样拆模块、循环怎么收口」，而不是只抄一段能跑的脚本。
进度追踪¶
内置 进度追踪系统，适合长周期学习。在对话里询问「我的进度」「agent 学习路线」等，Skill 会按触发规则响应，避免你手动记关数。
安装与启用¶
SkillHub 官方页面要求：按 SkillHub 安装说明 安装本 Skill，坐标为 @user_00c9b356/buddy-build-your-own-agent。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可用官方脚本（完整安装含默认 Skill；仅 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 build-your-own-agent 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前使用的 AI 客户端的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。官方文档给出的常见路径示例：
| 客户端 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
在对应目录已确认的前提下，安装命令形如：
skillhub install user_00c9b356/buddy-build-your-own-agent --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的客户端路径。安装后按各客户端要求重启或刷新 Skill 列表，使 Agent 能加载该课程。
也可把下面这句发给已支持 SkillHub 安装的 AI，让其按安装文档执行（与 SkillHub 页面文案一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_00c9b356/buddy-build-your-own-agent。
典型用法¶
Skill 在以下任一表述出现时应被触发（官方定义）：
- 想从零手搓 Agent，例如「手搓 Agent」「裸写 agent」「从零构建」。
- 想学 Agent 原理，例如「Agent 底层实现」「ReAct 循环怎么写」。
- 正在课内求助，例如「这一关怎么做」「检查我的代码」。
- 查询进度或规划，例如「我的进度」「agent 学习路线」。
经过上面的步骤启用 Skill 后，可按下面方式使用：
- 开课：说明你想从第几关开始，或让 Skill 根据进度推荐下一关；选择四种教学模式之一（自由探索 / 导师引导 / 挑战模式 / 速通）。
- 写代码：在本地用 Python 实现当关要求；卡住时把报错或片段发给 Agent，并明确「检查我的代码」或「这一关怎么做」。
- 对照参考：需要时请求查看该关对应的参考实现与设计说明（Skill 侧提供 11 个参考实现文件）。
- 续学：隔几天回来直接问「我的进度」或「agent 学习路线」，由进度追踪接续。
课程技术约束（官方简介）：纯 Python + Claude API，不用框架。因此典型练习环境是本地 Python 项目 + Claude API 调用，而不是新建 LangChain 工程。
适用场景与注意¶
适合谁¶
- 希望理解 Agent 循环与工具调用、愿意自己写 Python 的开发者。
- 已会用 AI 写代码，但想系统走完从极简 Agent 到更复杂形态的路径的人。
- 需要可暂停、可追踪进度的自学节奏，而不是一次性读完一篇长文。
明确不用于的场景¶
官方说明以下需求应换别的 Skill 或话题，不要指望 build-your-own-agent 处理：
- 用 LangChain / CrewAI / AutoGen 等框架快速搭 Agent → 使用 agent-creator。
- 评测已有 Agent 质量 → agent-benchmark。
- 学习 Skill 开发本身 → skill-creator。
- Docker、部署环境、API Key 配置类运维问题。
- Python 基础、Web 开发等通用编程答疑。
- AI Agent 行业分析、商业模式类讨论。
其他说明¶
- 版本：当前 SkillHub 展示为 v1.0.1；社区来源（
community），更新以 SkillHub 页面为准。 - 热度数据（页面统计，会变动）：评分 100000，下载 965，安装 12——仅作发现参考，不代表课程难度或效果承诺。
- 与框架路线分工：本 Skill 刻意避开框架；若你的目标是半天内上线一个集成型 Agent，应走 agent-creator 一类路径，而不是本课程。
结尾¶
build-your-own-agent 把「从零写 Agent」拆成 10 关、四种学习模式和可追踪进度，并用 11 份参考实现对齐设计决策；适合在 Cursor 等已支持 Skill 的环境里，边对话边写纯 Python + Claude API 代码。若你关心的是 ReAct 怎么落纸面、而不是先选哪一个框架，可以从 SkillHub 安装该 Skill 并按官方坐标启用。
- SkillHub 页面：https://www.skillhub.cn/skills/user_00c9b356/buddy-build-your-own-agent
- API 元数据：https://api.skillhub.cn/user_00c9b356/buddy-build-your-own-agent
- 安装说明：https://skillhub.cn/install/skillhub.md
