Agent 学习知识库

外观

learn-claude-code 项目摘要 ​

🔗 GitHub：shareAI-lab/learn-claude-code 🌐 官网：https://learn.shareai.run ⭐ 55000+ stars | 📜 MIT 许可 | 🛠 TypeScript

项目定位 ​

Bash is all you need — 一个从 0 到 1 构建的 nano claude code 级 Agent Harness。

通过逆向工程 Claude Code，系统性地拆解其每一个 Harness 机制，帮助开发者深入理解 Agent 产品的底层架构与设计哲学。

核心哲学 ​

"Agency 来自模型，不来自代码。"

  • Agency（智能决策能力） 是模型在训练过程中习得的，而非由外部代码编排产生的
  • 工程师的角色不是「创造智能」，而是「为智能提供高效的基础设施」
  • Agent 产品的核心公式：
Agent 产品 = Model（模型/驾驶者） + Harness（载具/基础设施）

核心金句 ​

"最好的 agent 产品，出自那些明白自己的工作是 harness 而非 intelligence 的工程师之手。"

Harness 工程师五大职责 ​

#职责说明
1实现工具（Implement Tools）为模型提供可调用的外部能力（文件读写、搜索、执行命令等）
2策划知识（Curate Knowledge）设计 System Prompt、注入领域知识，引导模型行为
3管理上下文（Manage Context）控制上下文窗口的内容，压缩、筛选、优先级排序
4控制权限（Control Permissions）设计权限模型，确保安全边界，防止越权操作
5收集数据（Collect Data）收集用户交互数据与反馈，用于持续优化模型和产品

Claude Code 架构公式 ​

Claude Code = Agent Loop
             + Tools
             + Skills
             + Context Compression
             + Sub-agents
             + Task System
             + Mailbox
             + Worktree
             + Permissions
组件作用
Agent Loop感知 → 推理 → 行动 → 观察的持续循环
Tools文件操作、搜索、终端执行等外部工具集
Skills可复用的高级能力模块（如代码审查、PR 创建）
Context Compression上下文压缩策略，优化长对话中的 token 使用
Sub-agents子 Agent 机制，分解复杂任务为独立子任务
Task System任务管理与依赖图，协调多任务执行顺序
MailboxAgent 间的消息通信机制
WorktreeGit worktree 隔离，确保并行任务不冲突
Permissions分层权限模型，保障安全执行

课程体系 ​

项目包含 s01-s12 共 12 个进阶课程，逐步逆向工程 Claude Code 的每一个 Harness 机制：

课程主题方向
s01Agent 基础概念与哲学
s02Agent Loop 核心循环
s03工具系统设计与实现
s04System Prompt 与知识策划
s05上下文管理与压缩
s06Skills 技能系统
s07Sub-agents 子 Agent
s08Task System 任务系统
s09Mailbox 通信机制
s10Worktree 并行隔离
s11Permissions 权限模型
s12综合实战：构建完整 Agent

与本知识库的关联 ​

本知识库的核心理论框架和架构设计思路均源自对 learn-claude-code 项目的学习与提炼：

  • 01_基础理论/ ← 对应 s01-s02 的概念与哲学
  • 02_架构设计/ ← 对应 s03-s09 的 Harness 各组件
  • 03_进阶技术/ ← 对应 s07-s11 的高级机制
  • 04_实践应用/ ← 对应 s12 的综合实战

我的理解与思考 ​

💡 在此记录你学习该项目后的个人理解和思考...