Claude 技能创作指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8b8494a3/mj。
技能介绍
解决什么问题
构建 Claude 技能时,常见问题不是模型不会执行,而是技能结构导致上下文膨胀、触发不稳定、资源重复加载。SKILL.md 里塞满背景说明,脚本和参考文档混在一起,最终让模型每次都要读取无关内容。
技能如何工作
该技能提供一套创建与迭代技能的工程方法:先用具体用例定义能力边界,再把可复用部分拆成 scripts/、references/、assets/。SKILL.md 只保留触发条件和核心工作流,细节文档按需加载;确定性代码放进脚本,模板和图片放进资源文件。它还强调按自由度分层:简单偏好给自然语言说明,易错流程给参数化脚本,固定序列给低自由度指令。
适用边界
它适合编写 Claude 技能包、整理代理工作流和设计按需加载文档。不适合作为具体业务规则库或替代代码测试:技能内容需要真实场景验证,资源文件也不能无限堆砌,否则仍会增加维护成本。
使用场景
- 准备让 Claude 处理 PDF 旋转、格式转换等重复任务,需要把脚本封装进 `scripts/`。
- 设计一个支持多个业务线的 Agent 技能,需要把规则拆成按领域加载的 `references/`。
- 希望减少 `SKILL.md` 长度,只保留触发说明和核心流程,把长文档移出主文件。
- 要创建包含模板、示例代码或品牌素材的输出型技能,需要规划 `assets/` 目录。
适合人员
- 负责构建 Claude 插件或 Agent 技能的工程师,需要确定目录结构和加载策略。
- 要把固定业务流程封装给模型执行的自动化负责人,需要区分脚本、参考与素材。
- 需要评审 AI 技能文档是否过长的技术负责人,需要检查主文件是否只保留必要流程。
- 正在为多领域知识库设计智能体工作流的架构师,需要按领域拆分按需加载文件。