SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-15 20:30

技能介绍

用途:writing-skills 用于创建新技能、编辑已有技能,以及在部署前验证技能是否真正有效。其核心主张是:技能编写就是应用到流程文档上的测试驱动开发(TDD)。

主要能力:提供技能的定义与类型划分(技术、模式、参考)、目录结构(skills/skill-name/SKILL.md 及按需的支持文件)、SKILL.md 的结构模板(frontmatter 仅支持 name 与 description,总长不超过 1024 字符)、面向智能体搜索优化(ASO)的写法、流程图使用规则、代码示例选择原则、文件组织方式,以及针对不同类型技能(纪律约束型、技术型、模式型、参考型)的测试方法。

使用方式:遵循 RED-GREEN-REFACTOR——先运行基线场景观察智能体在无技能时如何违规,记录其具体借口;再编写针对这些违规的最小技能;然后验证智能体是否遵守;最后通过发现新的借口并封堵漏洞来重构。个人技能存放于智能体专属目录(如 Claude Code 的 ~/.claude/skills、Codex 的 ~/.codex/skills)。可用 wc -w skills/path/SKILL.md 检查篇幅,用 ./render-graphs.js ../some-skill 渲染流程图。

适用场景:当某项技术并非显而易见、会跨项目反复引用、模式适用范围广或对他人有价值时创建技能;不适用于一次性方案、已有充分文档的标准实践或项目专属约定(后者应放入 AGENTS.md)。

限制:使用前必须理解 superpowers:test-driven-development;铁律是“没有失败的测试就不写技能”,对新增和编辑同样适用,无例外。资料未提供具体收费、价格或平台支持信息。