Skip to content
This repository was archived by the owner on Dec 30, 2025. It is now read-only.

README_zh.md

Latest commit

 

History

History
169 lines (118 loc) · 5.55 KB

README_zh.md

File metadata and controls

169 lines (118 loc) · 5.55 KB
Raw

Mini Claude Code

本仓库已迁移至 learn-claude-code

请访问新仓库获取最新内容和更新。

从零开始构建你自己的 AI Agent。

English

兼容 Kode CLI、Claude Code、Cursor，以及任何支持 Agent Skills Spec 的 Agent。

demo

这是什么？

一个渐进式教程，揭开 Kode、Claude Code、Cursor Agent 等 AI Agent 的神秘面纱。

5 个版本，总共约 1100 行，每个版本只添加一个概念：

版本 行数 新增内容 核心洞察
v0 ~50 1 个 bash 工具 Bash 就是一切
v1 ~200 4 个核心工具 模型即代理
v2 ~300 Todo 追踪 显式规划
v3 ~450 子代理 分而治之
v4 ~550 Skills 按需领域专业

快速开始

pip install anthropic python-dotenv

# 配置 API
cp .env.example .env
# 编辑 .env 填入你的 API key

# 运行任意版本
python v0_bash_agent.py  # 极简版
python v1_basic_agent.py # 核心 Agent 循环
python v2_todo_agent.py  # + Todo 规划
python v3_subagent.py    # + 子代理
python v4_skills_agent.py # + Skills

核心模式

每个 Agent 都只是这个循环：

while True:
    response = model(messages, tools)
    if response.stop_reason != "tool_use":
        return response.text
    results = execute(response.tool_calls)
    messages.append(results)

就这样。模型持续调用工具直到完成。其他一切都是精化。

文件结构

mini-claude-code/
├── v0_bash_agent.py       # ~50 行: 1 个工具，递归子代理
├── v0_bash_agent_mini.py  # ~16 行: 极限压缩
├── v1_basic_agent.py      # ~200 行: 4 个工具，核心循环
├── v2_todo_agent.py       # ~300 行: + TodoManager
├── v3_subagent.py         # ~450 行: + Task 工具，代理注册表
├── v4_skills_agent.py     # ~550 行: + Skill 工具，SkillLoader
├── skills/                # 示例 Skills（用于学习）
└── docs/                  # 详细文档 (中英双语)

使用 Agent Builder Skill

本仓库包含一个元技能，教 Agent 如何构建 Agent：

# 脚手架生成新 Agent 项目
python skills/agent-builder/scripts/init_agent.py my-agent

# 或指定复杂度级别
python skills/agent-builder/scripts/init_agent.py my-agent --level 0  # 极简
python skills/agent-builder/scripts/init_agent.py my-agent --level 1  # 4 工具 (默认)

生产环境安装 Skills

# Kode CLI（推荐）
kode plugins install https://github.com/shareAI-lab/shareAI-skills

# Claude Code
claude plugins install https://github.com/shareAI-lab/shareAI-skills

详见 shareAI-skills 获取完整的生产就绪 skills 集合。

核心概念

v0: Bash 就是一切

一个工具。递归自调用实现子代理。证明核心是极小的。

v1: 模型即代理

4 个工具 (bash, read, write, edit)。完整 Agent 在一个函数里。

v2: 结构化规划

Todo 工具让计划显式化。约束赋能复杂任务。

v3: 子代理机制

Task 工具生成隔离的子代理。上下文保持干净。

v4: Skills 机制

SKILL.md 文件按需提供领域专业知识。知识作为一等公民。

深入阅读

技术教程 (docs/):

English 中文
v0: Bash is All You Need v0: Bash 就是一切
v1: Model as Agent v1: 模型即代理
v2: Structured Planning v2: 结构化规划
v3: Subagent Mechanism v3: 子代理机制
v4: Skills Mechanism v4: Skills 机制

原创文章 (articles/) - 公众号风格:

相关项目

仓库 用途
learn-claude-code 本项目的新地址
Kode 全功能开源 Agent CLI（生产环境）
shareAI-skills 生产就绪的 AI Agent Skills
Agent Skills Spec 官方规范

作为模板

Fork 并自定义为你自己的 Agent 项目：

git clone https://github.com/shareAI-lab/learn-claude-code
cd learn-claude-code
# 从任意版本级别开始
cp v1_basic_agent.py my_agent.py

设计哲学

模型是 80%，代码是 20%。

Kode 和 Claude Code 能工作，不是因为巧妙的工程，而是因为模型被训练成了 Agent。我们的工作就是给它工具，然后闪开。

License

MIT

模型即代理。这就是全部秘密。

@baicai003