Community写作与编辑github.com

AradhanaID/agent-skills

使用四步检查法(触发、结构、导向、精简)编写或重写一个技能。

agent-skills 是什么?

该技能为AI智能体(如Claude Code、Cursor、Codex)提供了一个严谨的四步检查法框架,用于编写或重构技能定义,确保技能在实际运行中行为正确,而不仅仅是文档读起来通顺。它强调技能必须围绕真实运行中的失败案例进行迭代,而非一次性完成。技能支持用户调用(显式触发)和模型调用(自动触发)两种方式,并通过设置明确的完成条件(done-condition)使每个步骤可验证。核心步骤包括:修复触发条件、盘点实际运行中的纠正项、编写带有完成条件的步骤和指针、选择精炼的关键词,以及通过“无操作测试”精简内容。参考文档包含了每个调用类型的前置机制、指针编写规则和审查清单,用于在技能运行异常时指导改进。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AradhanaID/agent-skills/tree/HEAD/skills/write-a-skill

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

编写一个技能

一次运行编写或重写一个技能。输出的评判标准是技能运行时的行为表现,而非文档的可读性:本次运行安装的是用户的流程,而非通用的技能模板。

编写之前,请遵循 reference.md 中的上下文指针 — 前置机制细节位于其中。

步骤

  1. 修复触发条件。 询问谁必须调用该技能以及何时调用。一个永远只在有意运行时才被调用的技能是 用户调用(disable-model-invocation: true,描述变为一行人类可读摘要,<100 字符)。一个必须被智能体主动调用的技能是 模型调用:其描述始终加载的指针,而其措辞决定触发是否发生。 完成条件:调用选择指明了其付出的代价——上下文,或你的记忆。
  2. 盘点实际工作流程。 回忆最近一次该技能的实际运行:哪些内容被退回、修正或重复。这些修正项就是技能的内容;而智能体独立完成的内容则不是。 完成条件:草稿中至少引用了一个它能够防止的实际失败案例。
  3. 编写步骤,然后编写指针。 每个步骤都是一个包含明确完成条件的流程,顺序安排使得运行首先交付可检查的内容。仅部分流程需要的支撑材料放在 reference.md 中,通过一个指明 何时 阅读的指针链接。 完成条件:每个步骤都可验证,无需询问智能体是否成功。
  4. 选择引导词。 对于每个反复出现的概念,选取已存在于模型预训练中的简洁词语,让其承载含义:指针、步骤和完成条件重用这些词语。将术语重命名为此类词语,而不是绕圈子解释。 完成条件:每个引导词至少出现在两处,并在每处起到引导作用。
  5. 通过无操作测试进行精简。 逐句进行:删除该句,询问什么被破坏了。如果没有破坏,则删掉该句。删除整个句子,而非修剪词语;重复内容合并为单一事实来源,而非两处淡化。 完成条件:不再能连续通过无操作测试而不出现失败;文件比上一版本更短。

参考

  • reference.md — 每种调用类型的前置机制、指针编写规则,以及用于审查现有技能的清单集。
  • 本运行产生的技能是针对实际运行进行迭代的,而非一次性编写完成:当运行出现异常时,阅读参考 会在重写之前对失败进行定性。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能