不少新手把Agent跑起来之后第一反应是兴奋第二反应是困惑。兴奋的是终于有了一台属于自己的AI打工人困惑的是这个打工人好像只会聊天——让它整理文件它会让它上网查资料它不会让它画个图它更不会让它按比赛模板写篇论文更是无从下手。这不是Agent智商有问题而是你让它裸奔了。所谓裸奔就是Agent只带了大模型的推理能力却没有任何Skills技能模块可用。我见过太多人卡在这一步所以今天就来聊聊新手最该装的六个Skills以及怎么把它们安安稳稳地装上、跑起来、排查问题。这篇文章适合刚接触Claude Code、Codex、OpenCode这类Agent工具的人也适合已经在摸索但被各种报错折磨的朋友。1. 裸奔的Agent到底缺了什么1.1 Agent不是不够聪明而是没有手先说一个很多新手容易误解的地方Agent的核心能力来自大模型它能推理、能规划、能拆解任务。但推理出来之后呢它得靠工具去执行。比如它想帮用户生成一张配图如果它不知道图片生成服务的地址、不知道请求参数怎么写、不知道输出图片应该保存到哪里那它只能给你一段干巴巴的我建议你用某某工具生成图片然后摊手。这时候Skills的意义就出来了。Skills本质上是一份结构化的操作说明工具调用手册它告诉Agent在什么场景下打开这个技能、具体怎么做、有哪些步骤、输出格式是什么、有哪些约束不能违反。你可以把它理解成给Agent配备的标准作业流程。我自己的感受是没有Skills的Agent像个刚毕业的高材生脑子确实好使但没工具、没流程、不熟悉业务规则做事全凭临场发挥。而装好Skills之后它就像进了公司配了电脑、装了内部系统、发了操作手册的老员工一上来就知道该干什么。1.2 Skill、Agent、Harness三个新手必须分清楚的概念跟Skills一起高频出现的还有两个词Agent和Harness。很多人在群里问harness和agent区别skill和agent区别其实这三者是不同层面的东西。Agent是执行主体具有感知、规划、决策和行动能力。 Harness是运行框架相当于Agent的身体和地基负责工具调用循环、上下文管理、权限控制等底层逻辑。Claude Code、Codex、OpenCode、Pi Agent这些本质上都是Harness。 Skill是可复用的能力模块是Agent可以随时调用的工具箱。打个比方Agent是厨师Harness是厨房和灶台Skills是菜谱和专用厨具。灶台决定了你用什么火、能炒几个菜厨师决定今天做什么菜谱和厨具则让厨师知道红烧肉该分几步、刀工怎么做。没有Skills的Agent就是一位满脑子菜谱知识却赤手空拳的厨师。1.3 一个SKILL.md为什么能改变Agent的表现Skills常见的形式是SKILL.md文件前面带一小段YAML格式的元信息里面最关键的是name和description。有了这个文件Agent在接到用户请求时会先去浏览所有可用Skills的描述当描述与当前任务匹配时它就把整个技能正文加载进上下文按照里面的步骤执行。换句话说SKILL.md本质上是在提示词层面下功夫。它不需要你改大模型也不需要动Harness源码只需要把高质量的流程、参数、约束写进一个文本文件Agent的表现就会明显变好。这也是为什么skills怎么写ai skills怎么写会成为热词——会写Skills的人等于能给Agent批量灌入专业经验。2. 新手必备六个Skills按顺序装少走弯路下面这六个Skills是我实测下来对新手最友好的组合。顺序就是建议安装的顺序先装通用型的再按自己的领域装专业型的。2.1 Superpower Skills新手的第一套超能力如果你只打算装一个Skills那就装Superpower Skills。这是社区里很有名的一套技能集合来自开源作者obra的持续维护在网上搜superpower skills就能找到仓库。它不是单个技能而是把会话管理、任务聚焦、计划生成、内容总结、Web搜索辅助等一堆高频能力打包在一起等于直接给你凑齐了一整套经过实战检验的武装。对新手意义很直接不用自己东拼西凑去研究Skills到底该写成什么样装完它你就能直观感受到有技能和没技能的Agent完全是两个物种。比如在长会话中普通Agent聊着聊着就开始上下文爆炸、前言不搭后语而Superpower Skills里的会话管理能力可以让Agent定期生成摘要压缩历史信息让对话保持清晰。注意事项安装前一定看仓库里的README不同版本的Harness对Skills目录结构要求略有差异。我最早就是直接git clone整个仓库到skills目录结果结构对不上重新读了README才解决。这一步不能省。2.2 图片生成与处理Skills让Agent看得见也画得出很多新手问agent画图怎么搞其实Agent本身并不会画图但它可以调用图像生成工具。图片生成Skills的作用就是把工具的调用方式提前写好服务地址是什么、鉴权方式是什么、请求参数有哪些、返回结果是URL还是base64、图片存到哪里。你搜图片生成skills安装包能找到不少现成方案。这个Skills的实战价值很大。我自己做过一批公众号配图也帮朋友处理过AI漫剧的图集用的就是这类技能。它的核心不只是把画一只猫翻译成英文提示词而是连同画幅比例、风格关键词、负面提示词、后处理流程都定义好这样Agent产出图片的一致性和质量都高很多不是那种每次随缘的效果。踩坑提醒如果你的图片生成服务跑在本地比如ComfyUI或Stable Diffusion WebUI注意地址别写错鉴权Header也要在SKILL.md里写清楚。否则Agnet会给你一个执行失败的报错再白白扣一轮上下文。2.3 LaTeX排版Skills论文党的救星你要是参加过建模比赛或正在写毕设这个Skills几乎是刚需。热搜里怎么做一个latex排版skills说明需求很真实。它的价值在于把LaTeX从会写公式升级到会排完整论文。一个合格的LaTeX排版Skills应该包含三部分内容一是模板比如国赛、华为杯的常见论文结构标题、摘要、正文、结论、参考文献一应俱全二是宏包清单包括ctex做中文支持、amsmath做公式、booktabs做三线表、graphicx插图等三是编译流程明确告诉你用xelatex的编译链避免中文乱码或者参考文献没编译出来的情况。我实测下来装了这个Skills之后Agent能从给我一段LaTeX代码进化到直接给我一个能编译通过的完整main.tex。别小看这一步新手找模板都能找一下午现在Agent直接给你排好了。细节一定要写细比如公式编号、浮动体位置、图表标题格式最好给出正例和反例。大模型对模糊要求的理解偏差很大你写得越具体它输出越稳。2.4 数学建模与数据处理Skills竞赛党的提速包跟上面LaTeX技能搭配使用的是数学建模Skills。搜索数学建模skills推荐华为杯建模比赛好用的codex skills的人越来越多说明大家都意识到标准流程复用的重要性。我把这一类Skills理解为赛题速查手册模型方法库。它里面可以包含问题分析框架、数据预处理步骤、常用模型的选择建议、结果可视化的规范配色以及论文每个章节应该放什么内容。比如遇到一道评价类题目技能里直接写了TOPSIS法的适用条件、计算步骤、代码模板遇到预测类题目自动引导你比较灰色预测、回归、时间序列的优缺点。这样建模手不用临时翻书Agent也能在标准化流程内发挥比赛效率提升是肉眼可见的。有一点新手要注意数学建模Skills不要贪多求全按你常打的比赛类型来。见过有人装了几十个模型模板结果Agent选择困难反而拖慢速度。少而精才是这类技能的正确打开方式。2.5 前端开发Skills让Agent从写代码到搭界面前端开发skills也是热搜常客。普通Agent即便会写HTML也不会按工程规范做前端。你让它做个页面它可能给你一个塞满内联样式的单文件在浏览器里打开倒是能看但转手维护就是一场灾难。前端开发Skills要解决的就是这个问题。在这个技能里我会定义项目初始化命令、Tailwind等样式框架的配置方式、组件目录结构、响应式断点以及设计规范比如间距、圆角、字体层级。这样Agent生成的前端代码至少是能交给协作者的状态而不是一次性玩具。如果你是纯后端或非技术出身这个技能更推荐装。它相当于你雇了个懂设计系统的前端外包能帮你快速出页面原型。实测时我发现只要在SKILL.md里写清楚必须使用组件化方式输出Agent的代码风格就稳定得多效果立竿见影。2.6 记忆管理Skills对抗转头就忘最后一个是我个人认为最容易被忽视、但长期价值最高的记忆管理Skills。热搜里agent记忆的话题热度很高还有人提到学术界的a-memguard这类针对Agent记忆的防御框架说明记忆既是刚需也是安全焦点。普通Agent的上下文窗口是有限的长会话一旦超过窗口早期的重要信息就会被挤出去表现为转头就忘。记忆管理Skills的思路很简单定期把关键结论、用户偏好、任务进度写入一个本地记忆文件每次会话开始或需要的时候再把这个文件的内容加载回上下文。设计记忆类技能时最核心的原则是既记得住又不泄露。我之前就吃过亏让Agent把对话历史全存下来结果它把一些不必要的细节也存进去了后面又原封不动地吐出来场面十分尴尬。后来我在技能里加了一条清洗规则只保留决策、结论和必要的用户偏好涉密或敏感内容一律不写。这不仅是体验问题也是安全问题毕竟记忆文件如果被恶意指令利用Agent是有可能被带偏的。咱们要的是可靠的工具不是不受控的助手。3. Skills安装实操手把手教你装到Agent里3.1 先把目录搞明白你的Agent去哪里找Skills不同Harness对Skills的目录约定不太一样但思路是共通的要么在用户根目录下放一个全局Skills目录要么在项目目录下放一个项目级Skills目录。我以Claude Code举例子它默认会读取用户级目录~/.claude/skills/项目里也支持.claude/skills/这样的本地目录。这里有个细节新手容易懵Skills到底该放全局还是放项目里我的建议是通用型技能放全局比如Superpower Skills、图片生成跟具体项目强相关的放项目里比如你给某个比赛专门写的论文模板技能放项目里更整洁也不会污染其他项目。不同Harness的具体目录建议以官方文档为准。像Codex、OpenCode、Pi Agent都有自己的约定但识别逻辑基本一致找一个名为SKILL.md的文件读它的frontmatter。你把这个原理搞懂了换哪个工具都不会慌。3.2 从GitHub手动装一个Skills最稳的一条路手动安装是成功率最高的方式。以Claude Code为例先创建目录再克隆或下载对应的技能仓库mkdir -p ~/.claude/skills cd ~/.claude/skills git clone https://github.com/你的目标仓库.git如果是单文件的技能更简单mkdir -p ~/.claude/skills/my-skill curl -o ~/.claude/skills/my-skill/SKILL.md https://example.com/xxx/SKILL.md装完之后检查一下目录结构。一个完整的技能通常长这样my-skill/ ├── SKILL.md ├── scripts/ │ └── run.py └── assets/ └── template.txt注意很多技能仓库的SKILL.md在子目录里而不是仓库根目录。我最早装Superpower Skills时就踩了这个坑直接把整个仓库clone进来结果Agent根本找不到技能。正确做法是看仓库的README通常需要把其中skills子目录里的内容复制或软链到你的技能目录。这也是为什么我反复强调先看README再动手。3.3 从Skills源网站批量找省时但必须会甄别现在社区里有很多Skills的集合站点和精选清单比如awesome claude skills这类仓库专门汇总各类技能覆盖写代码、做PPT、生成图片、爬数据、写LaTeX等等。对这些资源的态度我只有一句话可以逛但别贪。批量装技能有两个坏处。一是选择过载Agent每次都先浏览所有描述再做决定描述一多它反而容易选错二是质量参差有些技能只是把某个工具的说明书复制了一份没有经过验证跟着它走容易跑偏。我给自己定了个筛选标准第一看最近更新时间长期没人维护的直接Pass第二看README质量连安装说明都写不清楚的作者技能质量通常也一般第三看是单文件还是带脚本只要带脚本就必须确认脚本依赖是否好安。按这个标准筛下来真正值得装的其实没几个。3.4 装完之后该怎么验收装完技能别急着开始干正事先做一次简单的自检。你可以直接在对话里问一句你现在有哪些可用的技能看它能不能把刚装的技能说出来。这一步能判断文件路径、目录结构、frontmatter是否都没问题。如果它说没看到按顺序排查SKILL.md的name和description有没有写全、目录是否在Harness的搜索范围内、对话是不是没有重新加载。很多Harness在启动时会扫描一次技能目录你装完了不重启它确实感知不到。另外如果你的技能带了脚本先手动执行一遍命令能跑通再让Agent去调。我看到太多人问执行终止报错往下追一层往往是Python脚本少装了个依赖或者没有执行权限。chmod x scripts/run.py这种基础操作能省你半小时的排查时间。4. 常见问题与排查技巧实录4.1 报错Agent execution terminated due to error这是新手最常遇见的报错之一英文直译是Agent执行因错误被终止。第一次遇到确实吓人但90%的原因就三种。一是脚本或命令本身失败技能里指示Agent运行某个脚本但脚本报错退出。排查办法是手动复制Agent执行的命令在终端里跑一遍看真实的报错信息。二是环境变量缺失技能依赖某个API Key或者路径但没有通过环境变量传进去Agent调工具时拿到空值直接抛错。三是权限问题脚本没有可执行权限或者没有访问某个目录的权限。我的排查顺序是固定的先开调试日志看整个执行流程在哪一步断掉再手动复现命令最后看环境变量和权限。几乎不用看其他东西就能定位。4.2 装了Skills但Agent想不起来这个问题比报错还让人郁闷明明装好了Agent偏偏不调用。我总结过三个高频原因。第一description写得太平淡Agent判断不了什么时候该用。你要在描述里写清楚触发条件比如当用户需要整理会议纪要时使用此技能比一句会议相关工具管用得多。第二装错了目录全局技能和项目技能被搞混导致在当前项目里根本扫描不到。第三对话没重启Agent的上下文里还没有新技能的信息。还有一个容易被忽略的坑同名技能。如果你安装的两个技能使用了相同的name后加载的会把先加载的覆盖掉表现就是技能好像装了但一直没反应。解决办法就是检查目录把同名的技能改掉或删掉。4.3 装的Skills多了之后打架当你的技能多到一定程度会出现一个请求触发了好几个技能的情况。比如用户说帮我生成一张配图放进文档里图片生成技能和LaTeX技能都被唤醒了两个都想接管最后Agent左右横跳输出内容四不像。我的解决办法是给技能做使用边界划分在SKILL.md的description里明确写清楚本技能只管哪一段流程遇到不属于自己负责的部分明确指引应调用哪个技能。相当于给Agent画好分工图。另一个建议是定期做减法这在社区里也有讨论比如tibo推荐过的方法核心思路是审查每个技能的触发率长期没人触发的优先清理。技能不在多在于关键时刻能顶上。4.4 从会用走向会写一个属于自己的Skills最后聊聊怎么写一个最简单的Skills。其实门槛低到你想象不到。以会议纪要格式化Skills为例。先建目录和文件meeting-notes/ └── SKILL.mdSKILL.md内容大概是--- name: meeting-notes description: 当用户提供会议记录草稿时使用此技能输出结构化的会议纪要包含议题、结论、待办事项。 --- # 会议纪要格式化 ## 输出格式 1. 会议基本信息时间、参与人、主题 2. 议题讨论每个议题的背景、关键观点、结论 3. 待办事项事项、负责人、截止时间 ## 示例 输入...原始草稿 输出 - 会议主题... - 结论...写完后重启会话对Agent说一句这是我的会议草稿帮我整理成纪要看它是否调用这个技能。如果它没有反应就回去改description里的触发词增加会议纪要待办这类关键词。整个过程本质上就是写一份给聪明人的操作手册它不需要你懂编程只需要你把流程讲清楚。5. 最后分享一点我的实操体会这些年我装过几十个Skills真正坚持用到最后的也就六七个。一开始我也有看到什么装什么的收集癖后来发现技能越多Agent每次决策时浏览的描述就越多不仅费上下文还容易选错。所以我的习惯是先装Superpower这样的通用型技能打底再按当前工作重心装两三个领域型技能比如做比赛就装数学建模和LaTeX排版做前端开发就装前端规范。用一段时间后再回头看哪个技能实际被触发过不常用的果断清理。这个习惯帮我省了很多隐形麻烦。另外遇到Agent不听话的时候我的第一反应不是怀疑模型变笨了而是去看它的技能列表和日志。九成情况都是路径问题、描述问题、依赖问题纯属配置层面的小事不用一上来就想着重装系统。最后再提一句安全边界Skills和记忆管理能让Agent变得更强大、更顺手但也要记住它始终是工具。涉及隐私的信息不要无脑交给Agent记忆里只留必要的任务信息就好。装好技能、守住边界剩下的就让Agent去跑吧。