在构建Claude Code技能的过程中,开发者常常面临一个困扰:所有技能默认运行在最快、最昂贵的模型上,即使是“打开仪表盘”或“运行git status”这类简单任务也不例外。然而,Claude Code技能的底层设计中,其实隐藏着15个可配置的前置元数据(frontmatter)字段,其中有几个关键字段能够显著优化运行时行为、提升效率并节约成本。
这些关键字段不仅仅是元数据,它们直接影响技能的执行方式:
模型选择(model):为技能选择合适的“大脑”
这是最重要的字段之一。通过设置model: haiku,开发者可以明确指定该技能由Claude Code的Haiku模型执行。这意味着Claude会为该技能调用一个完全不同的模型,而不是简单地切换到“廉价模式”。对于执行仪表盘操作、提交代码或填写表单等机械性任务,Haiku模型是理想选择。而对于撰写开发文章、代码审查或综合研究等需要更强推理能力的任务,则应选用Sonnet模型。至于那些需要最大化推理能力来生成子智能体(subagents)或进行复杂编排的协调器(orchestrators),则应保留默认模型。
一项对42个技能的审计显示,将其中17个设置为Haiku(机械任务),15个设置为Sonnet(写作/推理),10个保留默认(复杂编排)后,每个会话都能根据任务需求运行正确的工具,极大提升了资源利用效率。
调用条件(when_to_use):精确控制技能的自动调用时机
该字段的内容会直接附加到技能描述的系统提示中。它是Claude决定是否自动调用某个技能的关键依据。如果跳过此字段,Claude将仅凭技能描述进行猜测,可能导致“部署”技能在用户提及“保存到笔记”时被错误触发。此字段限制在250个字符内,因此需要精确而非全面地描述调用条件。
路径加载(paths):通过条件加载保护上下文窗口
带有paths:字段的技能在会话启动时并不会立即加载。它们会存储在一个条件技能映射中,只有当Claude接触到与指定模式匹配的文件时才会激活。例如,一个包含2000个Token提示的Solidity审计技能,在开发者处理React应用时,不应无故占用上下文窗口。未设置此字段的技能会在每次会话中消耗上下文资源,无论是否需要。
思考深度(effort):控制技能的思考程度
此字段用于控制Claude在响应前进行思考的深度。可以设置为low、medium、high或一个整数。这使得开发者可以根据技能的复杂性调整其“思考”的资源消耗。
通过合理利用这些前置元数据字段,开发者可以为Claude Code技能打造更精细、更高效、更具成本效益的AI智能体工作流。