最近折腾AI工具链的时候我注意到Claude Skills这个名字出现频率越来越高。在Claude里用多了就会发现一个很现实的问题同样一件工作每次对话都要把背景、格式、步骤重新交代一遍既累又容易漏。Claude Skills这个功能把这类重复劳动直接封装成技能包让Claude在需要的时候自动加载对应的工作流程和工具省掉大量重复描述。这篇文章我会从设计思路、目录结构、完整实操和问题排查几个角度展开把真正落地的经验讲清楚适合正在用Claude做实际工作、想让AI处理更复杂任务的读者。1. Claude Skills到底做了什么从每次对话重新交代到随叫随到的工具箱1.1 为什么Prompt越写越长反而不好用很多人刚开始用Claude的时候有一个习惯为了让回答更符合自己的需求把prompt写得特别长背景、角色、输出格式、注意事项全塞进去。我也这么干过一条prompt能写到两三千字。但实际用下来发现几个问题提示词越长Claude在理解上的注意力越分散核心要求反而容易被淹没改一处格式整段prompt就要跟着调整维护成本很高不同项目之间想复用同一套工作流只能靠复制粘贴时间一长就乱了。Claude Skills解决的是这个根子上的问题。它不再要求你在每次对话里把怎么做讲一遍而是把怎么做封装成一个独立的技能包里面既包含给Claude看的说明文档也包含实际执行的脚本、模板、参考资源。Claude会在对话中根据当前任务自动判断这时候该用哪个技能然后加载这个技能包按照里面的步骤来干活。有朋友把这种做法类比成给Claude配了一个工具箱平时工具放在架子上需要拧螺丝的时候Claude自己走过去把螺丝刀拿起来而不是你每次都要口头描述一遍螺丝刀长什么样、怎么握、拧几圈。这个类比很贴近。1.2 Skills的结构一个技能包 说明文档 可执行文件看一下一个典型的Claude Skills技能包内部究竟有什么。按照常见实践一个技能包就是一个文件夹里面最关键的是SKILL.md文件这个文件是整个技能包的说明书。SKILL.md里分成两部分讲前面是元信息区用YAML格式写入技能的name名称和description功能描述后面是正文用Markdown格式写清楚这个技能的适用场景、执行步骤、注意事项、输入输出要求。除了SKILL.md技能包文件夹里还可以放scripts脚本文件、templates模板、references参考资料等Claude在运行技能时可以读取这些文件来完成具体操作。这种结构设计的巧妙之处在于按需加载。如果没有Skills机制Claude需要在每一轮对话里通过上下文理解你给的一大堆规则有了Skills机制Claude只在检测到任务匹配时才会加载SKILL.md的内容平时不占上下文空间。这让对话更轻快也让复杂任务的执行路径更加明确。1.3 为什么说它是AI战力的隐藏开关解锁AI隐藏战力这个说法我挺认可的。经常用AI的人都会发现Claude本身的能力上限并不低真正限制它发挥的是调用方式一个好的工作流能让Claude的表现上限大幅拉高而一个糟糕的交互方式可能连它基础水平都发挥不出来。Skills本质上就是一种工作流的标准化封装。一旦你为一个高频场景写好了技能包后续再遇到同类任务就完全不用重新描述Claude会直接按照你封装好的流程执行。这相当于把之前写在prompt里的经验沉淀成了可复用、可迭代、可共享的资产长期用下来效率提升非常明显。我个人的感受是如果只是问问题、写文案用不用Skills差别不大但如果是高频的、有一定流程性的工作比如整理会议纪要、批量处理数据文件、生成周报、做代码审查Skills的配置与否差距能到两三倍以上。这篇博文后面我会用具体的操作案例展示这个差距到底是怎么拉开的。2. 动手之前必须想清楚技能包的目录规范与编写逻辑2.1 目录放在哪里、怎么放在Claude Code这类命令行环境下Skills的存放路径是用户目录下的.claude文件夹技能放在skills子目录里。也就是说标准路径是~/.claude/skills/每个技能包是这里面一个独立的子文件夹。我自己还会在skills目录里维护一个统一的命名规范技能文件夹名称用英文短横线连接一眼能看出用途比如meeting-notes、weekly-report、code-review。如果一个技能包里需要放多个文件我习惯这样组织~/.claude/skills/ └── meeting-notes/ ├── SKILL.md ├── scripts/ │ ├── parse_notes.py │ └── generate_summary.py ├── templates/ │ └── meeting_note_template.md └── references/ └── format_example.mdSKILL.md放在技能包根目录scripts里放实际干活用的脚本templates放输出用的模板references放参考资料或示例。这种分层方式的好处是Claude读取SKILL.md时能快速理解流程需要执行具体任务时又能准确找到脚本和模板各司其职互不干扰。2.2 SKILL.md怎么写才能让Claude准确识别SKILL.md是整个技能包的核心。写这个文件时最需要花心思的是开头的YAML元信息区尤其是description那一行。很多初学者以为描述写得越详细越好实际上description的作用是让Claude在对话中快速判断这个技能适不适合当前任务。如果description写得过于宽泛Claude可能在不需要的地方触发技能写得太窄真正需要的时候又触发不了直接导致技能失灵。我自己写description的时候遵循三个原则第一明确列出触发场景比如当用户要求整理会议纪要、总结讨论结论、提取行动项时使用第二写明技能的主要功能和输出形式让Claude知道用了这个技能能产出什么东西第三必要时加一句排除说明比如仅用于中文会议内容英文会议请使用其他技能减少误触发。SKILL.md正文部分要回答四个问题这个技能是干什么的什么时候该用具体怎么操作输出结果应该长什么样。正文里不要写大段理论直接用步骤式说明最好配合具体的模板示例Claude照着做就能输出稳定格式。格式稳定这件事非常关键因为AI生成的文本天然容易发散你用模板把框架框住结果才能保持一致性。2.3 一个经典反例description写得像散文的后果说一个我踩过的坑。最早我给一个数据清洗技能写description写的是这个技能可以帮助用户处理各种数据文件包括清理脏数据、补全缺失字段、去除重复记录等等适用于数据分析场景。看起来没什么问题但它犯了什么都说了又什么都没说的毛病。实际用的时候Claude在用户聊到Excel表格、CSV文件时经常自动触发这个技能哪怕用户只是想简单问一句这个表格怎么排序也会被拖进完整的数据清洗流程输出反而笨重。后来我把description改成当用户需要清理/规整结构化数据文件CSV、Excel等包括去重、补全缺失值、统一字段格式时使用。若用户仅询问数据处理思路不需要实际清洗文件则不使用本技能。加了排除条件之后误触发率明显下降。这个教训说明技能的description不是给用户看的是给Claude的检索系统看的写得好不好直接决定这个技能在不该出现的时候会不会出现。3. 从零搭一个会议纪要整理技能完整实操记录3.1 第一步准备技能包目录与基础脚本光讲概念不如直接动手。我拿一个最常见的场景来演示会议纪要整理。这个任务的特点是流程固定、格式要求多、每天都会遇到非常适合做成技能包。先在终端里执行mkdir -p ~/.claude/skills/meeting-notes/scripts mkdir -p ~/.claude/skills/meeting-notes/templates mkdir -p ~/.claude/skills/meeting-notes/references目录建好之后开始准备脚本。我的方案是给这个技能配一个Python脚本parse_notes.py作用是把用户丢进来的口语化会议记录做初步结构化。import sys def parse_notes(raw_text: str) - dict: lines raw_text.strip().splitlines() topics [] actions [] current_topic None for line in lines: line line.strip() if not line: continue if line.startswith(议题) or line.startswith(Topic): current_topic line.split(, 1)[-1].split(:, 1)[-1] topics.append({topic: current_topic, content: []}) elif line.startswith(行动项) or line.startswith(Action): action_text line.split(, 1)[-1].split(:, 1)[-1] actions.append(action_text) else: if current_topic and topics: topics[-1][content].append(line) return {topics: topics, actions: actions} if __name__ __main__: raw sys.stdin.read() result parse_notes(raw) for t in result[topics]: print(f议题{t[topic]}) for c in t[content]: print(f - {c}) print(行动项) for a in result[actions]: print(f - {a})这个脚本不做复杂的事情只做分块把杂乱记录里的议题和行动项挑出来。够用而且容易让Claude理解整个流程。脚本的价值在于它给Claude提供了确定性无论你的原始记录多乱脚本输出的结构是稳定的Claude基于这个稳定结构做后面的归纳总结准确率会高很多。3.2 第二步编写能被自动触发的SKILL.md脚本准备好后开始写SKILL.md。这是技能包能被正常加载的关键文件我完整的写法是这样的--- name: meeting-notes description: 当用户提供会议原始记录或讨论文本要求整理会议纪要、提取议题、归纳讨论内容、生成行动项时使用。适用于中文会议内容。如果用户只是询问会议记录建议而不是实际整理文本则不要使用本技能。 --- # 会议纪要整理技能 ## 输入要求 - 用户提供会议原始记录文本可能是流水账、碎片化笔记或语音转写内容。 ## 执行步骤 1. 将用户提供的原始文本交给 scripts/parse_notes.py 处理获得结构化的议题与行动项。 2. 基于结构化结果按 templates/meeting_note_template.md 的格式生成会议纪要。 3. 对每个议题补充结论部分归纳讨论中达成的一致意见。 4. 对每个行动项补充负责人与截止时间缺失时用待确认标注。 ## 输出要求 - 严格按照模板格式输出。 - 用户补充的信息必须保留不擅自修改原始结论。 - 如果原始记录信息不足在对应位置标注[信息缺失]不要编造内容。description部分的写法要特别留意第一句说明触发场景第二句限定适用内容范围第三句用排除条件降低误触发概率。正文部分关键词是执行步骤和输出要求步骤让Claude有一个顺序执行的路径输出要求则避免它自由发挥。3.3 第三步让技能真正跑起来接下来准备模板文件。在templates目录下新建meeting_note_template.md# 会议纪要 ## 基本信息 - 日期待补充 - 参与人待补充 - 会议主题待补充 ## 议题讨论 ### 议题1议题名称 - 讨论要点... - 结论... ### 议题2议题名称 - 讨论要点... - 结论... ## 行动项 | 序号 | 行动项 | 负责人 | 截止时间 | |------|--------|--------|----------| | 1 | ... | ... | ... |模板的作用是给Claude一个稳定的输出框架。如果没有模板Claude每次生成的会议纪要格式都会有细微差别日期放哪里、行动项用表格还是列表每次都看它心情。有了模板输出的一致性立刻就能保证。准备工作完成后直接在Claude Code里输入一段会议记录测试下午三点的项目会对齐了三个事情一个是首页改版已经确认上线时间是月底交互细节还要补两个页面。另一个是数据埋点方案开发说这周能完成技术评估下周出完整方案。第三个是用户反馈处理流程大家讨论下来决定先做模板化回复。行动项张三负责补交互页面周四前给到设计稿李四跟进数据埋点技术评估周五同步结论王五整理反馈模板下周一出初稿。触发时机到了之后Claude自动调用meeting-notes技能Python脚本把上面的口语化记录解析成议题和行动项然后按模板生成完整纪要。整个过程用户不需要输入任何额外指令只要说要整理会议纪要技能就自己启动了。3.4 第四步测试-修正-迭代技能包第一次跑通之后并不意味着就完事了。我每次新建技能包都会做至少三轮测试第一轮用标准输入看正常流程是否跑通第二轮用缺信息的输入看Claude是否按输出要求标注[信息缺失]而不是自己编造第三轮用接近真实场景的脏输入比如夹杂无关闲聊、输入内容里有错别字、一段话包含多个议题考验技能在混乱情况下的处理能力。每次测试发现的问题简单改改SKILL.md里的执行步骤或输出要求就行不用动代码。这也是我推荐技能逻辑尽量放在SKILL.md里、脚本只做最基础结构处理的原因——脚本改起来麻烦文档改起来容易。4. 常见问题与排查技巧实录4.1 为什么Claude就是不调用我的技能这是群里朋友问得最多的问题。技能包配置好了SKILL.md也写了但对话里输入相关请求时Claude完全无视技能还是按普通模式回答。遇到这种情况先别急着怀疑配置对照下面几个常见原因排查。第一个原因是路径错了。有些人把技能包直接放在了~/.claude/下没有放进skills/子目录或者技能文件夹大小写、命名不规范导致加载不上。我一般用命令确认路径ls -la ~/.claude/skills/看看技能包文件夹是否存在以及SKILL.md是不是直接在技能包根目录下。另一个容易犯的错是把SKILL.md放进了子目录里Claude找不到。第二个原因是description写得和用户实际表达对不上。比如你的技能是针对周报生成的触发条件写的是当用户提到周报时但实际上用户可能说的是帮我写一下这周工作总结语义不同Claude就不会匹配。排查方法是把description改成覆盖更多自然口语表达或者把常见的用户说法直接写进去比如周报、工作总结、本周进展都可以触发。第三个原因是环境缓存问题。修改SKILL.md后某些情况下Claude的会话还缓存着旧信息新技能不会立刻生效。重启一下会话或者重新加载配置大部分时候能解决。4.2 脚本报错、乱码、路径失效怎么排查技能能触发但执行时报错是另一个常见问题排查方向。脚本报错往往集中在三个地方。第一个是解释器路径问题。脚本开头写了#!/usr/bin/env python3但实际环境里Python没装或者不是这个路径执行就会失败。确保你在命令行里能直接运行脚本python3 ~/.claude/skills/meeting-notes/scripts/parse_notes.py第二个是编码问题。Windows下编辑的脚本文件默认可能是GBK编码Linux环境下会读乱码。最好的做法是脚本文件全部保存为UTF-8编码并且在Python脚本开头加编码声明或者用encodingutf-8的方式读写文件。第三个是路径失效问题。脚本里如果用了绝对路径比如/Users/xxx/...一旦技能包被拷贝到别的机器或别的用户目录路径就会失效。正确做法是在脚本内部用相对路径或者基于当前文件位置动态拼接路径。比如Python里用Path(__file__).parent来定位脚本所在目录再往上一级找到模板目录。4.3 一套实用的排查清单踩过几次坑之后我整理了一个排查顺序每次技能不工作就按这个顺序查基本几分钟内能定位问题。排查项检查重点快速验证方法路径技能包是否在~/.claude/skills/下ls ~/.claude/skills/结构SKILL.md 是否在技能包根目录find ~/.claude/skills/meeting-notes -maxdepth 1 -name SKILL.md描述description 是否覆盖触发场景用多种口语方式描述同一任务再测试脚本脚本能否独立运行直接命令行执行脚本并传测试输入编码文件是否UTF-8、换行是否正确file SKILL.md scripts/*.py重启技能修改后是否有缓存重启会话后再测试这个清单也分享给过几个朋友他们按这个流程排查基本都能自己解决问题不用到处问人。实际上多数技能不生效的情况都出在前三项也就是路径、结构、描述真正代码层面的问题反而少。5. 进阶思路让多个技能组合起来干活5.1 技能叠加的低配方法单个技能包能解决单个固定场景但真实工作里很多任务是多步骤的组合。比如每周一上午我来公司要做的事情是查看上周项目进展记录、汇总本周计划、生成周报发给团队。这三件事分别对应三个技能但如果每次都要手动触发三个技能又回到了反复交代的老路。比较简单的做法是在一个技能包内完成多步骤编排。也就是说不把周报生成定义成一个单步技能而是定义成读取项目记录、整理进展、生成周报的完整流程。SKILL.md里写清楚先做什么、再做什么、最后输出什么让Claude按流程执行。这种方法实现成本低但灵活性差一点每次都是同样的步骤没法中途插进来一个变化。5.2 给技能加输入输出契约想让技能组合更灵活一个更有价值的做法是给每个技能定义明确的输入输出契约这个技能接收什么格式的数据产出的结果是什么格式。当技能A的输出正好技能B能接收时就可以链式调用。举一个实际的例子。我有一个会议纪要整理技能输出的是Markdown格式的会议纪要另一个行动项跟踪技能接收的输入正好是会议纪要里的行动项表格。实际用的时候用户只需要说把这周的会议纪要和上周的行动项合并一下Claude先用纪要技能整理出当周行动项再调用跟踪技能把新旧行动项合并生成一张完整的行动项清单。这种方式大大提升了Claude处理复杂任务的能力。关键是每个技能的输入输出格式要稳定、要有明确约定否则技能之间没法对接。5.3 给团队沉淀技能库的运营思路Skills这套机制还有个特别实用的场景团队内部的经验沉淀。以前组里来了新人要把很多工作流程通过文档、培训讲清楚现在可以把这些流程直接做成技能包新人只需要在Claude里调用对应的技能就能按团队的标准流程干活。比如某内容团队把公众号排版规则做成一个技能包里面包含排版规范、常见样式、审核清单。新编辑用Claude写文章时只要让AI按这个技能来排版产出格式就自动符合团队要求。现场教学的成本大幅降低而且技能包可以持续迭代规范更新了直接改SKILL.md全团队立刻生效。不过有几个经验值得分享技能包命名要团队统一不然时间长了就乱每个技能包要指定一个人维护避免多人同时改造成冲突技能包在正式使用前至少要跑过一次完整测试甚至可以考虑维护一份技能包CHANGELOG记录每次修改了什么、为什么改。把这些细节管理好技能库就不再是个人效率工具而是团队级别的知识资产。我在实际使用中最大的体会是Skills能自动帮我保持稳定输出同一类事情不管什么时候交给Claude出来的结果格式和风格几乎一致。这一点价值被很多人低估了——AI本身有很强的能力但如果没有固化流程能力发挥很不稳定。技能包相当于把稳定的好保存了下来。最后再分享一个小技巧新技能上线前主动喂给它一个真实的失败案例看看它怎么处理异常情况比测试十个正常输入都管用。 
长河君 · 2026/10/21 21:46:43 · 阅读 1.2k Claude Skills实战：用技能包固化AI工作流，告别重复Prompt
最近折腾AI工具链的时候我注意到Claude Skills这个名字出现频率越来越高。在Claude里用多了就会发现一个很现实的问题同样一件工作每次对话都要把背景、格式、步骤重新交代一遍既累又容易漏。Claude Skills这个功能把这类重复劳动直接封装成技能包让Claude在需要的时候自动加载对应的工作流程和工具省掉大量重复描述。这篇文章我会从设计思路、目录结构、完整实操和问题排查几个角度展开把真正落地的经验讲清楚适合正在用Claude做实际工作、想让AI处理更复杂任务的读者。1. Claude Skills到底做了什么从每次对话重新交代到随叫随到的工具箱1.1 为什么Prompt越写越长反而不好用很多人刚开始用Claude的时候有一个习惯为了让回答更符合自己的需求把prompt写得特别长背景、角色、输出格式、注意事项全塞进去。我也这么干过一条prompt能写到两三千字。但实际用下来发现几个问题提示词越长Claude在理解上的注意力越分散核心要求反而容易被淹没改一处格式整段prompt就要跟着调整维护成本很高不同项目之间想复用同一套工作流只能靠复制粘贴时间一长就乱了。Claude Skills解决的是这个根子上的问题。它不再要求你在每次对话里把怎么做讲一遍而是把怎么做封装成一个独立的技能包里面既包含给Claude看的说明文档也包含实际执行的脚本、模板、参考资源。Claude会在对话中根据当前任务自动判断这时候该用哪个技能然后加载这个技能包按照里面的步骤来干活。有朋友把这种做法类比成给Claude配了一个工具箱平时工具放在架子上需要拧螺丝的时候Claude自己走过去把螺丝刀拿起来而不是你每次都要口头描述一遍螺丝刀长什么样、怎么握、拧几圈。这个类比很贴近。1.2 Skills的结构一个技能包 说明文档 可执行文件看一下一个典型的Claude Skills技能包内部究竟有什么。按照常见实践一个技能包就是一个文件夹里面最关键的是SKILL.md文件这个文件是整个技能包的说明书。SKILL.md里分成两部分讲前面是元信息区用YAML格式写入技能的name名称和description功能描述后面是正文用Markdown格式写清楚这个技能的适用场景、执行步骤、注意事项、输入输出要求。除了SKILL.md技能包文件夹里还可以放scripts脚本文件、templates模板、references参考资料等Claude在运行技能时可以读取这些文件来完成具体操作。这种结构设计的巧妙之处在于按需加载。如果没有Skills机制Claude需要在每一轮对话里通过上下文理解你给的一大堆规则有了Skills机制Claude只在检测到任务匹配时才会加载SKILL.md的内容平时不占上下文空间。这让对话更轻快也让复杂任务的执行路径更加明确。1.3 为什么说它是AI战力的隐藏开关解锁AI隐藏战力这个说法我挺认可的。经常用AI的人都会发现Claude本身的能力上限并不低真正限制它发挥的是调用方式一个好的工作流能让Claude的表现上限大幅拉高而一个糟糕的交互方式可能连它基础水平都发挥不出来。Skills本质上就是一种工作流的标准化封装。一旦你为一个高频场景写好了技能包后续再遇到同类任务就完全不用重新描述Claude会直接按照你封装好的流程执行。这相当于把之前写在prompt里的经验沉淀成了可复用、可迭代、可共享的资产长期用下来效率提升非常明显。我个人的感受是如果只是问问题、写文案用不用Skills差别不大但如果是高频的、有一定流程性的工作比如整理会议纪要、批量处理数据文件、生成周报、做代码审查Skills的配置与否差距能到两三倍以上。这篇博文后面我会用具体的操作案例展示这个差距到底是怎么拉开的。2. 动手之前必须想清楚技能包的目录规范与编写逻辑2.1 目录放在哪里、怎么放在Claude Code这类命令行环境下Skills的存放路径是用户目录下的.claude文件夹技能放在skills子目录里。也就是说标准路径是~/.claude/skills/每个技能包是这里面一个独立的子文件夹。我自己还会在skills目录里维护一个统一的命名规范技能文件夹名称用英文短横线连接一眼能看出用途比如meeting-notes、weekly-report、code-review。如果一个技能包里需要放多个文件我习惯这样组织~/.claude/skills/ └── meeting-notes/ ├── SKILL.md ├── scripts/ │ ├── parse_notes.py │ └── generate_summary.py ├── templates/ │ └── meeting_note_template.md └── references/ └── format_example.mdSKILL.md放在技能包根目录scripts里放实际干活用的脚本templates放输出用的模板references放参考资料或示例。这种分层方式的好处是Claude读取SKILL.md时能快速理解流程需要执行具体任务时又能准确找到脚本和模板各司其职互不干扰。2.2 SKILL.md怎么写才能让Claude准确识别SKILL.md是整个技能包的核心。写这个文件时最需要花心思的是开头的YAML元信息区尤其是description那一行。很多初学者以为描述写得越详细越好实际上description的作用是让Claude在对话中快速判断这个技能适不适合当前任务。如果description写得过于宽泛Claude可能在不需要的地方触发技能写得太窄真正需要的时候又触发不了直接导致技能失灵。我自己写description的时候遵循三个原则第一明确列出触发场景比如当用户要求整理会议纪要、总结讨论结论、提取行动项时使用第二写明技能的主要功能和输出形式让Claude知道用了这个技能能产出什么东西第三必要时加一句排除说明比如仅用于中文会议内容英文会议请使用其他技能减少误触发。SKILL.md正文部分要回答四个问题这个技能是干什么的什么时候该用具体怎么操作输出结果应该长什么样。正文里不要写大段理论直接用步骤式说明最好配合具体的模板示例Claude照着做就能输出稳定格式。格式稳定这件事非常关键因为AI生成的文本天然容易发散你用模板把框架框住结果才能保持一致性。2.3 一个经典反例description写得像散文的后果说一个我踩过的坑。最早我给一个数据清洗技能写description写的是这个技能可以帮助用户处理各种数据文件包括清理脏数据、补全缺失字段、去除重复记录等等适用于数据分析场景。看起来没什么问题但它犯了什么都说了又什么都没说的毛病。实际用的时候Claude在用户聊到Excel表格、CSV文件时经常自动触发这个技能哪怕用户只是想简单问一句这个表格怎么排序也会被拖进完整的数据清洗流程输出反而笨重。后来我把description改成当用户需要清理/规整结构化数据文件CSV、Excel等包括去重、补全缺失值、统一字段格式时使用。若用户仅询问数据处理思路不需要实际清洗文件则不使用本技能。加了排除条件之后误触发率明显下降。这个教训说明技能的description不是给用户看的是给Claude的检索系统看的写得好不好直接决定这个技能在不该出现的时候会不会出现。3. 从零搭一个会议纪要整理技能完整实操记录3.1 第一步准备技能包目录与基础脚本光讲概念不如直接动手。我拿一个最常见的场景来演示会议纪要整理。这个任务的特点是流程固定、格式要求多、每天都会遇到非常适合做成技能包。先在终端里执行mkdir -p ~/.claude/skills/meeting-notes/scripts mkdir -p ~/.claude/skills/meeting-notes/templates mkdir -p ~/.claude/skills/meeting-notes/references目录建好之后开始准备脚本。我的方案是给这个技能配一个Python脚本parse_notes.py作用是把用户丢进来的口语化会议记录做初步结构化。import sys def parse_notes(raw_text: str) - dict: lines raw_text.strip().splitlines() topics [] actions [] current_topic None for line in lines: line line.strip() if not line: continue if line.startswith(议题) or line.startswith(Topic): current_topic line.split(, 1)[-1].split(:, 1)[-1] topics.append({topic: current_topic, content: []}) elif line.startswith(行动项) or line.startswith(Action): action_text line.split(, 1)[-1].split(:, 1)[-1] actions.append(action_text) else: if current_topic and topics: topics[-1][content].append(line) return {topics: topics, actions: actions} if __name__ __main__: raw sys.stdin.read() result parse_notes(raw) for t in result[topics]: print(f议题{t[topic]}) for c in t[content]: print(f - {c}) print(行动项) for a in result[actions]: print(f - {a})这个脚本不做复杂的事情只做分块把杂乱记录里的议题和行动项挑出来。够用而且容易让Claude理解整个流程。脚本的价值在于它给Claude提供了确定性无论你的原始记录多乱脚本输出的结构是稳定的Claude基于这个稳定结构做后面的归纳总结准确率会高很多。3.2 第二步编写能被自动触发的SKILL.md脚本准备好后开始写SKILL.md。这是技能包能被正常加载的关键文件我完整的写法是这样的--- name: meeting-notes description: 当用户提供会议原始记录或讨论文本要求整理会议纪要、提取议题、归纳讨论内容、生成行动项时使用。适用于中文会议内容。如果用户只是询问会议记录建议而不是实际整理文本则不要使用本技能。 --- # 会议纪要整理技能 ## 输入要求 - 用户提供会议原始记录文本可能是流水账、碎片化笔记或语音转写内容。 ## 执行步骤 1. 将用户提供的原始文本交给 scripts/parse_notes.py 处理获得结构化的议题与行动项。 2. 基于结构化结果按 templates/meeting_note_template.md 的格式生成会议纪要。 3. 对每个议题补充结论部分归纳讨论中达成的一致意见。 4. 对每个行动项补充负责人与截止时间缺失时用待确认标注。 ## 输出要求 - 严格按照模板格式输出。 - 用户补充的信息必须保留不擅自修改原始结论。 - 如果原始记录信息不足在对应位置标注[信息缺失]不要编造内容。description部分的写法要特别留意第一句说明触发场景第二句限定适用内容范围第三句用排除条件降低误触发概率。正文部分关键词是执行步骤和输出要求步骤让Claude有一个顺序执行的路径输出要求则避免它自由发挥。3.3 第三步让技能真正跑起来接下来准备模板文件。在templates目录下新建meeting_note_template.md# 会议纪要 ## 基本信息 - 日期待补充 - 参与人待补充 - 会议主题待补充 ## 议题讨论 ### 议题1议题名称 - 讨论要点... - 结论... ### 议题2议题名称 - 讨论要点... - 结论... ## 行动项 | 序号 | 行动项 | 负责人 | 截止时间 | |------|--------|--------|----------| | 1 | ... | ... | ... |模板的作用是给Claude一个稳定的输出框架。如果没有模板Claude每次生成的会议纪要格式都会有细微差别日期放哪里、行动项用表格还是列表每次都看它心情。有了模板输出的一致性立刻就能保证。准备工作完成后直接在Claude Code里输入一段会议记录测试下午三点的项目会对齐了三个事情一个是首页改版已经确认上线时间是月底交互细节还要补两个页面。另一个是数据埋点方案开发说这周能完成技术评估下周出完整方案。第三个是用户反馈处理流程大家讨论下来决定先做模板化回复。行动项张三负责补交互页面周四前给到设计稿李四跟进数据埋点技术评估周五同步结论王五整理反馈模板下周一出初稿。触发时机到了之后Claude自动调用meeting-notes技能Python脚本把上面的口语化记录解析成议题和行动项然后按模板生成完整纪要。整个过程用户不需要输入任何额外指令只要说要整理会议纪要技能就自己启动了。3.4 第四步测试-修正-迭代技能包第一次跑通之后并不意味着就完事了。我每次新建技能包都会做至少三轮测试第一轮用标准输入看正常流程是否跑通第二轮用缺信息的输入看Claude是否按输出要求标注[信息缺失]而不是自己编造第三轮用接近真实场景的脏输入比如夹杂无关闲聊、输入内容里有错别字、一段话包含多个议题考验技能在混乱情况下的处理能力。每次测试发现的问题简单改改SKILL.md里的执行步骤或输出要求就行不用动代码。这也是我推荐技能逻辑尽量放在SKILL.md里、脚本只做最基础结构处理的原因——脚本改起来麻烦文档改起来容易。4. 常见问题与排查技巧实录4.1 为什么Claude就是不调用我的技能这是群里朋友问得最多的问题。技能包配置好了SKILL.md也写了但对话里输入相关请求时Claude完全无视技能还是按普通模式回答。遇到这种情况先别急着怀疑配置对照下面几个常见原因排查。第一个原因是路径错了。有些人把技能包直接放在了~/.claude/下没有放进skills/子目录或者技能文件夹大小写、命名不规范导致加载不上。我一般用命令确认路径ls -la ~/.claude/skills/看看技能包文件夹是否存在以及SKILL.md是不是直接在技能包根目录下。另一个容易犯的错是把SKILL.md放进了子目录里Claude找不到。第二个原因是description写得和用户实际表达对不上。比如你的技能是针对周报生成的触发条件写的是当用户提到周报时但实际上用户可能说的是帮我写一下这周工作总结语义不同Claude就不会匹配。排查方法是把description改成覆盖更多自然口语表达或者把常见的用户说法直接写进去比如周报、工作总结、本周进展都可以触发。第三个原因是环境缓存问题。修改SKILL.md后某些情况下Claude的会话还缓存着旧信息新技能不会立刻生效。重启一下会话或者重新加载配置大部分时候能解决。4.2 脚本报错、乱码、路径失效怎么排查技能能触发但执行时报错是另一个常见问题排查方向。脚本报错往往集中在三个地方。第一个是解释器路径问题。脚本开头写了#!/usr/bin/env python3但实际环境里Python没装或者不是这个路径执行就会失败。确保你在命令行里能直接运行脚本python3 ~/.claude/skills/meeting-notes/scripts/parse_notes.py第二个是编码问题。Windows下编辑的脚本文件默认可能是GBK编码Linux环境下会读乱码。最好的做法是脚本文件全部保存为UTF-8编码并且在Python脚本开头加编码声明或者用encodingutf-8的方式读写文件。第三个是路径失效问题。脚本里如果用了绝对路径比如/Users/xxx/...一旦技能包被拷贝到别的机器或别的用户目录路径就会失效。正确做法是在脚本内部用相对路径或者基于当前文件位置动态拼接路径。比如Python里用Path(__file__).parent来定位脚本所在目录再往上一级找到模板目录。4.3 一套实用的排查清单踩过几次坑之后我整理了一个排查顺序每次技能不工作就按这个顺序查基本几分钟内能定位问题。排查项检查重点快速验证方法路径技能包是否在~/.claude/skills/下ls ~/.claude/skills/结构SKILL.md 是否在技能包根目录find ~/.claude/skills/meeting-notes -maxdepth 1 -name SKILL.md描述description 是否覆盖触发场景用多种口语方式描述同一任务再测试脚本脚本能否独立运行直接命令行执行脚本并传测试输入编码文件是否UTF-8、换行是否正确file SKILL.md scripts/*.py重启技能修改后是否有缓存重启会话后再测试这个清单也分享给过几个朋友他们按这个流程排查基本都能自己解决问题不用到处问人。实际上多数技能不生效的情况都出在前三项也就是路径、结构、描述真正代码层面的问题反而少。5. 进阶思路让多个技能组合起来干活5.1 技能叠加的低配方法单个技能包能解决单个固定场景但真实工作里很多任务是多步骤的组合。比如每周一上午我来公司要做的事情是查看上周项目进展记录、汇总本周计划、生成周报发给团队。这三件事分别对应三个技能但如果每次都要手动触发三个技能又回到了反复交代的老路。比较简单的做法是在一个技能包内完成多步骤编排。也就是说不把周报生成定义成一个单步技能而是定义成读取项目记录、整理进展、生成周报的完整流程。SKILL.md里写清楚先做什么、再做什么、最后输出什么让Claude按流程执行。这种方法实现成本低但灵活性差一点每次都是同样的步骤没法中途插进来一个变化。5.2 给技能加输入输出契约想让技能组合更灵活一个更有价值的做法是给每个技能定义明确的输入输出契约这个技能接收什么格式的数据产出的结果是什么格式。当技能A的输出正好技能B能接收时就可以链式调用。举一个实际的例子。我有一个会议纪要整理技能输出的是Markdown格式的会议纪要另一个行动项跟踪技能接收的输入正好是会议纪要里的行动项表格。实际用的时候用户只需要说把这周的会议纪要和上周的行动项合并一下Claude先用纪要技能整理出当周行动项再调用跟踪技能把新旧行动项合并生成一张完整的行动项清单。这种方式大大提升了Claude处理复杂任务的能力。关键是每个技能的输入输出格式要稳定、要有明确约定否则技能之间没法对接。5.3 给团队沉淀技能库的运营思路Skills这套机制还有个特别实用的场景团队内部的经验沉淀。以前组里来了新人要把很多工作流程通过文档、培训讲清楚现在可以把这些流程直接做成技能包新人只需要在Claude里调用对应的技能就能按团队的标准流程干活。比如某内容团队把公众号排版规则做成一个技能包里面包含排版规范、常见样式、审核清单。新编辑用Claude写文章时只要让AI按这个技能来排版产出格式就自动符合团队要求。现场教学的成本大幅降低而且技能包可以持续迭代规范更新了直接改SKILL.md全团队立刻生效。不过有几个经验值得分享技能包命名要团队统一不然时间长了就乱每个技能包要指定一个人维护避免多人同时改造成冲突技能包在正式使用前至少要跑过一次完整测试甚至可以考虑维护一份技能包CHANGELOG记录每次修改了什么、为什么改。把这些细节管理好技能库就不再是个人效率工具而是团队级别的知识资产。我在实际使用中最大的体会是Skills能自动帮我保持稳定输出同一类事情不管什么时候交给Claude出来的结果格式和风格几乎一致。这一点价值被很多人低估了——AI本身有很强的能力但如果没有固化流程能力发挥很不稳定。技能包相当于把稳定的好保存了下来。最后再分享一个小技巧新技能上线前主动喂给它一个真实的失败案例看看它怎么处理异常情况比测试十个正常输入都管用。