本技能是一份依据 Anthropic 官方最佳实践整理的技能(Skill)编写指南,适用于结构复杂、需要细致组织的 Skill 开发。用途是指导作者做出实用的编写决策,使 Skill 易于被 Claude 发现并有效使用。
主要能力与要点:
一、元数据与成本。启动时仅预加载所有 Skill 的名称与描述等元数据,SKILL.md 仅在相关时读取,其他文件按需加载;但 SKILL.md 一旦载入,每个 token 都会与对话历史竞争,因此仍须简洁。
二、按模型测试。Skill 是对模型的补充,效果取决于底层模型,应在计划使用的所有模型上测试:Claude Haiku 需检查指导是否充分,Sonnet 检查是否清晰高效,Opus 检查是否避免过度解释。
三、结构。name 为人类可读名称,最大 64 字符;description 为一句话说明做什么、何时使用,最大 1024 字符。命名建议用动名词形式,如 Processing PDFs、Testing code,也可用名词短语或动作式命名;避免 Helper、Utils、Tools 等含糊名称与集合内不一致的命名。描述需具体并含关键触发词,避免“I can help you…”或“Helps with documents”这类空泛写法。
四、渐进式披露。SKILL.md 作为总览,正文建议控制在 500 行以内,接近上限时拆分文件;引用应保持离 SKILL.md 一层,避免深层嵌套导致 Claude 只做部分预览;超过 100 行的参考文件应在顶部加目录。可用按领域组织(如 finance.md、sales.md)或条件性细节(如 REDLINING.md、OOXML.md)等模式。
五、工作流与反馈循环。复杂任务拆为顺序步骤,并可给出可复制的清单;常见模式为“运行校验器→修复错误→重复”,示例包括运行 python scripts/analyze_form.py input.pdf、python scripts/validate_fields.py fields.json、python scripts/fill_form.py input.pdf fields.json output.pdf、python scripts/verify_output.py output.pdf,以及文档编辑中的 python ooxml/scripts/validate.py unpacked_dir/ 与 python ooxml/scripts/pack.py unpacked_dir/ output.docx。
六、内容规范。避免易过时信息,可将旧内容放入“old patterns”折叠区;术语保持统一,不要混用 endpoint、URL、path 等说法。此外提供模板模式与示例模式,严格需求用固定模板,柔性需求可给默认格式并允许调整,输出质量依赖示例时可提供输入输出对。
限制:本资料未提供该技能的安装命令、收费方式、平台支持范围与实际效果数据,这些信息暂未提供。