SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-15 23:47

技能介绍

用途:该技能用于创建新技能、编辑已有技能,或在部署前验证技能是否有效,把测试驱动开发(TDD)方法应用到流程文档编写上。核心原则是:如果没有先观察智能体在没有技能时的失败,就无法判断技能是否教对了内容。使用前必须理解 petropowers:test-driven-development,该技能定义 RED-GREEN-REFACTOR 循环。

主要能力:技能被定义为可复用的技术、模式、工具或参考指南,而非一次性解决问题的叙述。技能创建遵循测试先行:先用子智能体跑压力场景得到基线失败行为,再编写技能文档,验证智能体合规,最后重构堵住漏洞。文档结构为 skills/skill-name/SKILL.md,采用扁平命名空间;重型参考(100 行以上)、可复用工具单独成文件,原则、概念与 50 行以内代码模式内联。SKILL.md 的 frontmatter 含 name 和 description 两个必填字段,总计不超过 1024 字符;name 仅用字母、数字和连字符;description 用第三人称、以“Use when...”开头,只描述触发条件,绝不总结技能的工作流程。此外还介绍 Claude Search Optimization(关键词覆盖、动词优先命名、令牌效率)、跨技能引用、流程图使用、代码示例与文件组织,并区分纪律型、技术型、模式型、参考型四类技能的不同测试方式。

使用方式:编写技能时先运行基线场景,记录智能体的具体合理化借口,再针对违规写最小技能内容,验证合规,然后循环重构。可用 wc -w skills/path/SKILL.md 检查字数。可用 ./render-graphs.js ../some-skill 或加 --combine 将流程图渲染为 SVG。官方最佳实践另见 anthropic-best-practices.md。

适用场景:创建或编辑智能体技能、验证技能部署前有效性。限制:铁律要求没有失败测试就不写技能,同样适用于新技能和对已有技能的编辑;资料未提供具体收费、价格或平台信息。