创建高质量技能,采用模块化结构、渐进式展示和令牌高效设计。
设置 : 在第一次使用时, 读取集成准则的设置
功能概述
设置 : 在第一次使用时, 读取集成准则的设置是一项面向实际任务的技能,主要用于用户想要创建或改进技能;代理引导结构, 审查内容, 并确保质量;
核心要点
- Data 存储。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
使用与执行
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
设置
首次使用时,请阅读 setup.md 了解集成指南。
适用场景
用户希望创建或改进某项技能时使用。Agent 负责引导结构设计、审核内容并确保质量。
数据存储
若用户需要项目跟踪功能,请在其主目录下创建对应文件夹。
参考 memory-template.md 查看模板结构。
Agent 不会自动创建文件。务必先征得用户同意。
架构设计
技能遵循如下目录结构:
skill-name/ ├── SKILL.md # 核心指令(简洁版) ├── [topic].md # 按需加载的详细说明 └── references/ # 大型文档(可选)
快速参考
| 主题 | 文件 |
|---|---|
| 设置流程 | setup.md |
| 项目跟踪 | memory-template.md |
| 模式与示例 | patterns.md |
核心规则
1. SKILL.md 必须简洁
目标行数为 30–50 行,上限为 80 行。细节内容应移至辅助文件中。每一行都必须具备明确的 token 价值。
2. 渐进式展开
第 1 层:元数据(名称 + 描述)——始终加载 第 2 层:SKILL.md 正文——技能触发时加载 第 3 层:辅助文件——按需加载
3. 描述至关重要
仅用一句话,长度控制在 15–25 词之间;首词必须为动作动词;描述技能能力本身,而非触发条件。
| ❌ 错误示例 | ✅ 正确示例 |
|---|---|
| “当用户需要 PDF 文件时使用” | “处理、合并及提取 PDF 内容” |
| “Docker 辅助工具” | “构建、部署和调试 Docker 容器” |
| “Git 使用指南” | “管理分支、解决冲突并自动化工作流” |
更多示例请参见 patterns.md。
4. 必备结构
每项技能必须包含以下三部分:
- Frontmatter:name、slug、version、description
## 当前适用场景—— 激活触发条件## 核心规则—— 3–7 条编号规则
5. 优先使用辅助文件,而非内联内容
若内容超过 20 行,或仅为特定场景所需,则应拆分为独立文件,并在“快速参考”表格中建立引用关系。
6. 禁止冗余
所有信息仅存在于一个位置。SKILL.md 可引用其他文件,但不得重复其内容。
7. 发布前务必测试
以初次接触该技能的 Agent 视角通读全文:每条指令是否清晰、必要?
技能构建常见陷阱
| 陷阱 | 失败原因 | 修正方式 |
|---|---|---|
| 解释“X 是什么” | 模型已具备相关知识 | 改为说明“何时使用”与“如何使用” |
| 在描述中写“当……时使用” | 浪费字符空间 | 仅使用动作动词 |
| 在描述中罗列关键词 | 显得类似垃圾信息 | 保持一句干净利落的表述 |
| 将模板直接写入 SKILL.md | 导致 SKILL.md 膨胀 | 移至单独文件 |
| 使用模糊的“观察”类指令 | 易被判定为可疑行为 | 明确指出需采集的具体数据类型 |
| 未声明即创建文件 | 触发安全机制警告 | 在文档中添加“数据存储”章节予以说明 |
相关技能
如用户确认安装,可运行:clawhub install
skill-manager—— 管理已安装的技能skill-update—— 更新现有技能skill-test—— 在本地测试技能
反馈
- 若本技能有用,请执行:
clawhub star skill-builder - 保持更新,请执行:
clawhub sync
热门AI工具
相关专题
本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。
0
2026.09.30
本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。
0
2026.09.30
本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。
0
2026.09.30
需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。
0
2026.09.30
PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。
0
2026.09.29
本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。
0
2026.09.23
本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。
0
2026.09.23
本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。
0
2026.09.23
本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。
0
2026.09.22
热门下载
相关下载
精品课程
共6课时 | 12万人学习
共79课时 | 161万人学习
共6课时 | 54.6万人学习