SuperAPI AI 工具集

template-skill-enhanced

测试与质量

查看项目

更新于 10-16 01:37

技能介绍

用途:在生产环境中创建结构更复杂的技能,示范渐进披露(分层内容加载)、捆绑资源模式与质量验证。适合需要分级加载、参考文件组织或结构化质量评分的技能;简单单一用途技能应改用 template-skill。

工作流:一、在 frontmatter 定义元数据,name 用 kebab-case,description 加引号并含“Use when”触发条件,另含 version 与 tags。二、写核心原则(第 1 层,激活即加载),保持在约 1000 token 内。三、加实现模式(第 2 层,按需加载),约 1500 token,含问题、方案与权衡表。四、加高级用法(第 3 层,复杂场景),约 2000+ token,列出边界情况及处理策略(如空输入优雅失败、格式无效报验证错误、资源耗尽时退避重试)。五、组织捆绑资源:SKILL.md 之外设 references/(README.md、detailed-patterns.md)、examples/basic.md、validation/rubric.yaml。六、定义可衡量质量目标,如 clarity、completeness、accuracy、usefulness 的分值。七、用 cortex skills validate my-new-skill 与 cortex skills info my-new-skill --show-tokens 验证,总 token 应控制在 500–8000 之间。

最佳实践:第 1 层保持精简,细节按需加载;把长示例下沉到 references/ 或 examples/;在 validation/rubric.yaml 定义评分标准;核心 SKILL.md 不超 token 上限;用真实可运行的领域代码替换占位内容;目录与技能名用 kebab-case。

反模式:生产环境保留占位内容(如 [Pattern Name]、example_code_here());把一切塞进 SKILL.md 的巨石式技能;description 缺少“Use when”子句;忽视 token 预算,超 8000 token 会拖慢激活甚至被截断。具体适用范围与平台支持暂未提供。