小白也能懂Claude Code 中 Agent 和 Skill 到底有什么区别你用 Claude Code 的时候一定见过这两个词Agent 和 Skill。它们都能让 Claude 变得更聪明但原理完全不同。搞混的人不在少数包括我自己。今天用大白话讲清楚保证看完你就懂。先说结论一个字之差天壤之别Agent 独立的 AI 助手有自己的脑子Skill 一套流程模板共用主对话的脑子打个比方Agent 像你公司里的员工。你把任务交代给他他自己想办法完成。他有独立的思考空间上下文窗口能理解复杂的需求做出自己的判断。Skill 像你办公桌上的流程手册。翻开手册按照步骤一步一步做。但动脑子的人还是你自己手册只是帮你省去想下一步干什么的功夫。一张表看懂核心区别对比项Agent子AgentSkill技能上下文独立的上下文窗口共享主对话上下文类比公司员工流程手册适用场景多步骤复杂任务固定流程的重复任务配置方式.md 文件YAML 提示词.md 文件纯提示词存放位置.claude/agents/.claude/commands/工具权限可精细控制继承主对话权限通信方式消息传递像 Slack直接在主对话中执行什么时候用 Skill什么时候用 Agent记住一句话就够了任务需要多步操作 大量上下文 用 Agent任务是固定流程 用 Skill举个具体例子。适合 Skill 的场景/commit—— 格式化 git commit message/review-pr—— 按 checklist 审查 PR/build—— 执行构建命令这些任务的特点是步骤固定输入简单不需要理解太多上下文。适合 Agent 的场景写一篇公众号文章搜索、写作、排版、上传、发布重构一个模块阅读代码、理解架构、修改、测试安全审计扫描依赖、检查代码模式、生成报告这些任务的特点是步骤多、需要大量上下文、需要自主决策。真实案例wechat-publisher 的进化史我自己的微信公众号发布工具就是一个典型例子。最开始它是个Skill。流程很简单写文章、转格式、发布。三个步骤一气呵成。但后来需求越来越复杂要搜索最新资料要根据不同主题调整写作风格要处理封面图、正文配图要排版成微信兼容的 HTML要上传素材到微信服务器要创建草稿或直接发布还要同步到 CSDN一个 Skill 根本搞不定。上下文窗口会被撑爆流程也太灵活了没法写死。所以我把它升级成了Agent。现在它像一个独立的小编自己规划任务自己执行最后把结果汇报给我。这就是从 Skill 到 Agent 的典型升级路径。Agent 怎么配置一个文件搞定Agent 的配置就是一个.md文件放在.claude/agents/目录下。文件结构很简单---name:my-agentdescription:这是一个示例 Agent 的描述model:claude-sonnet-4-20250514tools:-Read-Write-Bash-Glob-Grep---你是一个专业的 XX 助手。 你的任务是 1. 理解用户需求 2. 分析相关文件 3. 输出结果上半部分是YAML frontmatter用三个短横线包裹。关键配置字段nameAgent 的唯一标识用于触发和引用description描述 Agent 的功能决定了什么时候自动触发model指定使用的模型可以选便宜的模型省钱tools工具权限列表决定 Agent 能干什么下半部分是系统提示词告诉 Agent 该怎么做事。两种触发方式1. 自动触发被动在 description 里写上 “PROACTIVELY”Claude 会在合适的时机自动调用这个 Agentdescription:PROACTIVELY run code review on every PR2. 手动调用主动直接告诉 Claude用 code-reviewer agent 审查一下这个 PR放哪里项目级 vs 用户级Agent 配置文件有两个存放位置项目级.claude/agents/只对当前项目生效用户级~/.claude/agents/对你所有项目都生效建议通用 Agent如代码审查放用户级项目特有 Agent如 wechat-publisher放项目级工具权限控制最小权限原则给 Agent 配置工具时遵循最小权限原则。不是所有 Agent 都需要 Write 权限。看几个实际例子# 代码审查员 - 只需要读权限name:code-reviewertools:-Read-Glob-Grep-LSP# 测试工程师 - 需要写和执行name:test-engineertools:-Read-Write-Bash# 安全审计员 - 只需要读权限name:security-reviewertools:-Read-Glob-Grep# 调试专家 - 需要完整的读写和执行能力name:debuggertools:-Read-Write-Edit-Bash-Glob-Grep-LSP安全审查员不需要 Write 权限—— 它只看不改。这样即使 Agent 出了问题也不会破坏你的代码。实战 Agent 示例推荐下面这些 Agent 类型可以直接拿来用code-reviewer代码审查name:code-reviewerdescription:PROACTIVELY review code changes for quality issuestools:-Read-Glob-Grep-LSPtest-engineer写测试name:test-engineerdescription:Write comprehensive unit teststools:-Read-Write-Bash-Glob-Grepdebugger调 Bugname:debuggerdescription:Debug issues and find root causestools:-Read-Write-Edit-Bash-Glob-Grep-LSPsecurity-reviewer安全审计name:security-reviewerdescription:PROACTIVELY audit code for security vulnerabilitiestools:-Read-Glob-Grep最后一句话总结Skill 是给自己用的备忘录Agent 是给另一个 AI用的岗位说明书简单任务用 Skill复杂任务上 Agent。别想太多先从 Skill 开始做不下去再升级成 Agent。就像这篇公众号文章就是靠 Agent 写出来、排版、上传、保存草稿的。人力零。本文由 Claude Code Agent 自动写作并排版仅保存草稿供人工审核后发布。