SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-16 01:37

技能介绍

用途:创建新技能、编辑现有技能,或在部署前验证技能是否有效。它把测试驱动开发(TDD)应用于流程文档:编写压力场景测试、观察失败(基线行为)、编写技能文档、观察测试通过、再重构封堵漏洞。核心原则:若未亲眼看到智能体在没有该技能时失败,就无法确定技能教的是对的东西。个人技能存放在智能体专属目录,如 Claude Code 的 ~/.claude/skills、Codex 的 ~/.codex/skills。

适用时机:技巧不直观、会跨项目复用、模式适用范围广、对他人有益时创建;一次性方案、已有充分文档的标准做法、项目专属约定(宜放入 CLAUDE.md)不必创建。技能类型分技术(含步骤的具体方法)、模式(思考方式)、参考(API 与工具文档)。

工作流为 RED-GREEN-REFACTOR:RED 阶段创建压力场景(纪律类技能需 3 个以上叠加压力),在没有技能的情况下运行并逐字记录基线行为,找出合理化说辞与失败模式;GREEN 阶段针对具体失败编写最小技能,遵循结构指南并优化可搜索性,再用相同场景验证智能体是否遵守;REFACTOR 阶段找出新的合理化说辞,为纪律类技能添加明确反制,建立说辞表并反复测试直到无懈可击。铁律:没有先失败的测试就不写技能,新建与编辑同样适用,违反则删除重来。

限制与注意:测试方法需配合 testing-skills-with-subagents 子技能;不要批量创建多个技能而不逐个测试;描述以 Use when 开头并包含具体触发条件;用技能名而非 @ 链接引用;避免多个平庸代码示例与叙事化写作。完整清单见 references/checklist.md,官方最佳实践见 anthropic-best-practices.md。