创作技巧

安全 社区

技能解读

当前原文的自动摘译,尚未人工审校。

概述

创建、更新、改进和审核便携式代理技能。目标是让智能体可靠地更好地完成可重复的工作,而不需要臃肿的上下文或强制不必要的结构。

何时使用

创建新的代理技能或 SKILL.md 更新、重构或改进现有技能 设计技能的名称、描述、触发面或排除 组织捆绑技能文件,例如 references/、assets/、scripts/ 或 evals/ 审核技能的结构、发现、渐进披露、脚本、安全或评估覆盖范围

核心原则

写出完成这项工作的最简单、最小的技能。仅当结构、示例、参考、资产、脚本或评估能够提高输出质量或使技能更易于发现、遵循、验证或维护时才添加它们。

工作流程

对于重要的工作,请使用清单跟踪您的进度。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
安全
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@bastienlimbour · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第一阶段 - 分类

编辑前确定路径: 创建技能:运行完整的工作流程。更新技能:检查现有技能并仅编辑请求更改所需的部分。提高目标模糊的技能:首先进行审核,然后修复最高价值的差距。审核技能:首先报告结果,然后停止,除非用户要求编辑。

02
第 2 阶段 - 收集证据

检查现有技能文件、源材料、真实工作流程、示例、以前的失败以及可用的相邻技能。仅当缺少信息会严重改变技能时,一次提出一个有针对性的问题。对于实质性的新技能或主要重写,请总结预期的文件并要求继续,除非用户已经批准了该确切的工作。

03
第 3 阶段 - 定义边界

确定可重复的工作、用户、输入、输出、约束、非目标、成功标准以及不应触发技能的未遂任务。比起广泛的工具箱,更喜欢一项连贯的工作。如果建议的技能涵盖不相关的工作,请将其拆分或缩小第一个版本的范围。

04
第 4 阶段 - 设计发现

阅读 discovery-and-descriptions.md。选择与目录匹配的便携式小写连字符`name`。编写一个`description`,说明该技能的作用以及何时使用它。仅当可以防止可能的误报时,才加载核心触发术语并包含排除项。

05
第 5 阶段 - 塑造包装

阅读spec-and-struct.md 以获取所需的格式。仅从`SKILL.md`开始。仅当捆绑文件获得保留时才添加它们。需要 · 默认操作 每次运行的核心指令 · 保留在 `SKILL.md` 稀有、长或有条件的细节 · 移至 `references/`

06
阶段 6 - 编写正文

阅读内容模式.md。为代理编写操作说明,而不是为人类编写解释性文档。使用适合技能的可扫描结构,而不是复制固定模板。用 `Overview` 1-2 句话来说明该技能的作用及其重要性。让`When To Use`专注于激活指导。仅当阶段标题、表格、示例、危险信号、合理化或验证能够改善行为时才使用它们。

07
第 7 阶段 - 评估

阅读评估.md。每个创作或材料更新都必须包含一个轻量级评估计划或不需要评估的明确原因。添加完整的评估文件,以了解重要的技能、有风险的工作流程、脚本、复杂的激活边界或未来的重复使用。

08
第 8 阶段 - 审查

阅读audit-checklist.md。修复检查表失败的问题并重新检查,直到技能有效、重点突出且可用。如果仅进行审核,则返回按严重程度排序的结果以及具体修复。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。