SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-16 07:15

技能介绍

用途:这是一套把测试驱动开发(TDD)应用到流程文档的技能写作指南,用于创建新技能、编辑已有技能,以及在上线前验证技能是否有效。核心原则是:如果没有先观察智能体在缺少该技能时的失败表现,就无法确认技能是否教会了正确内容。

主要能力:给出技能的定义与边界——技能是可复用的技术、模式、工具与参考指南,而不是一次性的问题解决叙事。提供 TDD 到技能创作的映射:测试用例对应带子智能体的压力场景,生产代码对应 SKILL.md,RED 对应智能体无技能时违规的基线行为,GREEN 对应技能存在时智能体遵守,重构对应在保持合规的同时封堵漏洞。涵盖何时该创建技能(技术不直观、跨项目复用、模式通用、对他人有价值)与何时不该创建(一次性方案、已有良好文档的通用做法、项目专属约定宜写入 CLAUDE.md、可用正则或校验强制执行的机械约束宜自动化)。区分技能类型:技术、模式、参考。规定目录结构(skill-name/SKILL.md 加按需的支撑文件)、SKILL.md 结构(YAML frontmatter 含 name 与 description,总计不超过 1024 字符;description 不超过约 500 字符)以及 CSO(Claude 搜索优化),强调 description 只写触发条件、绝不概括工作流,否则智能体可能只按描述行事而不读正文。还给出命名、分词效率、交叉引用、流程图使用、代码示例与文件组织规范,并列出“铁律”:没有先失败的测试,不得创建或编辑技能。

使用方式:个人技能放在智能体专属目录(Claude Code 为 ~/.claude/skills,Codex 为 ~/.agents/skills/)。按 RED-GREEN-REFACTOR 循环:先跑基线压力场景并记录失败理由,再针对具体违规写最小技能文档,验证合规,然后持续“发现新理由→封堵→复验”。可用 wc -w 检查字数,用目录中的 ./render-graphs.js 渲染流程图。使用前必须先理解 superpowers:test-driven-development;官方最佳实践见 anthropic-best-practices.md,说服原理见 persuasion-principles.md。

适用场景:编写或修改技能文档、对强制纪律型技能做压力测试、对技术/模式/参考型技能分别设计验证场景。

限制:资料未给出收费、价格、平台支持范围等信息;测试环节与前置技能为必需项,不应跳过。