SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-16 03:06

技能介绍

用途:writing-skills 面向技能(skill)的编写与维护,适用于创建新技能、编辑已有技能,以及在部署前验证技能是否真正生效。其核心思路是把测试驱动开发(TDD)应用到流程文档:先写测试用例(用子智能体构造压力场景),观察失败(基线行为),再编写技能文档,观察测试通过(智能体遵守),最后重构以堵住漏洞。核心原则是:如果没有先观察智能体在没有该技能时失败,就无法确定技能教的是对的东西。

主要能力:区分技能类型(技术、模式、参考),给出目录结构与 SKILL.md 结构建议;强调 frontmatter 中 name 与 description 两个必填字段,description 只描述“何时使用”而不总结工作流,并以“Use when...”开头;提供技能发现优化(SDO)建议,包括关键词覆盖、动词优先命名、token 效率与交叉引用;说明流程图仅用于非显而易见的决策点,并给出 render-graphs.js 渲染命令;还给出针对不同类型技能的测试方法与常见跳过测试的借口对照。

使用方式:技能通常放在运行时的技能目录中,例如 Claude Code 的 ~/.claude/skills/;Codex、Copilot CLI 和 Gemini CLI 也识别 ~/.agents/skills/ 作为跨运行时别名。使用前要求先理解 superpowers:test-driven-development。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分路径与命令需按实际运行时确认。