skill-writing
Skill Writing 是一套用于设计和编写高质量 Agent Skills(智能体技能)的方法与规范。它产出一个可直接使用的技能包:必需文件 SKILL.md(带合法的 YAML frontmatter),以及在有助于任务时提供的可选参考文件与脚本。其设计目标围绕可发现性、正确性、简洁性和可测试性。该技能在需要新建技能、重写已有技能,或需要为 Agent 生成带触发条件与约束的技能定义时使用。它规定了明确的输出契约:SKILL.md、必要的文件夹结构与文件内容建议,以及至少 3 条用于测试激活与行为的评估提示。工作流程依次为:提取需求(主要任务、触发短语、输入类型、约束、需防范的失败模式)、设计信息架构(采用渐进式披露,SKILL.md 尽量短,长内容下沉到 REFERENCE.md、WORKFLOWS.md、EXAMPLES.md、CHECKLISTS.md 等一层深的文件,确定性转换与校验优先用脚本并说明运行方式)、严格编写 frontmatter、编写最小必要的 SKILL.md 正文、添加评估用例。它给出 frontmatter 与 SKILL.md 骨架模板、“高层+引用”模式,以及硬性写作规则(单一主路径、避免时间敏感分支、术语一致、使用正斜杠路径、脚本需给出确切命令与预期输出、脆弱任务必须含校验步骤),并列举常见反模式与完成标准。
智能体与模型20 次安装