AI Agent 工程实践(07):AI Agent 为什么需要 Skills,而不是 Prompt?

AI Agent 工程实践(07):AI Agent 为什么需要 Skills,而不是 Prompt? 发布时间2026-07-11标签AI AgentLLMSkillsPrompt概念辨析工程实践系列导航上一篇AI Agent 工程实践06Knowledge 如何演化成 Rules下一篇AI Agent 工程实践08Workflow——什么时候应该拆成 Multi-Agent本文是 [AI Agent 工程实践] 系列的第 07 篇。带新人第一次写 Agent我让他把审查逻辑写进系统。他回了我一个 2000 字的 system prompt——把每一步该做什么全写进去了。我问他那下次要做测试呢再写 2000 字他愣了Prompt 不就是 Agent 吗那一刻我意识到太多人把Prompt 和 Agent 画了等号。他们以为会写 prompt就等于会做 Agent。其实 Prompt 只是 Agent 最小的一个零件。真正的 Agent是 Prompt、Skill、Rule、Workflow、Memory 共同组装出来的——而 Skill是其中最容易被人忽略、却最该被重视的那块。本文你将学到✓ 为什么Prompt Agent是个危险误解✓ Prompt / Skill / Rule / Workflow / Memory / Agent 六个概念各自的边界✓ Skill 和 Prompt、Rule、Workflow 到底差在哪✓ 什么时候该用 Prompt什么时候该抽成 Skill适合阅读✓ 刚接触 Agent 开发、被一堆名词绕晕的新人✓ 用 Claude Code / Cursor / Coze / Dify 但混淆概念的人✓ 想系统理解 AI Engineering OS 各层分别是什么的人问题背景前 6 篇把系统的每一层都拆开了讲。但还有一个更基础的混乱没解决这些名词到底指什么、边界在哪。我看到的现象是新人包括半年前的我习惯用一个词概括一切把 system prompt 当 Agent把很长的 prompt当 Skill把一堆规则当 Workflow把存了点东西当 Memory这种混淆不是文字游戏——它直接导致架构设计错误该抽 Skill 的塞进 Prompt该固化成 Rule 的写在 Workflow 里该持久化的放进会话变量。一句话分不清概念就搭不对系统。这一篇把六个最容易混的概念一次性厘清。错误尝试第一次一切靠 Prompt最初我做 Agent所有能力都塞进一个超长 system prompt审查逻辑、测试规范、风格要求……全写进去。结果和第 02 篇说的一样——prompt 爆炸、不同任务互相干扰、关键约束被淹没。把所有能力压进一句话里等于没有能力分层。第二次以为 Skill 更长的 Prompt吸取教训那我把 prompt 封装成 Skill——其实就是把那段 2000 字单独存成文件调用时整段塞回去。结果本质没变。它只是更长的 prompt没有触发条件、没有输入输出契约、不能被其它 Skill 组合、不能按需加载。它没理解 Skill 是可复用能力单元而不是更长的文字。两次尝试指向同一个教训Prompt 是一次性指令Skill 是可复用能力——把前者当后者就是把一句话当一家公司。关键观察我把六个概念按解决的问题做了一次归位差异立刻清晰概念它解决什么生命周期粒度例子Prompt这次怎么干一次性指令单次对话一句话/一段把这个函改成异步Rule必须/不得做什么约束跨任务常驻约束修改前先 Read 原内容Skill能做什么可复用能力按需加载能力单元代码审查 skillWorkflow多步怎么编排流程任务级流程需求→设计→实现→测试Memory记住什么状态会话/长期数据用户偏好、项目约定Agent谁在执行主体系统级角色Claude Code / Hermespie title 新人把Prompt误当的概念占比 以为 PromptAgent : 40 以为长 PromptSkill : 30 以为规则堆Workflow : 20 其它 : 10Prompt 是一次性指令Skill 是可复用能力——把前者当后者就是把一句话当一家公司。六个概念不是同义词是不同层级的零件各自有边界、有生命周期、有职责。定位真正原因混淆的根源是没看清每个概念的生命周期和复用粒度Prompt 活在一次对话用完即弃解决这次Rule 常驻所有任务被动生效解决必须Skill 按需加载复用主动调用解决这类Workflow 编排多个步骤解决流程Memory 存状态解决记得住Agent 是主体把以上全部组装并执行它们是组装关系不是替代关系。Agent 不是其中任何一个而是承载所有、执行任务的那个壳。最终方案六个概念的分层与边界逐个讲清边界重点是 Skill 和另外三个的区别。Skill vs Prompt一次性 vs 可复用这是最大的误区。核心差异三处维度PromptSkill复用一次性用完即弃跨任务复用结构自由文本有 trigger / 输入 / 步骤 / 输出契约组合不可组合可被 Workflow 或其它 Skill 调用Prompt 是这次怎么干Skill 是这类怎么干。当你发现同一段 prompt 要写第二次那就是该抽成 Skill 的信号。Skill vs Rule能力 vs 约束很多人把 Skill 和 Rule 混为一谈但它们方向相反Rule 是必须/不得——被动约束Agent 不调用它它也在生效如 core 常驻Skill 是能够——主动能力Agent 需要时调用它如代码审查Rule 回答红线在哪Skill 回答工具箱里有什么。一个限制你一个赋能你。Skill vs Workflow单能力 vs 多步编排Skill 单一能力单元做一件事做好Workflow 多个 Skill/工具按序编排做一串事Workflow 是 Skill 的编排者不是 Skill 的加长版。一个代码审查 Skill 不能被拉长成需求到上线的 Workflow——那是编排不是能力。Memory 与 Agent数据 vs 主体Memory是数据层03 篇讲过存状态不产生行为Agent是执行主体加载 Rule、调用 Skill、跑 Workflow、读 Memory最终产出Agent 不是任何一个零件它是把所有零件组装起来并执行的那个角色。实际收益厘清概念后指标全靠 Prompt概念厘清后各归其位同类任务开发成本每次重写 prompt复用 Skill零重写约束可靠性靠 prompt 里求它Rule 常驻强制多步任务人工拼接Workflow 自动编排系统可维护性一团 prompt各层职责清晰为主观估算非严格 A/B Test但反映了概念清晰对架构正确性的直接影响。架构图 / 流程图六个概念的层级与组装关系关键点Prompt 在链最外一次性触发Rule/Skill/Workflow/Memory 是 Agent 内部的零件Agent 是组装它们的主体。Prompt 不是 Agent而是激活 Agent 的那一下。何时该抽 Skill决策流转图片多样性用了 Mermaid 的 pie / flowchart / stateDiagram 三种发文时可再补一张 ProcessOn/draw.io 版的概念关系图提升 CSDN 图片多样性得分。代码或配置示例Skill 的真实结构对比 PromptSkill 之所以不是长 prompt因为它有结构——带触发条件、输入输出契约、可复用# skills/code-review/SKILL.md name: code-review trigger: task_type: [review, refactor] # 什么时候该被调用 input: - diff: 待审查的代码变更 output: - issues: 问题列表描述反例建议 steps: # 能力如何被执行不是一段自由文本 - 识别设计问题 - 检查正确性 - 给出改进建议对比一个 Prompt——它只有指令没有 trigger / 契约 / steps# 纯 Prompt一次性 请审查下面的代码指出设计问题、正确性问题并给改进建议。同样是审查Skill 能被 Router 自动加载、能被 Workflow 编排、有输入输出契约Prompt 不能。这就是一句话和一家公司的差距。抽 Skill 的判定伪代码def should_extract_skill(prompt_log: list[str]) - bool: 出现≥2次相似 prompt就该抽成 Skill similar group_similar(prompt_log) # 归并相似指令 for cluster in similar: if len(cluster) 2: # 第二次出现即触发 return True return False逻辑极简但说的是铁律当你要写第二遍同样的 prompt就是抽 Skill 的时候。设计权衡候选方案优点缺点为什么不选全靠 Prompt零结构、上手快不可复用、易膨胀、难维护规模一大必崩长 Prompt 当 Skill封装感本质还是一次性文本没触发/契约/组合空有壳规则堆当 Workflow看似流程化缺编排语义、不可调用混淆约束与流程六概念各归其位复用高、约束可靠、可维护需先厘清概念成本选择理由正确的边界才能长出正确的系统不是所有都该抽 Skill。一次性的临时任务纯 Prompt 就够了——抽成 Skill 反而是过度工程。判断标准就一条同样的需求会不会出现第二次。会就抽不会就 Prompt。总结✅ Prompt ≠ Agent。Prompt 只是激活 Agent 的那一下一次性指令Agent 是组装所有零件的 execute 主体。✅ 六个概念是不同层级的零件Prompt一次性/ Rule约束/ Skill能力/ Workflow编排/ Memory状态/ Agent主体。✅ Skill 区别于 Prompt可复用、有触发/契约/步骤、能被组合区别于 Rule能力而非约束区别于 Workflow单能力而非多步编排。✅ 抽 Skill 的信号只有一个同样的 prompt 要写第二遍。✅ 概念清晰了架构才不会错——分不清零件就组装不出机器。参考资料Anthropic — Claude Skills 官方文档[待补链接]→ Skill 的标准结构与触发机制本文 Skill 定义的直接依据第 02 篇为什么 Rules 要分层→ Rule 与 Skill 的边界约束 vs 能力本文对比的来源第 03 篇Memory 设计→ Memory 作为数据层、不产生行为的界定第 05 篇Rule Router→ Skill/Rule 如何被 Router 按需加载概念在工程里如何运转Coze / Dify 工作流文档→ Workflow 编排多步能力的参考实现系列导航上一篇AI Agent 工程实践06Knowledge 如何演化成 Rules下一篇AI Agent 工程实践08Workflow——什么时候应该拆成 Multi-Agent本文是 [AI Agent 工程实践] 系列的第 07 篇。