skill-template

skill-template 作为开发者与 AI 代理设计、记录与部署上下文工程框架内新功能的基础架构。它强制执行一种模块化结构，旨在通过渐进式揭露（progressive disclosure）最小化 token 开销并最大化代理的理解力。通过使用此模板，开发者能确保其自定义的代理技能在 Claude Code 与其他整合开发环境中均具有可发现性、可解释性与可维护性。它促进了从随意提示（ad-hoc prompting）转向稳健、可重用技能库的过程。

• 标准化技能文档结构，包含触发条件、核心概念与实施指南。

• 强制执行严格的 token 高效格式，优化上下文窗口使用并防止效能下降。

• 整合相关技能的相依性文档，以维护连贯的代理生态系统。

• 提供将详细参考资料置于外部文件的机制，确保主 SKILL.md 文件保持在 500 行以内。

• 鼓励使用第三人称、无歧义的语言，以优化代理系统提示词的注入效果。

• 当扩展上下文工程技能集合并新增工具或专业推理功能时，请使用此模板。

• 确保填写作者、版本与建立日期等所有元数据字段，以支持版本控制与可审计性。

• 优先填写 'Gotchas' 部分以记录经验所得的失败模式，这能为其他代理提供最高信号的上下文。

• 务必验证技能描述是否简洁，以便于代理发现服务，同时不牺牲必要的运作指令。

• 将详细的技术参考资料保持在 references/ 目录中，避免在技能初步发现阶段淹没代理的注意力。

• 跨不同的代理执行时环境测试技能，以确保严格遵守平台无关的设计原则。