SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-15 23:42

技能介绍

用途:把技能文档的编写当作测试驱动开发(TDD)来做,适用于创建新技能、编辑已有技能,或在部署前验证技能是否真正生效。核心原则是:如果没有先观察智能体在没有该技能时的失败,就不知道技能是否教对了东西。使用前必须先理解 superpowers:test-driven-development(RED-GREEN-REFACTOR 循环)。

主要能力:把测试用例对应为带子智能体的压力场景,把生产代码对应为 SKILL.md 文档;先跑基线场景记录智能体的具体借口,再写技能针对这些违规点,然后验证合规,最后重构修补漏洞。提供技能类型划分(技术、模式、参考)、目录结构(如 skills/skill-name/SKILL.md 与附加文件)、命名建议、自由度设置、渐进式披露(元数据、SKILL.md 主体控制在 500 行内、scripts/references/assets 资源分离)、SKILL.md 结构模板、常见错误、不同技能类型的测试方法与常见“跳过测试”借口及反驳。

使用方式:个人技能放在智能体专属目录(如 Claude Code 是 ~/.claude/skills,Codex 是 ~/.codex/skills);SKILL.md 的 frontmatter 仅支持 name 和 description 两个字段,总计不超过 1024 字符,name 只用字母、数字和连字符,description 用第三人称并以“Use when...”开头、只描述触发条件而不总结工作流;跨技能引用用技能名加显式要求标记,不使用 @ 强制加载。可用 wc -w skills/path/SKILL.md 检查词数,用 ./render-graphs.js ../some-skill 或加 --combine 渲染流程图。铁律:没有先失败测试,不得创建或修改技能,否则删除重来。

适用场景与限制:适合需要跨项目复用、模式适用面广、其他人会受用的技术、模式或参考类技能;不适合一次性方案、已有充分文档的标准做法、项目专属约定(应放 CLAUDE.md)以及可用正则或校验自动化的机械约束。官方最佳实践另见 anthropic-best-practices.md。具体收费、价格与平台支持信息暂未提供。