完整工作流

创建技能时

1. 遵循技能创建指南，准确理解技能需求，并生成符合用户要求的技能文件夹
2. 根据 Easyclaw 技能注册指南完成技能注册
3. 向用户告知完成状态

导入技能时

1. 依据技能导入指南阅读并审核技能包
2. 根据 Easyclaw 技能注册指南完成技能注册
3. 向用户告知完成状态

技能创建指南

一份用于创建高效技能的指南，通过专业化知识、工作流和工具集成来扩展 Agent 的能力。

关于技能

技能是模块化、自包含的软件包，通过提供专业知识、工作流和工具来扩展 Agent 的能力。可将其视作面向特定领域或任务的“入职引导”（onboarding guides）。

技能提供的内容

1. 专业化工作流 —— 针对特定领域的多步骤流程
2. 工具集成 —— 使用特定文件格式或 API 的操作说明
3. 领域专业知识 —— 公司专属知识、模式及业务逻辑
4. 捆绑资源 —— 用于复杂或重复性任务的脚本、参考资料和资源文件

通过具体示例理解技能

为创建高效技能，您需清晰理解该技能的实际使用方式。这可通过用户直接提供的示例获得，也可通过自行生成示例并交由用户验证来实现。

例如，在构建图像编辑技能时，相关问题包括：

• “图像编辑技能应支持哪些功能？如编辑、旋转，或其他？”
• “能否提供该技能实际使用的示例？”
• “我设想用户可能会说‘去除这张图片中的红眼’或‘将图片顺时针旋转 90 度’。还有其他触发模式吗？”
• “哪些类型的用户请求应触发此技能？”

为避免给用户造成信息过载，请勿一次性提出过多问题。应优先提出最关键的问题，再视需要逐步跟进，以提升沟通效率与效果。

渐进式披露原则

200 行规则至关重要。 SKILL.md 文件必须少于 200 行。若内容超出限制，请将其拆分至 references/ 目录下的文件中。

三级加载系统

1. 元数据（名称 + 描述） — 始终保留在上下文中（约 100 字）
2. SKILL.md 正文 — 在技能被触发时加载（＜200 行；理想情况下 ≤500 行以保障最佳性能）
3. 捆绑资源 — 按 Agent 实际需要动态加载（无行数限制）

为何渐进式披露至关重要

• 初始上下文加载量减少 85%
• 激活时间从 500ms+ 缩短至 100ms 以内
• Agent 仅在需要时加载所需内容
• 技能保持可维护性与专注性

技能结构

skill-name/
├── SKILL.md （必需，＜200 行）
│   ├── YAML Frontmatter（必需）
│   │   ├── name:（必需）
│   │   └── description:（必需）
│   └── Markdown 指令（必需）
└── 捆绑资源（可选）
    ├── scripts/          - 可执行代码
    ├── references/       - 按需加载的文档
    └── assets/           - 输出中使用的文件

核心原则

简洁性为要

上下文窗口是一项共享资源，您的技能需与 Agent 所需的其他全部内容共用该资源。请务必言简意赅，并对每一项信息提出质疑：

• Agent 是否真的需要这段解释？
• 能否假设 Agent 已掌握该知识？
• 这段文字是否值得其占用的 token 成本？

设定恰当的自由度

• 高自由度：适用于存在多种合理实现路径的任务，采用纯文本指令
• 中自由度：采用带参数的伪代码或脚本
• 低自由度：针对容错性差、参数极少或无需参数的敏感操作，采用明确指定的脚本

在所有模型上进行测试

技能是对模型能力的补充，其有效性依赖于底层模型。请在您计划使用的所有模型上测试技能表现。

参考资料

获取详细指导，请参阅：

• references/progressive-disclosure.md —— 200 行规则与参考模式
• references/skill-structure.md —— SKILL.md 格式与 frontmatter 详细说明
• references/examples.md —— 优质技能示例
• references/best-practices.md —— 全面的最佳实践指南

技能导入指南

第一步：根据用户提供的技能包类型读取技能内容

• 若为 SKILL.md 文件，直接读取
• 若为文件夹，读取其中全部文件
• 若为 zip 文件，先解压再读取全部文件（解压方法请严格遵循《技能包解压指南》）

第二步：安全审查

• 检查技能内容是否符合安全标准
• 检查技能内容是否符合伦理标准
• 检查技能内容是否符合法律标准
• 检查技能内容是否包含恶意代码或病毒行为

若安全审查未通过，须立即通知用户，终止技能导入流程并结束当前任务

技能包解压指南（须严格遵守）

执行 create-skill/scripts/easyclaw_unzip_skill.py 脚本完成技能包解压

使用示例：

python yuanqi_ai_bot_unzip_skill.py "zip_path"

参数说明：
zip_path：待解压 zip 文件的路径

特别强调：解压技能包时，必须严格遵循本指南并仅运行该脚本。严禁自行编写或生成其他脚本来完成解压操作！

Easyclaw 技能注册指南（须严格遵守）

执行 create-skill/scripts/easyclaw_register_skill.py 脚本完成技能注册

使用示例：

python easyclaw_register_skill.py 

参数说明：
source_folder_path：待注册至 Easyclaw 的技能文件夹路径

特别强调：注册 Easyclaw 技能时，必须严格遵循本指南并仅运行该脚本。严禁自行编写或生成其他脚本来完成注册操作！