learn-agent

Name: learn-agent
Author: 7-e1even

Pending

从零写一个能活下来的 AI Agent：15 课可跑代码，机制从真实产品 Reina 移植 | Build a coding agent from scratch — how Claude Code / Codex / Cursor actually work under the hood. 15 runnable lessons, zero deps.

51stars

5forks

JavaScript

Installation

# Add to your Claude Code skills
git clone https://github.com/7-e1even/learn-agent

Getting Started

Guides for using ai agents skills like learn-agent.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

README.md

Frequently Asked Questions

What is learn-agent?

learn-agent is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by 7-e1even. 从零写一个能活下来的 AI Agent：15 课可跑代码，机制从真实产品 Reina 移植 | Build a coding agent from scratch — how Claude Code / Codex / Cursor actually work under the hood. 15 runnable lessons, zero deps. It has 51 GitHub stars.

Is learn-agent safe to use?

learn-agent's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install learn-agent?

Clone the repository with "git clone https://github.com/7-e1even/learn-agent" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is learn-agent written in?

learn-agent is primarily written in JavaScript. It is open-source under 7-e1even on GitHub, so you can review or fork the full source.

Are there alternatives to learn-agent?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh learn-agent against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

claude-design-studio-toolkit skill-eval-harness

learn-agent · 从零写一个能活下来的 AI Agent

简体中文 · English

快速跳转　·　适合谁读　·　30 秒跑起来　·　15 篇目录　·　完整实现 Reina　·　给个 Star

一个 while 循环是 agent 的全部秘密——但只够它活 5 分钟。剩下的部分——让它在真实任务里活过 5 小时——就是这 15 篇笔记记的东西。

想搞懂 Claude Code、Codex、opencode 这类 coding agent 内部到底怎么实现？这个仓库是我从 0 开发自己的 agent 时的踩坑笔记：15 篇渐进式笔记 + 15 份零依赖、单文件、直接能跑的代码，每篇解决一个真实翻车现场。

15 套机制，最后都长回同一个循环上

[!IMPORTANT] 和别的"手写 agent"教程不一样的地方：这里的机制不是照着 API 文档想象的，而是从一个真实在跑、完整开源的桌面 coding agent 产品——Reina——简化移植而来，每一条报错、每一个机制优化，都是线上踩过的坑。学完这 15 篇想看生产级完整源码，直接去 👉 Reina-Agent/Reina

这份笔记适合你吗

对着下面三条自查，中一条就值得读：

你照教程写过 agent demo，但一上真实任务就失控：空转烧钱、上下文爆窗、跑半小时忘了最初任务；
你每天在用 Claude Code，想知道压缩、缓存、子代理、权限审批这些"魔法"内部到底怎么做的；
你要在工作里落地 agent，想要一份被生产环境验证过的机制清单，而不是再看一遍 hello world。

Agent 看起来很简单，真去实现才发现里面大有可学。从"能跑"到"能用"，中间隔着一整层没人系统讲过的工程——它会空转烧钱、会吃撑爆窗、会跑半小时忘了最初任务、会因为不懂缓存贵 10 倍、会被卡死的子任务拖住。每一篇解决一个这样的真实问题。

30 秒跑起来

代码全部零依赖、单文件、Node 18+ 直接跑，任何 OpenAI 兼容的 key 都行（DeepSeek / Kimi / GLM / OpenRouter / 本地 Ollama）：

git clone https://github.com/7-e1even/learn-agent && cd learn-agent
AGENT_API_KEY=sk-xxx node s01_agent_loop/agent.mjs

手上一时没有 key？s12 的自测模式不需要任何 key 也能端到端跑通全部机制。

跑起来后，从 s01 顺着读到 s15，每篇边读 README 边跑代码即可。

#	主题	解决翻车点
s01	一个循环，一双手	agent 和 chatbot 的全部区别是一个 `while`
s02	工具箱与调度	加工具不改循环；Edit 唯一匹配契约的深意
s03	循环预算与自动纠偏	复读机/原地踏步/连环报错，先拍肩膀再熔断
s04	工具输出预算 + 无损溢出	一条 `cat` 就能爆窗；截断丢信息，溢出到磁盘不丢
s05	流式与中断	Ctrl+C 之后，坏掉的消息序列怎么修
s06	上下文压缩	压缩后不忘最初任务：启动消息逐字保留
s07	缓存命中工程	前缀稳定性；连压缩摘要那一次调用都能省 90%
s08	会话落盘与恢复	断了能接上，才叫能用
s09	子代理与心跳看门狗	卡死检测（闲置 vs 在工具里）、击杀前抢救遗言
s10	System prompt 组装	prompt 是每轮拼出来的，不是写死的；skills 按需加载
s11	多 agent 协作	DAG 任务图、同 brief 去重、并发上限
s12	合体	全部机制回到同一个循环；免 key 端到端自测
s13	权限与审批	危险操作在副作用前裁决；allow/deny/ask 三态首匹配
s14	Provider 兼容层	模型乱吐 tool call（名字/参数/截断/散文）在边界掰平
s15	渐进式工具披露	工具多了不撑爆上下文；解蔽别回灌数组、撞缓存

完整实现：Reina —— 这些机制在真实产品里的样子

这 15 篇不是凭空写的——它们全部来自我做 Reina 时的踩坑记录。Reina 是一个完整开源、能装能用的桌面 AI agent（Electron + React + TypeScript）；本仓库是我把它的核心机制剥出来、简化成单文件后留下的学习笔记。想看这些机制在生产代码里真正的样子，去主仓一一对照：

你在这里学到的	点进 Reina 看实战代码
s01 · 主循环	agent 引擎 → `core/engine.ts`
s03 / s04 · 预算与溢出	成本与上下文护栏 → `core/loop-budget.ts`
s06 / s07 · 压缩与缓存	压缩 `compaction.ts` · 缓存稳定 `engine-prompt.ts`
s09 / s11 · 子代理与多 agent	看门狗 `subagent/activity.ts` · 调度 `subagent/manager.ts`
s13 / s14 · 权限与 Provider 兼容	审批 `permissions.ts` · 模型兼容 `providers/tool-compat.ts`

👉 喜欢这套笔记，别忘了给完整版 Reina-Agent/Reina 点个 ⭐——笔记帮你想清"为什么这么做"，主仓给你"直接拿去用"的生产级代码。

如果它帮到了你

这个仓库不卖课、不引流，只有笔记和代码。如果它帮你少踩了一个坑，顺手点个 ⭐——这是让更多人看到它的唯一方式。发现笔记里有事实错误或代码 bug，直接开 issue，当面对线。