技能创建者 (Skill Creator - Chinese Version)

此技能为创建高效技能提供指导.

关于技能 (About Skills)

技能是模块化、自包含的包,通过提供专业知识、工作流和工具来扩展代理的能力.可以将其视为针对特定领域或任务的 "入职指南" ——它们将通用代理转变为具备流程性知识的专业代理.

技能提供的功能

1. 专业工作流 - 针对特定领域的多个步骤流程.
2. 工具集成 - 指导如何使用特定文件格式或 API.
3. 领域专业知识 - 公司特定的知识、模式、业务逻辑.
4. 捆绑资源 - 用于复杂和重复任务的脚本、参考资料和资源.

核心原则 (Core Principles)

简洁是关键 (Concise is Key)

上下文窗口 (Context Window) 是公共资源.技能需要与系统提示词、对话历史、其他技能元数据以及实际用户请求共享上下文.

默认假设:代理已经非常聪明. 只添加代理尚未掌握的上下文.挑战每条信息: "代理真的需要这个解释吗?" 以及 "这段文字对得起它的 Token 成本吗?"

优先使用简洁的示例,而不是冗长的解释.

设置适当的自由度 (Set Appropriate Degrees of Freedom)

根据任务的脆弱性和变异性匹配特异性级别:

高自由度 (文本指令): 当多个方法都有效、决策依赖于上下文或启发式方法指导过程时使用.

中等自由度 (伪代码或带参数的脚本): 当存在首选模式、允许某种程度的变化或配置会影响行为时使用.

低自由度 (特定脚本,极少参数): 当操作脆弱且易出错、一致性至关重要或必须遵循特定顺序时使用.

技能的结构 (Anatomy of a Skill)

每个技能都包含一个必需的 SKILL.md 文件和可选的捆绑资源:

skill-name/
├── SKILL.md (必填)
│   ├── YAML 元数据 (必填)
│   │   ├── name: (必填)
│   │   ├── description: (必填)
│   │   └── compatibility: (可选)
│   └── Markdown 指令 (必填)
└── 捆绑资源 (可选)
    ├── scripts/          - 可执行代码 (Python/Bash 等)
    ├── references/       - 旨在根据需要加载到上下文中的文档
    └── assets/           - 输出中使用的文件 (模板、图标、字体等)

渐进式披露设计原则 (Progressive Disclosure)

技能使用三层加载系统来高效管理上下文:

1. 元数据 (名称 + 描述) - 始终在上下文中 (~100 词).
2. SKILL.md 正文 - 技能触发时加载 (<5k 词).
3. 捆绑资源 - 根据需要加载 (脚本无需读入上下文窗口即可执行,因此几乎无限制).

关键原则: 当技能支持多种变体、框架或选项时,仅在 SKILL.md 中保留核心工作流和选择指南.将变体特定的细节(模式、示例、配置)移动到单独的参考文件中.

技能创建流程 (Skill Creation Process)

1. 了解技能背景: 通过具体示例了解技能用途.
2. 规划资源: 规划脚本、参考资料和资产.
3. 初始化技能: 运行 scripts/init_skill.py <skill-name>.
4. 编辑技能: 编写 SKILL.md 并实现资源.
5. 打包技能: 运行 scripts/package_skill.py <path/to/skill-folder>.
6. 迭代优化: 根据实际使用情况进行改进.

步骤 4: 编辑技能 (Edit the Skill)

编写 SKILL.md 时,请记住这是为另一个代理实例使用的.包含有益且非显而易见的信息.

编写指南

• 使用祈使句/不定式形式.
• YAML Frontmatter: description 是主要触发机制,应涵盖技能的作用及触发上下文.
• 正文: 编写关于如何使用该技能及其捆绑资源的指令.

步骤 5: 打包技能 (Packaging a Skill)

开发完成后,必须将其打包为可分发的 .skill 文件.打包过程会自动验证技能是否符合要求:

python3 scripts/package_skill.py <path/to/skill-folder>

验证内容包括:

• YAML 格式及必填字段.
• 命名规范与目录结构.
• 描述的完整性与质量.
• 资源引用的正确性.

注: 此技能本身即为使用提示词工程和结构化文档的最佳实践示例.