SuperAPI AI 工具集

writing-skills

智能体与模型

查看项目

更新于 10-29 21:54

技能介绍

写作技能(writing-skills)是一个面向 AI 技能作者的元技能,用于规定如何创建、编辑、重命名和审查技能,以及当技能未按预期触发或触发后执行了错误行为时如何排查。资料强调,技能被视为运行在模型上的代码:先观察智能体在没有技能时如何做错任务,再写能修复该失败的最小技能,然后持续加固,直到智能体无法绕过。

核心原则(Prime Directive):没有基线失败与已验证通过,不发布任何技能;编辑同样适用,对纪律类技能做小幅措辞修改也可能打开漏洞,需要重跑场景。

适用与跳过:适用于为 GodMode 或项目编写新技能、修改技能的 description、Prime Directive、协议步骤或护栏、排查本应触发却未触发或加载后行为不符的技能、审查技能贡献。一次性项目指令应写进项目的智能体说明文件;机器可强制执行的规则应用 lint、校验器或 hook 自动化;仅修正不改变指令的错别字或死链则运行校验器即可。

流程:RED 阶段为期望行为写三个以上真实场景,用无技能的全新子智能体或 eval 工具记录基线失败与逐字理由;若智能体本就正确,则技能不需要。description 依据观察到的触发情形撰写。GREEN 阶段用 GodMode 模板写最小技能,逐条回应记录的合理化理由,不增加未观察到的失败规则,并在仓库根目录运行 node scripts/validate.js 修复所有错误。随后在技能可用时重跑同一场景,智能体须选对动作并引用技能章节,保存记录。REFACTOR 阶段用更强压力场景堵漏洞,为每个新理由增加协议句、认知陷阱行、护栏项或 description 触发词,并单独检查触发:应触发任务要加载,不应触发的任务不得加载。证据写入 PR。

模板与形式规则:SKILL.md 含 name(与目录名一致)、双引号包裹的 description,以及 Prime Directive、When to Use、The Protocol、Cognitive Traps、Guardrails 等章节并按序出现;正文 120 至 350 行、小于 20,000 字节,长表格与示例放 references/*.md,链接文件必须存在。description 以“Use when”开头,只列触发情形,不写工作流,使用第三人称,400 字符以内。技能正文只写动作而非具体 harness 工具名,工具映射放在 using-godmode 的参考文件中;可变事实需注明来源与日期。

评估:可手工运行场景,也可用 Claude Code 的 claude plugin eval 运行器,包含无插件基线、多次运行、HTML 报告与非零阈值退出;每次运行为真实会话并消耗用量。建议跨多个模型规模测试。

限制:不同 harness 的工具名不同,技能主体不得写具体工具;其他 harness 尚无已验证的等效评估运行器;校验器错误会阻止通过,警告通常指向真实触发或语气问题。