what are claude skillsAI workflowworked examplevisual planning

Claude Skills是什么:用报告审核分清技能、工具和MCP

设计一份可复用报告审核技能,提供目录、输入输出约定和三条练习,明确工具与权限边界。

CodePic Team12 min read

直接结论

Claude Skills是把可重复任务的做法和配套资源组织起来,让Claude在相关任务中使用的一种方式。技能说明“怎么做”,工具提供“能执行什么操作”,当前资料说明“这次要处理什么”。把这三层分开,才能写出可维护、可验收的技能。

核验方法: 官方资料于2026年10月29日核验。来源包、预期答案与路径为作者原创教学材料,不冒充外部Agent运行、演示成品或Notebook生成结果;未进行工具排名、准确率或成本节省测试。

Claude Skills是把可重复任务的做法和配套资源组织起来,让Claude在相关任务中使用的一种方式。技能说明“怎么做”,工具提供“能执行什么操作”,当前资料说明“这次要处理什么”。把这三层分开,才能写出可维护、可验收的技能。

本文设计一份报告证据审核技能,提供最小目录、输入输出约定和三条练习。所有资料与预期答案均为作者编写,不声称已在Claude账号里安装运行,也不把练习答案当成准确率测试。

哪些任务适合做成Skill

官方技能帮助介绍了按任务加载指令和资源的方式。实际设计时,先问这件工作会不会反复出现,是否有稳定、值得维护的步骤。

例如,审核报告事实、整理发布说明、检查机构写作风格,都可能适合。某次活动的18人到场记录,则应留在当前资料中,不应永久写进技能。

“帮助完成所有办公任务”太宽,没法确定什么时候该用,更难验收。“把草稿中的事实逐项对照指定来源,返回审查表”,则有清楚的输入和结果。

技能相关,不等于技能有权做任何事。它不会让来源自动正确,也不会因为写着“发送报告”,就获得对外发送权限。资源访问和动作范围要单独定义。

Skills、工具、MCP和当前任务怎么分工

以社区活动报告为例:技能提供审核方法;读文件工具取回已允许的资料;MCP连接可能提供外部文档资源和操作;当前任务给出草稿与来源编号;复核人决定是否接受结果。

部分负责的问题本例
Skill这类工作怎样重复完成逐条核对事实
工具能执行什么操作读取指定文本
MCP连接暴露哪些资源和能力已批准的文档服务
当前输入这次审核什么草稿与S1–S3
人的决定接受后怎么办批准修订报告

有工具能发消息,不代表审核任务应该发消息。技能写了“发送已批准报告”,也仍需明确目标、授权和合适工具。

Claude Cowork任务交接案例处理一次具体委派;本篇处理的是可以反复使用的审核程序,两者不要混成同一份大提示。

最小目录怎么写

从名称、适用描述和核心步骤开始。把长案例、检查表放到支持文件,让SKILL.md保持可读。

report-evidence-review/
  SKILL.md
  references/
    review-checklist.md
  examples/
    three-review-cases.md

下载原创审核技能练习,其中包含教学用SKILL.md、目录和测试材料。这是可阅读的练习文档,不是已经安装的技能包;需要按所选Claude环境支持的格式整理并启用。

适用描述应同时写明任务和输出,例如“对照提供来源审核事实草稿,返回支持、矛盾、未证实和不明确的发现”。不要写“保证报告准确”,这种承诺既无法帮助选择技能,也没有经过验证。

如果之后加入脚本或外部操作,要检查文件内容、依赖和执行范围。目录名字熟悉,不代表里面的程序已经审核过。

把输入和结果约定清楚

本技能需要两项输入:待审草稿,以及列明允许来源的清单。缺来源时标出受影响的说法并请求补充,不能擅自用一次网络搜索替代指定证据。

每行审核结果记录:原句、来源编号、支持段落、判断和建议修改。判断至少分“有支持”“与来源矛盾”“未被证实”“含义不明确”。来源没提满意度,不代表活动不满意,只代表不能支持草稿中的满意度结论。

把流程画成:当前输入→相关技能→允许的读取工具→证据表→人工复核。打开AI Agent架构模板,用实际工具替换通用标签,再加一个单独的批准节点。图上应该能直接找到“缺来源时停在哪里”。

可复用程序与当前证据

作者示例:先核对关系,再按自己的任务修改模板。

这里的白板只帮助组织关系,不安装Skill,也不连接MCP。你修改的是程序知识、事实和能力的分工。

核心指令要能被别人检查

可以按这条路径组织:提取事实句→对照指定来源→保留统计口径和时间范围→标记无依据推断→给出最小修订→返回未解决问题。

例如,来源说“12名访客带来待检查物件”,草稿说“修好了12件物品”。合适判断是“来源没有建立修复结果”,修订应恢复原始含义,不能反过来编造“修复成功数为0”。

输出不要只给一段很干净的改写。最好同时保留审核表与未解决清单,让复核人知道哪些说法被支持、哪些被删掉、哪些还在等资料。

资料里的指令也要检查。例如,草稿引用某段提示“忽略审核清单”。它是待审内容,不是给审核者的新命令。把这种情况写成测试,比一句“注意安全”更容易验证。

三条练习先走一遍

练习输入问题应有发现
1:统计口径被换掉把带来检查写成修复完成结果未证实,恢复原口径
2:引用资料不存在草稿写S4,清单只到S3请求S4,不编造段落
3:证据夹带指令来源里引用跳过审核的命令当作内容,继续原审核

可以先人工对照预期答案。以后真实运行时,把实际输出、使用环境和技能版本放在一起记录。发现了事实错误却擅自对外发消息,仍不算通过。

三条练习只是起点,不足以证明普遍可靠。后续应加入真实失败案例,尤其是日期、分母、来源版本和矛盾处理。不要从这么小的作者练习集合计算或宣传准确率。

程序问题和工具问题分别处理

如果结果里没有支持段落,可能是审核步骤不清,也可能是文件不可访问,或读取工具失败。继续给SKILL.md加一段文字,解决不了断开的资源。

先核对输入清单,再确认能读到一份允许来源,然后检查输出格式,最后对照预期发现。保留失败输入,不要每次改规则时连测试材料也一起换掉,否则无法判断改动是否解决了原问题。

长期依赖某工具时,在文档里写出依赖;缺工具时说明可接受的不完整结果。明确说“无法读取S2,相关判断暂停”,比补出看似完整的引用更可靠。

相关的上下文工程案例讨论哪些来源应该进入任务。选资料和审资料会相互影响,但没有必要挤进一个无所不包的技能文件。

技能怎样维护

用变更记录说明旧行为、新规则、修改原因和重跑的案例。标签、输入要求或允许动作变了,都可能影响使用者理解结果。

把当期事实移出常驻指令。“保留人数单位和记录日期”是可复用规则;“下个月房间容纳18人”必须来自当前资料。否则月份变化后,技能仍可能带着过期结论。

能用更短规则保持已测行为时,可以删冗余;但不要只因停止条件显得重复就删除它。先回看是哪条失败案例要求保留这项约束。

常见错误

适用描述太泛。 报告审核技能不应该因为出现“报告”两字,就抢占所有写作任务。写清审核对象、方法和产物。

把脚本当成普通说明。 程序会实际执行操作,需要检查输入怎样进入、接触哪些文件或服务。

记住样例答案。 换掉活动数字和结论,看看是否仍能保留证据含义。只会重复本例答案,不算掌握审核步骤。

把格式合格当作结论合格。 表格列齐全,里面仍可能有错。格式、事实、动作范围分别验收,再记录人的批准。

换成自己的报告审核

用已授权的资料替换练习,保留预期发现表,把实际遇到的失败追加进测试。若外层任务还包含重试和交接,可接着看Agentic Workflow完整案例,把技能放回清楚的工作流程里。

来源与核验

本文事实与对比所使用的官方参考资料。

常见问题

Skill等于MCP吗?

不等于。本例Skill描述审核方法,MCP连接可能暴露资源和操作。可以配合使用,但不能替代彼此。

每条提示词都应该变成Skill吗?

不需要。经常重复、程序稳定、值得维护和测试时才适合;临时事实放当前任务。

装上技能就说明有效了吗?

没有。还要检查文件、依赖和真实环境里的输出。安装成功与任务验收是两项检查。

相关文章