在配置 Claude Code 技能时，主要最佳实践是通过使用精确的 YAML frontmatter 和"延迟加载"来优化可发现性和上下文效率。您的技能 description 应作为清晰的语义触发器，使用特定关键词帮助 Claude 精确确定何时激活专家指令，而不会使每次对话的上下文窗口膨胀。将 SKILL.md 结构设计为窄而模块化的焦点，而不是创建"瑞士军刀"式的技能；如果工作流有不可协商的副作用，请使用 disable-model-invocation: true 确保它仅在通过斜杠命令手动触发时运行。此外，利用参数占位符（如 $ARGUMENTS）使您的技能可在不同文件间重用，并将它们存储在项目的 .claude/skills/ 目录中，以便进行版本控制并与团队共享。最后，通过提供逐步的工具序列来保持技能指令的确定性，这确保 Claude 在部署或安全审计等复杂任务中遵循您项目的"黄金路径"。