SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-15 17:26

技能介绍

用途:该技能用于创建新技能、编辑已有技能,或在部署前验证技能是否有效。其核心主张是「编写技能就是把测试驱动开发(TDD)应用到流程文档上」。

主要能力:把 TDD 的 RED-GREEN-REFACTOR 循环映射到技能编写——用压力场景(子智能体)作为测试用例,先观察无技能时的失败(基线行为),再编写技能文档,再验证智能体遵从,最后重构以封堵漏洞。核心原则是:如果没有亲眼看到智能体在没有该技能时失败,就无法确定技能教的是不是对的东西。技能类型分为技术(Technique)、模式(Pattern)、参考(Reference)三类。

使用方式:个人技能存放在智能体专属目录(Claude Code 为 ~/.claude/skills,Codex 为 ~/.agents/skills/)。技能目录结构为 skills/skill-name/SKILL.md(必需)加上按需的支持文件。SKILL.md 采用 YAML frontmatter,必填 name 与 description,总长不超过 1024 字符;name 只能用字母、数字和连字符;description 用第三人称,只描述「何时使用」而非「做什么」,以「Use when...」开头,尽量不超过 500 字符,且绝不能概括技能的工作流,否则智能体会照 description 走捷径而不读正文。文档正文可按 Overview、When to Use、Core Pattern、Quick Reference、Implementation、Common Mistakes 等分段。引用其他技能时只写技能名并加明确标记(如 REQUIRED SUB-SKILL),不要用 @ 链接以免强制加载消耗上下文。可用 render-graphs.js 将技能流程图渲染为 SVG。

适用场景:技术不易直觉掌握、会跨项目反复引用、模式适用范围广、他人也会受益时创建技能。不适用于一次性方案、已有充分文档的标准实践、项目专属约定(应放入 CLAUDE.md)以及可用正则或校验自动化的机械约束。

限制与前提:使用前必须理解 react-native-hifi:test-driven-development。铁律是「没有先失败的测试就不写技能」,对新建和编辑技能同样适用。不同技能类型需要不同测试方式(纪律约束型测压力遵从句、技术型测应用场景、模式型测识别与反例、参考型测检索与应用)。官方最佳实践见 anthropic-best-practices.md,说服原理研究见 persuasion-principles.md。确切字词、流程图规则等以原文为准。