SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-15 21:40

技能介绍

用途:本技能用于创建新技能、编辑已有技能,或在部署前验证技能是否有效。其核心是把测试驱动开发(TDD)应用于流程文档:先写测试用例(带子代理的压力场景),观察失败(基线行为),再写技能文档,观察测试通过(代理遵守),最后重构(堵住漏洞)。核心原则:如果没有先观察代理在无技能时失败,就不知道技能是否教对了东西。使用前必须先理解 ltk:test-driven-development,它定义了 RED-GREEN-REFACTOR 循环。

技能定义:技能是经过验证的技术、模式或工具的参考指南,可复用;不是讲述某次如何解决问题的叙事。类型包括技术(有步骤的具体方法)、模式(思考问题的方式)、参考(API 文档、语法指南、工具文档)。

目录结构:skills/分类/技能名/,其中 SKILL.md 必需,支持文件仅在需要时添加。重参考(100 行以上)和可复用工具应单独成文件,原则、概念和 50 行以内的代码模式保持内联。

SKILL.md 结构:YAML frontmatter 仅支持 name 和 description 两个字段,总计最多 1024 字符;name 只用字母、数字和连字符;description 用第三人称,只描述何时使用(不描述做什么),以“Use when...”开头,包含具体症状、情况和上下文,绝不总结技能流程。正文包含 Overview、When to Use、Core Pattern、Quick Reference、Implementation、Common Mistakes 等部分。

搜索优化:description 只写触发条件,不总结工作流,否则 Claude 可能只按描述执行而不读全文;使用错误信息、症状、同义词、工具名等关键词;命名用主动语态、动词开头,如 creating-skills。

铁律:没有失败的测试就不写技能,新技能和编辑都适用。RED 阶段写压力场景并在无技能时运行,逐字记录基线行为和合理化借口;GREEN 阶段写最小技能,针对具体借口,再带技能运行验证;REFACTOR 阶段针对新借口添加明确反驳,反复测试直到无懈可击。最后将技能提交到 git。

限制:资料未提供具体安装命令、收费、价格或平台信息。