2026/8/26 10:37:05
FEATURED · 精选文章 
1. 从“裸奔”到“武装”为什么你的AI需要Skills最近跟几个做AI应用开发的朋友聊天发现一个挺普遍的现象大家花了不少心思调教大模型写了几百上千字的Prompt但模型的表现还是时好时坏像个不太靠谱的实习生。你让它写个周报它可能给你编出一段小说你让它分析数据它可能直接开始跟你讨论哲学。这种状态我称之为AI的“裸奔”——它空有强大的通用能力却没有针对你具体业务的“专业技能”和“工作流程”。这其实就是当前AI应用落地的一个核心痛点。我们往往把大模型当作一个“万能问答机”期望通过一段精心设计的提示词Prompt就能解决所有问题。但现实是对于稍微复杂或专业的任务这种“一次性指令”的方式极其脆弱。上下文窗口有限、指令容易遗忘、多步骤任务逻辑混乱……这些问题让AI的潜力大打折扣。而“Skills”这个概念正是解决这个问题的钥匙。你可以把它理解为给AI这位“通用员工”配备的“专属技能包”或“工作手册”。它不是一段简单的Prompt而是一套结构化的指令、工具、工作流和知识库的集合。通过Skills你可以告诉AI“当你遇到A类任务时请按B流程使用C工具参考D文档最终产出E格式的结果。” 这样一来AI就从那个需要你手把手教、还经常出错的“裸奔新手”变成了一个拥有标准化作业流程SOP的“专属员工”。从网络上的讨论热度来看围绕Claude Code、Skill.md模板、Prompt Engineering的搜索非常集中这恰恰印证了市场正从“玩Prompt”向“建Skills”的范式转移。大家不再满足于让AI“说得好听”更希望它“干得漂亮”。接下来我们就深入拆解如何一步步给你的AI穿上“职业装”让它真正成为你团队里高效、可靠的一员。2. 技能架构核心超越Prompt的System级设计要理解Skills首先要跳出“Prompt Engineering”的思维定式。传统的Prompt优化像是在教一个聪明但没经验的人临场发挥。而Skills设计则是为它编写一本详尽的岗位说明书和操作手册。其核心差异在于系统化与结构化。2.1 Prompt的局限性为什么“单次指令”不够用我们常用的对话Prompt存在几个先天不足上下文稀释在长对话中你最早给出的、最关键的指令会被后续的对话内容不断“稀释”模型可能会逐渐偏离最初设定的角色和目标。逻辑链断裂对于需要多步骤、有条件判断的复杂任务单次Prompt很难清晰地定义整个工作流。模型可能会跳过关键步骤或者以错误的顺序执行。工具调用缺失纯粹的文本对话无法让AI直接操作外部工具比如查询数据库、调用API、读写文件、执行代码等。没有工具AI就是个“纸上谈兵”的参谋。知识更新滞后模型的知识有截止日期且无法记忆专属的、动态的业务知识如公司内部数据、最新产品文档。举个例子你给AI一个Prompt“帮我分析一下上个月的销售数据总结趋势并给出下月建议。” 这个指令对AI来说太模糊了。数据在哪什么格式分析哪些维度“趋势”指环比还是同比“建议”需要多具体结果就是AI要么向你追问一堆细节要么基于它的“想象”生成一份泛泛而谈的报告。2.2 Skills的构成要素一个完整的技能包有什么一个完整的Skill应该像一套组合拳包含以下层次身份与边界Role Boundary明确告诉AI“你是谁”以及“你不能做什么”。例如“你是一名专注于电商数据分析的资深顾问。你的职责是依据提供的数据进行分析严禁编造数据或对非数据相关的公司战略发表意见。” 这设定了行为的基调和红线。核心目标与成功标准Goal Success Criteria清晰定义这个Skill要完成的终极任务是什么以及如何衡量任务成功。例如“核心目标是生成一份可用于月度经营会议的数据简报。成功标准是1覆盖GMV、订单量、客单价、核心品类销量四个核心指标2指出至少3个关键异常点3提供2-3条可落地的运营建议。”结构化工作流Structured Workflow这是Skill的灵魂。你需要把任务分解成明确的、可顺序或条件执行的步骤。通常可以用伪代码或列表来描述1. 输入检查确认用户提供了销售数据CSV文件或数据库查询权限。 2. 数据清洗检查缺失值、异常值并进行标准化处理。 3. 指标计算计算GMV、订单量、环比/同比增长率等。 4. 趋势分析使用折线图识别关键趋势点。 5. 归因分析针对异常趋势结合品类数据尝试归因。 6. 报告生成按照“摘要-数据展示-分析-建议”的模板组织内容。工具集成Tool Integration定义在每个步骤中AI可以或必须调用哪些工具。例如步骤2和3调用pandas库进行数据处理。步骤4调用matplotlib或seaborn库生成图表。步骤5调用内部“产品信息查询API”获取品类详情。知识库与上下文Knowledge Context提供任务相关的背景知识。这可以是几段关键的行业分析框架、公司内部的产品代码对照表、或者一份优秀的分析报告范例。这些内容可以作为“参考材料”注入上下文引导AI的输出风格和质量。输出模板Output Template规定最终产出的格式。是MarkdownWord文档还是带有特定字段的JSON提供一个模板能极大提升结果的一致性和可用性。例如规定分析报告必须包含“## 核心结论”、“### 数据透视表”、“### 趋势图表”、“## 行动建议”等章节。2.3 从Claude Code看Skill的实现载体网络热词中频繁出现的“Claude Code”和“Skill.md”正是这种思想的实践。以Claude Code或类似VSCode中的AI编程助手插件为例它允许开发者创建一个名为SKILL.md的文件。这个文件不是普通的Markdown文档而是一个被AI插件识别并加载的“技能定义文件”。在这个SKILL.md里你可以用特定的格式如YAML Frontmatter或特定的注释标记来定义上面提到的所有要素角色、目标、步骤、可用的代码片段、文件操作权限等。当你在编辑器中激活这个Skill后AI助手就不再是那个只会补全代码的“小助手”而变成了一个能按照你预设的复杂流程如“重构这个函数并添加单元测试”、“为新API生成接口文档和Mock数据”来工作的“开发伙伴”。这种将Skill固化为一个可版本管理、可共享、可复用的文件的做法是AI应用工程化的关键一步。它让AI的能力变得可组合、可积累。你可以为代码审查、数据库调试、UI组件生成等不同场景创建不同的SKILL.md需要时一键切换。3. 实战手把手构建你的第一个AI技能——周报生成器理论说再多不如动手做一个。我们以一个最常见的需求——周报生成——为例展示如何从零构建一个实用的Skill。这个例子不依赖特定平台其设计思路可迁移到任何支持类似功能的AI工具如Cursor、Claude Code、自定义的Agent框架等。3.1 定义技能蓝图明确输入、流程与输出在写任何代码或Prompt之前先进行设计技能名称智能周报助手核心用户需要定期提交工作总结的团队成员、项目经理。输入用户提供的零散工作记录可能是聊天记录、任务列表、邮件摘要等原始文本。核心任务将杂乱的工作记录整理成结构清晰、重点突出、语言专业的周报。成功标准信息归类准确如分为“已完成”、“进行中”、“待启动”、“遇到的问题”。提炼出核心价值和量化成果将“改了代码”转化为“优化了XX接口响应速度峰值延迟降低30%”。格式规范符合公司常用模板。语气积极、协作性强。输出一份完整的Markdown格式周报文档。3.2 编写Skill定义文件以SKILL.md为例下面是一个高度结构化的SKILL.md示例。请注意不同工具的具体语法可能不同但核心结构是相通的。# 技能智能周报助手 **角色**你是一位专业、细致、善于归纳和提炼的行政助理专门帮助技术人员和项目成员撰写工作周报。 **工作边界** 1. 你只处理与工作周报相关的内容。 2. 你必须基于用户提供的原始材料进行总结严禁虚构未提及的工作内容。 3. 你的输出必须积极正面突出团队协作和个人贡献避免负面抱怨。 **工作流程** 请严格按照以下步骤执行 1. **信息提取**仔细阅读用户提供的所有原始文本识别出所有与“工作”相关的活动、任务、会议、沟通、成果或问题。 2. **分类归档**将识别出的信息点归入以下四个类别中 * 本周已完成的工作已经闭环的任务或交付的成果。 * 正在进行中的工作已启动但未结束的任务注明当前进度和下一步计划。 * 计划下周启动的工作已明确安排的下周任务。 * 遇到的问题与风险需要上级或同事协助的阻塞点并附上已尝试的解决方案。 3. **内容精炼**对每一类中的每个信息点进行加工 * **量化**尽可能用数字说明成果如“处理了5个客户问题”、“代码覆盖率提升至85%”。 * **价值化**说明该项工作的意义如“该优化预计每月可节省服务器成本XX元”、“该文档将帮助新成员快速上手”。 * **专业化**使用正式、得体的职场语言。 4. **结构化输出**按照以下模板组织最终周报。模板中的 {} 括号是占位符请用你精炼后的内容填充。 **输出模板** markdown # 【姓名/部门】工作周报YYYY-MM-DD 至 YYYY-MM-DD ## 一、本周工作概要 用2-3句话简要概括本周工作重心和主要成果 ## 二、详细工作内容 ### 1. 本周已完成的工作 - {精炼后的条目1} - {精炼后的条目2} ... ### 2. 正在进行中的工作 - {任务A}当前进度{XX%}下一步计划{...}预计完成时间{...} ... ### 3. 计划下周启动的工作 - {精炼后的条目1} ... ### 4. 遇到的问题与需要的支持 - {问题描述}。已尝试方案{...}。可能需要{XXX方面}的支持。 ... ## 三、总结与下周计划 整体回顾并简要列出下周核心目标 **知识参考** - 优秀周报的特点重点突出、数据支撑、逻辑清晰、计划明确。 - 常用价值表述词汇“推进了”、“完成了”、“优化了”、“解决了”、“协助了”、“梳理了”、“明确了”。 - 避免使用“大概”、“可能”、“基本上”等模糊词汇。3.3 在AI工具中加载与使用创建文件在你的项目目录或AI助手的技能目录下创建weekly_report_skill.md文件将上述内容粘贴进去。加载技能在Claude Code或类似插件中通常有“加载技能”或“导入技能”的命令。执行该命令并指向你的weekly_report_skill.md文件。激活使用加载成功后你可以直接与AI对话。例如你只需输入“这是我的本周工作记录周一修复了登录页面的一个UI错位bug周二和产品开了需求评审会确定了V2.3版本的功能范围周三编写了用户管理模块的API文档但发现两个接口的返回字段定义有冲突需要和后端确认周四开始做新功能的数据库设计。请帮我生成周报。”AI在接收到这条消息时会首先调用已激活的智能周报助手Skill。它会按照Skill中定义的流程先提取信息修复bug、开会、写文档、发现问题、做设计然后分类修复bug和写文档是“已完成”数据库设计是“进行中”需求评审会的结果可归入“下周计划”或“概要”接口字段问题是“问题”接着进行精炼将“修复了UI bug”转化为“完成登录页面UI对齐问题的修复提升了前端视觉一致性”最后套用模板生成一份格式规范、内容翔实的周报草稿。实操心得第一次运行时AI的输出可能不完全符合预期。这很正常。此时不要直接修改用户的输入指令而是去迭代优化你的SKILL.md文件。比如如果AI总是漏掉“会议”类信息就在“信息提取”步骤增加对“会议”、“评审”、“讨论”等关键词的强调。Skill开发也是一个迭代过程。4. 进阶打造复杂技能链与外部工具集成单一技能已经能解决很多问题但AI的真正威力在于将多个技能串联起来并让它能操作“外部世界”。这就进入了AI Agent智能体的领域。4.1 技能链让AI完成多阶段项目假设有一个“市场调研报告生成”的复杂任务。我们可以将其分解为多个子技能并让AI自动串联执行技能A信息搜集员目标根据给定主题在互联网需集成搜索工具或内部知识库中搜集最新、最相关的资料。工具联网搜索API、内部Wiki查询API。输出一份带有来源链接的关键信息列表。技能B信息分析师目标阅读技能A输出的信息列表提炼核心观点、数据趋势、竞争动态。工作流对比分析、归纳共性、识别差异。输出一份结构化分析摘要SWOT分析、市场格局等。技能C报告撰写专家目标基于分析摘要生成符合商业标准的PPT大纲或Word报告。模板固定的报告模板封面、目录、执行摘要、正文、结论建议。输出完整的报告文档。你可以创建一个“调研主管”的Master Skill它的工作流就是“激活技能A - 将A的结果作为输入传给技能B - 将B的结果作为输入传给技能C - 整合最终报告”。AI在这个过程中扮演了项目经理的角色自动调度不同的“专属员工”子技能协同工作。4.2 工具集成赋予AI“手和脚”没有工具集成的AI就像被关在玻璃房里的大脑能思考但无法行动。集成工具是Skills进阶的必经之路。如何集成大多数先进的AI开发框架如LangChain、AutoGen或IDE插件如Claude Code都提供了“工具调用”的接口。你需要定义工具用代码编写一个函数比如def search_web(query: str) - str:这个函数能返回搜索结果。描述工具用自然语言向AI描述这个工具“这是一个网络搜索工具当你需要获取某主题的最新公开信息时可以使用。输入是一个搜索关键词字符串输出是相关的文本摘要。”授予权限在Skill定义中声明本技能有权调用search_web工具。常用工具场景数据获取搜索、数据库查询、API调用如获取天气、股价、新闻。内容处理读写本地文件分析日志、更新配置、调用图像生成模型、进行格式转换。任务自动化发送邮件、创建日历事件、在项目管理工具如Jira中创建任务。一个集成了工具的Skill示例片段# 在Skill定义中声明可用工具 available_tools: - name: get_current_weather description: 获取指定城市的当前天气信息。 parameters: city: 城市名称例如“北京”。 - name: search_company_wiki description: 在公司内部知识库中搜索相关产品文档。 parameters: keyword: 搜索关键词。 # 在工作流中指定工具使用 workflow: - step: 获取天气对出行的潜在影响 action: call_tool tool: get_current_weather input: {city: 上海} save_result_as: weather_info - step: 分析天气影响 action: analyze input: “结合天气信息 {weather_info}分析对明日户外产品推广活动的潜在风险和建议。”避坑指南工具集成最大的风险是权限和安全。绝对不要让AI拥有不受限制的文件系统访问权或网络调用权。务必遵循最小权限原则为每个Skill划定清晰的工具使用范围。例如周报生成Skill只需要读/写特定目录下的文本文件绝不应该有执行系统命令或访问敏感数据库的权限。5. 避坑与优化让Skills真正稳定可靠构建Skills的过程不会一帆风顺。以下是几个最常见的“坑”以及我的应对经验。5.1 模糊指令与幻觉控制问题即使有了SkillAI有时仍会产生“幻觉”编造信息或误解模糊指令。案例在周报Skill中用户输入“这周和小王一起搞定了那个大客户的需求”。AI可能无法准确理解“搞定”的具体含义是签合同了还是只是完成了方案并可能编造“成功签约金额XX万”的细节。解决方案在Skill中强化输入规范在Skill开头明确要求用户“请尽可能提供具体、可验证的工作条目。例如避免使用‘搞定’、‘处理了’等模糊词汇请使用‘完成了XX方案的终版设计并与客户确认’、‘解决了XX系统频繁崩溃的问题’等表述。”设置“置信度检查”步骤在工作流中加入一个检查点。例如“在‘内容精炼’阶段如果你对某个信息点的具体成果或数字不确定必须在输出中明确标注‘[需用户确认...]’而不是自行猜测。”提供反例在Skill的“知识参考”部分加入反面案例“错误示例‘做了很多测试’。正确示例‘完成了用户登录模块的边界条件测试共执行58个测试用例发现并提交了3个中级缺陷。’”5.2 技能冲突与上下文管理问题当同时加载多个Skills时AI可能会混淆不同技能的指令导致行为错乱。案例同时加载了“代码评审员”和“商务写手”两个Skill。当你让它“看看这段文字怎么样”时它可能用代码评审的规则来评审你的商务邮件。解决方案明确的技能触发词为每个Skill设置独特、清晰的触发词或前缀。例如使用周报Skill时必须以“/周报”开头使用代码评审时以“/评审”开头。在Skill定义中写明“本技能仅在用户输入以‘/周报’开头时激活。”独占式上下文一些高级框架允许设置技能的上下文为“独占模式”。当该Skill被激活时对话历史中其他Skill的指令会被暂时屏蔽或弱化确保当前Skill的指令占据主导。人工切换养成好习惯一次只激活一个当前任务最需要的核心Skill用完即关。避免“技能栏”里堆满一堆不相关的技能造成干扰。5.3 性能与成本考量问题复杂的Skill尤其是涉及长上下文、多步骤推理或频繁调用外部工具会导致响应速度变慢并增加API调用成本。案例一个需要先搜索10篇论文、再总结、最后写综述的Skill每次运行都可能消耗大量的Token和API调用次数。优化策略精简Skill描述在保证清晰的前提下尽可能压缩Skill定义文件的字数。移除冗余的、AI可以自行推断的描述性文字。分步执行与缓存对于耗时长的技能链考虑设计成“分步确认”模式。例如先让AI输出搜索关键词和计划经你确认后再执行搜索避免无效的、昂贵的工具调用。本地化与小模型协同将一些固定的、规则性的工作如格式校验、模板填充交给成本更低的本地小模型或简单的规则引擎处理只让大模型如GPT-4、Claude负责最核心的推理、创意和总结工作。5.4 迭代与版本管理Skills不是一蹴而就的。你需要像管理代码一样管理你的Skills。版本控制使用Git来管理你的SKILL.md文件。每次优化后都进行提交并写好变更日志如“V1.1增加了对‘会议’类信息的提取规则”。A/B测试对于关键技能可以创建两个略有不同的版本如V1和V2在相似的任务上对比它们的效果选择更优者。收集反馈建立一个简单的反馈机制。在Skill输出的末尾可以加一句“如果本次结果不符合预期请回复‘优化’我将记录此案例用于改进。” 定期复盘这些案例是提升Skill质量的最佳途径。从让AI“裸奔”到为它配备精良的“Skills”这个过程本质上是在进行AI时代的流程标准化和知识沉淀。你不再是与一个模糊的、通用的智能对话而是在为你特定的业务场景定制一个数字化的、永不疲倦的专家。这其中的核心不在于寻找某个神奇的“终极Prompt”而在于你是否能像一位优秀的架构师或产品经理一样将复杂问题分解并清晰地定义出解决路径。当你开始用Skills的思维去“雇佣”和“培训”你的AI时你会发现它的潜力才刚刚开始被释放。
从Prompt到Skills：构建结构化AI技能，解决复杂任务落地难题
1. 从“裸奔”到“武装”为什么你的AI需要Skills最近跟几个做AI应用开发的朋友聊天发现一个挺普遍的现象大家花了不少心思调教大模型写了几百上千字的Prompt但模型的表现还是时好时坏像个不太靠谱的实习生。你让它写个周报它可能给你编出一段小说你让它分析数据它可能直接开始跟你讨论哲学。这种状态我称之为AI的“裸奔”——它空有强大的通用能力却没有针对你具体业务的“专业技能”和“工作流程”。这其实就是当前AI应用落地的一个核心痛点。我们往往把大模型当作一个“万能问答机”期望通过一段精心设计的提示词Prompt就能解决所有问题。但现实是对于稍微复杂或专业的任务这种“一次性指令”的方式极其脆弱。上下文窗口有限、指令容易遗忘、多步骤任务逻辑混乱……这些问题让AI的潜力大打折扣。而“Skills”这个概念正是解决这个问题的钥匙。你可以把它理解为给AI这位“通用员工”配备的“专属技能包”或“工作手册”。它不是一段简单的Prompt而是一套结构化的指令、工具、工作流和知识库的集合。通过Skills你可以告诉AI“当你遇到A类任务时请按B流程使用C工具参考D文档最终产出E格式的结果。” 这样一来AI就从那个需要你手把手教、还经常出错的“裸奔新手”变成了一个拥有标准化作业流程SOP的“专属员工”。从网络上的讨论热度来看围绕Claude Code、Skill.md模板、Prompt Engineering的搜索非常集中这恰恰印证了市场正从“玩Prompt”向“建Skills”的范式转移。大家不再满足于让AI“说得好听”更希望它“干得漂亮”。接下来我们就深入拆解如何一步步给你的AI穿上“职业装”让它真正成为你团队里高效、可靠的一员。2. 技能架构核心超越Prompt的System级设计要理解Skills首先要跳出“Prompt Engineering”的思维定式。传统的Prompt优化像是在教一个聪明但没经验的人临场发挥。而Skills设计则是为它编写一本详尽的岗位说明书和操作手册。其核心差异在于系统化与结构化。2.1 Prompt的局限性为什么“单次指令”不够用我们常用的对话Prompt存在几个先天不足上下文稀释在长对话中你最早给出的、最关键的指令会被后续的对话内容不断“稀释”模型可能会逐渐偏离最初设定的角色和目标。逻辑链断裂对于需要多步骤、有条件判断的复杂任务单次Prompt很难清晰地定义整个工作流。模型可能会跳过关键步骤或者以错误的顺序执行。工具调用缺失纯粹的文本对话无法让AI直接操作外部工具比如查询数据库、调用API、读写文件、执行代码等。没有工具AI就是个“纸上谈兵”的参谋。知识更新滞后模型的知识有截止日期且无法记忆专属的、动态的业务知识如公司内部数据、最新产品文档。举个例子你给AI一个Prompt“帮我分析一下上个月的销售数据总结趋势并给出下月建议。” 这个指令对AI来说太模糊了。数据在哪什么格式分析哪些维度“趋势”指环比还是同比“建议”需要多具体结果就是AI要么向你追问一堆细节要么基于它的“想象”生成一份泛泛而谈的报告。2.2 Skills的构成要素一个完整的技能包有什么一个完整的Skill应该像一套组合拳包含以下层次身份与边界Role Boundary明确告诉AI“你是谁”以及“你不能做什么”。例如“你是一名专注于电商数据分析的资深顾问。你的职责是依据提供的数据进行分析严禁编造数据或对非数据相关的公司战略发表意见。” 这设定了行为的基调和红线。核心目标与成功标准Goal Success Criteria清晰定义这个Skill要完成的终极任务是什么以及如何衡量任务成功。例如“核心目标是生成一份可用于月度经营会议的数据简报。成功标准是1覆盖GMV、订单量、客单价、核心品类销量四个核心指标2指出至少3个关键异常点3提供2-3条可落地的运营建议。”结构化工作流Structured Workflow这是Skill的灵魂。你需要把任务分解成明确的、可顺序或条件执行的步骤。通常可以用伪代码或列表来描述1. 输入检查确认用户提供了销售数据CSV文件或数据库查询权限。 2. 数据清洗检查缺失值、异常值并进行标准化处理。 3. 指标计算计算GMV、订单量、环比/同比增长率等。 4. 趋势分析使用折线图识别关键趋势点。 5. 归因分析针对异常趋势结合品类数据尝试归因。 6. 报告生成按照“摘要-数据展示-分析-建议”的模板组织内容。工具集成Tool Integration定义在每个步骤中AI可以或必须调用哪些工具。例如步骤2和3调用pandas库进行数据处理。步骤4调用matplotlib或seaborn库生成图表。步骤5调用内部“产品信息查询API”获取品类详情。知识库与上下文Knowledge Context提供任务相关的背景知识。这可以是几段关键的行业分析框架、公司内部的产品代码对照表、或者一份优秀的分析报告范例。这些内容可以作为“参考材料”注入上下文引导AI的输出风格和质量。输出模板Output Template规定最终产出的格式。是MarkdownWord文档还是带有特定字段的JSON提供一个模板能极大提升结果的一致性和可用性。例如规定分析报告必须包含“## 核心结论”、“### 数据透视表”、“### 趋势图表”、“## 行动建议”等章节。2.3 从Claude Code看Skill的实现载体网络热词中频繁出现的“Claude Code”和“Skill.md”正是这种思想的实践。以Claude Code或类似VSCode中的AI编程助手插件为例它允许开发者创建一个名为SKILL.md的文件。这个文件不是普通的Markdown文档而是一个被AI插件识别并加载的“技能定义文件”。在这个SKILL.md里你可以用特定的格式如YAML Frontmatter或特定的注释标记来定义上面提到的所有要素角色、目标、步骤、可用的代码片段、文件操作权限等。当你在编辑器中激活这个Skill后AI助手就不再是那个只会补全代码的“小助手”而变成了一个能按照你预设的复杂流程如“重构这个函数并添加单元测试”、“为新API生成接口文档和Mock数据”来工作的“开发伙伴”。这种将Skill固化为一个可版本管理、可共享、可复用的文件的做法是AI应用工程化的关键一步。它让AI的能力变得可组合、可积累。你可以为代码审查、数据库调试、UI组件生成等不同场景创建不同的SKILL.md需要时一键切换。3. 实战手把手构建你的第一个AI技能——周报生成器理论说再多不如动手做一个。我们以一个最常见的需求——周报生成——为例展示如何从零构建一个实用的Skill。这个例子不依赖特定平台其设计思路可迁移到任何支持类似功能的AI工具如Cursor、Claude Code、自定义的Agent框架等。3.1 定义技能蓝图明确输入、流程与输出在写任何代码或Prompt之前先进行设计技能名称智能周报助手核心用户需要定期提交工作总结的团队成员、项目经理。输入用户提供的零散工作记录可能是聊天记录、任务列表、邮件摘要等原始文本。核心任务将杂乱的工作记录整理成结构清晰、重点突出、语言专业的周报。成功标准信息归类准确如分为“已完成”、“进行中”、“待启动”、“遇到的问题”。提炼出核心价值和量化成果将“改了代码”转化为“优化了XX接口响应速度峰值延迟降低30%”。格式规范符合公司常用模板。语气积极、协作性强。输出一份完整的Markdown格式周报文档。3.2 编写Skill定义文件以SKILL.md为例下面是一个高度结构化的SKILL.md示例。请注意不同工具的具体语法可能不同但核心结构是相通的。# 技能智能周报助手 **角色**你是一位专业、细致、善于归纳和提炼的行政助理专门帮助技术人员和项目成员撰写工作周报。 **工作边界** 1. 你只处理与工作周报相关的内容。 2. 你必须基于用户提供的原始材料进行总结严禁虚构未提及的工作内容。 3. 你的输出必须积极正面突出团队协作和个人贡献避免负面抱怨。 **工作流程** 请严格按照以下步骤执行 1. **信息提取**仔细阅读用户提供的所有原始文本识别出所有与“工作”相关的活动、任务、会议、沟通、成果或问题。 2. **分类归档**将识别出的信息点归入以下四个类别中 * 本周已完成的工作已经闭环的任务或交付的成果。 * 正在进行中的工作已启动但未结束的任务注明当前进度和下一步计划。 * 计划下周启动的工作已明确安排的下周任务。 * 遇到的问题与风险需要上级或同事协助的阻塞点并附上已尝试的解决方案。 3. **内容精炼**对每一类中的每个信息点进行加工 * **量化**尽可能用数字说明成果如“处理了5个客户问题”、“代码覆盖率提升至85%”。 * **价值化**说明该项工作的意义如“该优化预计每月可节省服务器成本XX元”、“该文档将帮助新成员快速上手”。 * **专业化**使用正式、得体的职场语言。 4. **结构化输出**按照以下模板组织最终周报。模板中的 {} 括号是占位符请用你精炼后的内容填充。 **输出模板** markdown # 【姓名/部门】工作周报YYYY-MM-DD 至 YYYY-MM-DD ## 一、本周工作概要 用2-3句话简要概括本周工作重心和主要成果 ## 二、详细工作内容 ### 1. 本周已完成的工作 - {精炼后的条目1} - {精炼后的条目2} ... ### 2. 正在进行中的工作 - {任务A}当前进度{XX%}下一步计划{...}预计完成时间{...} ... ### 3. 计划下周启动的工作 - {精炼后的条目1} ... ### 4. 遇到的问题与需要的支持 - {问题描述}。已尝试方案{...}。可能需要{XXX方面}的支持。 ... ## 三、总结与下周计划 整体回顾并简要列出下周核心目标 **知识参考** - 优秀周报的特点重点突出、数据支撑、逻辑清晰、计划明确。 - 常用价值表述词汇“推进了”、“完成了”、“优化了”、“解决了”、“协助了”、“梳理了”、“明确了”。 - 避免使用“大概”、“可能”、“基本上”等模糊词汇。3.3 在AI工具中加载与使用创建文件在你的项目目录或AI助手的技能目录下创建weekly_report_skill.md文件将上述内容粘贴进去。加载技能在Claude Code或类似插件中通常有“加载技能”或“导入技能”的命令。执行该命令并指向你的weekly_report_skill.md文件。激活使用加载成功后你可以直接与AI对话。例如你只需输入“这是我的本周工作记录周一修复了登录页面的一个UI错位bug周二和产品开了需求评审会确定了V2.3版本的功能范围周三编写了用户管理模块的API文档但发现两个接口的返回字段定义有冲突需要和后端确认周四开始做新功能的数据库设计。请帮我生成周报。”AI在接收到这条消息时会首先调用已激活的智能周报助手Skill。它会按照Skill中定义的流程先提取信息修复bug、开会、写文档、发现问题、做设计然后分类修复bug和写文档是“已完成”数据库设计是“进行中”需求评审会的结果可归入“下周计划”或“概要”接口字段问题是“问题”接着进行精炼将“修复了UI bug”转化为“完成登录页面UI对齐问题的修复提升了前端视觉一致性”最后套用模板生成一份格式规范、内容翔实的周报草稿。实操心得第一次运行时AI的输出可能不完全符合预期。这很正常。此时不要直接修改用户的输入指令而是去迭代优化你的SKILL.md文件。比如如果AI总是漏掉“会议”类信息就在“信息提取”步骤增加对“会议”、“评审”、“讨论”等关键词的强调。Skill开发也是一个迭代过程。4. 进阶打造复杂技能链与外部工具集成单一技能已经能解决很多问题但AI的真正威力在于将多个技能串联起来并让它能操作“外部世界”。这就进入了AI Agent智能体的领域。4.1 技能链让AI完成多阶段项目假设有一个“市场调研报告生成”的复杂任务。我们可以将其分解为多个子技能并让AI自动串联执行技能A信息搜集员目标根据给定主题在互联网需集成搜索工具或内部知识库中搜集最新、最相关的资料。工具联网搜索API、内部Wiki查询API。输出一份带有来源链接的关键信息列表。技能B信息分析师目标阅读技能A输出的信息列表提炼核心观点、数据趋势、竞争动态。工作流对比分析、归纳共性、识别差异。输出一份结构化分析摘要SWOT分析、市场格局等。技能C报告撰写专家目标基于分析摘要生成符合商业标准的PPT大纲或Word报告。模板固定的报告模板封面、目录、执行摘要、正文、结论建议。输出完整的报告文档。你可以创建一个“调研主管”的Master Skill它的工作流就是“激活技能A - 将A的结果作为输入传给技能B - 将B的结果作为输入传给技能C - 整合最终报告”。AI在这个过程中扮演了项目经理的角色自动调度不同的“专属员工”子技能协同工作。4.2 工具集成赋予AI“手和脚”没有工具集成的AI就像被关在玻璃房里的大脑能思考但无法行动。集成工具是Skills进阶的必经之路。如何集成大多数先进的AI开发框架如LangChain、AutoGen或IDE插件如Claude Code都提供了“工具调用”的接口。你需要定义工具用代码编写一个函数比如def search_web(query: str) - str:这个函数能返回搜索结果。描述工具用自然语言向AI描述这个工具“这是一个网络搜索工具当你需要获取某主题的最新公开信息时可以使用。输入是一个搜索关键词字符串输出是相关的文本摘要。”授予权限在Skill定义中声明本技能有权调用search_web工具。常用工具场景数据获取搜索、数据库查询、API调用如获取天气、股价、新闻。内容处理读写本地文件分析日志、更新配置、调用图像生成模型、进行格式转换。任务自动化发送邮件、创建日历事件、在项目管理工具如Jira中创建任务。一个集成了工具的Skill示例片段# 在Skill定义中声明可用工具 available_tools: - name: get_current_weather description: 获取指定城市的当前天气信息。 parameters: city: 城市名称例如“北京”。 - name: search_company_wiki description: 在公司内部知识库中搜索相关产品文档。 parameters: keyword: 搜索关键词。 # 在工作流中指定工具使用 workflow: - step: 获取天气对出行的潜在影响 action: call_tool tool: get_current_weather input: {city: 上海} save_result_as: weather_info - step: 分析天气影响 action: analyze input: “结合天气信息 {weather_info}分析对明日户外产品推广活动的潜在风险和建议。”避坑指南工具集成最大的风险是权限和安全。绝对不要让AI拥有不受限制的文件系统访问权或网络调用权。务必遵循最小权限原则为每个Skill划定清晰的工具使用范围。例如周报生成Skill只需要读/写特定目录下的文本文件绝不应该有执行系统命令或访问敏感数据库的权限。5. 避坑与优化让Skills真正稳定可靠构建Skills的过程不会一帆风顺。以下是几个最常见的“坑”以及我的应对经验。5.1 模糊指令与幻觉控制问题即使有了SkillAI有时仍会产生“幻觉”编造信息或误解模糊指令。案例在周报Skill中用户输入“这周和小王一起搞定了那个大客户的需求”。AI可能无法准确理解“搞定”的具体含义是签合同了还是只是完成了方案并可能编造“成功签约金额XX万”的细节。解决方案在Skill中强化输入规范在Skill开头明确要求用户“请尽可能提供具体、可验证的工作条目。例如避免使用‘搞定’、‘处理了’等模糊词汇请使用‘完成了XX方案的终版设计并与客户确认’、‘解决了XX系统频繁崩溃的问题’等表述。”设置“置信度检查”步骤在工作流中加入一个检查点。例如“在‘内容精炼’阶段如果你对某个信息点的具体成果或数字不确定必须在输出中明确标注‘[需用户确认...]’而不是自行猜测。”提供反例在Skill的“知识参考”部分加入反面案例“错误示例‘做了很多测试’。正确示例‘完成了用户登录模块的边界条件测试共执行58个测试用例发现并提交了3个中级缺陷。’”5.2 技能冲突与上下文管理问题当同时加载多个Skills时AI可能会混淆不同技能的指令导致行为错乱。案例同时加载了“代码评审员”和“商务写手”两个Skill。当你让它“看看这段文字怎么样”时它可能用代码评审的规则来评审你的商务邮件。解决方案明确的技能触发词为每个Skill设置独特、清晰的触发词或前缀。例如使用周报Skill时必须以“/周报”开头使用代码评审时以“/评审”开头。在Skill定义中写明“本技能仅在用户输入以‘/周报’开头时激活。”独占式上下文一些高级框架允许设置技能的上下文为“独占模式”。当该Skill被激活时对话历史中其他Skill的指令会被暂时屏蔽或弱化确保当前Skill的指令占据主导。人工切换养成好习惯一次只激活一个当前任务最需要的核心Skill用完即关。避免“技能栏”里堆满一堆不相关的技能造成干扰。5.3 性能与成本考量问题复杂的Skill尤其是涉及长上下文、多步骤推理或频繁调用外部工具会导致响应速度变慢并增加API调用成本。案例一个需要先搜索10篇论文、再总结、最后写综述的Skill每次运行都可能消耗大量的Token和API调用次数。优化策略精简Skill描述在保证清晰的前提下尽可能压缩Skill定义文件的字数。移除冗余的、AI可以自行推断的描述性文字。分步执行与缓存对于耗时长的技能链考虑设计成“分步确认”模式。例如先让AI输出搜索关键词和计划经你确认后再执行搜索避免无效的、昂贵的工具调用。本地化与小模型协同将一些固定的、规则性的工作如格式校验、模板填充交给成本更低的本地小模型或简单的规则引擎处理只让大模型如GPT-4、Claude负责最核心的推理、创意和总结工作。5.4 迭代与版本管理Skills不是一蹴而就的。你需要像管理代码一样管理你的Skills。版本控制使用Git来管理你的SKILL.md文件。每次优化后都进行提交并写好变更日志如“V1.1增加了对‘会议’类信息的提取规则”。A/B测试对于关键技能可以创建两个略有不同的版本如V1和V2在相似的任务上对比它们的效果选择更优者。收集反馈建立一个简单的反馈机制。在Skill输出的末尾可以加一句“如果本次结果不符合预期请回复‘优化’我将记录此案例用于改进。” 定期复盘这些案例是提升Skill质量的最佳途径。从让AI“裸奔”到为它配备精良的“Skills”这个过程本质上是在进行AI时代的流程标准化和知识沉淀。你不再是与一个模糊的、通用的智能对话而是在为你特定的业务场景定制一个数字化的、永不疲倦的专家。这其中的核心不在于寻找某个神奇的“终极Prompt”而在于你是否能像一位优秀的架构师或产品经理一样将复杂问题分解并清晰地定义出解决路径。当你开始用Skills的思维去“雇佣”和“培训”你的AI时你会发现它的潜力才刚刚开始被释放。 
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
