Agent Skills
返回列表
Skill 设计指南

Skill 设计指南

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_49da3381/skill-design-guide-0。

技能介绍

问题：Skill 常被写成长 Prompt

创建 AI Agent Skill 时，常见问题是把触发条件、流程、模板、示例和规则都堆在 SKILL.md 中。结果文件越来越长，模型难以识别边界，稳定动作也容易被自然语言描述带偏。这份指南解决的是如何把一个 Skill 从长 Prompt 拆成可复用工作目录。

工作方式：按结构拆解

本技能在用户要求创建、修改或审查 Skill 时触发，核心不是自动总结对话，而是按固定流程拆解：

  • 确认触发场景：明确 description 应具体描述何时使用，避免空泛宣传。
  • 拆出固定流程：只保留模型需要知道的顺序动作，把可脚本化细节移出正文。
  • 材料移入 references/：模板、示例、字段说明、分类标准等放入参考文件。
  • 稳定动作脚本化：有明确规则、结果稳定、模型容易出错的步骤放入 scripts/。
  • 保留 AI 判断：价值判断、归类、总结、改写等模糊任务交给模型。

适用边界

任务简单时可以只维护一份 SKILL.md；当出现大量模板、配置或示例时，必须拆分。执行时会要求对照 references/checklist.md、references/faq.md、references/workflow-guide.md 和 references/responsibility-matrix.md，因此这些文件需要随 Skill 一起提供。

使用场景

  • 准备为新文档助手写一个 Skill，需要把触发场景、输出模板和处理流程拆成清晰文件。
  • 审查现有客服回复 Skill 时，发现模板、示例和规则都塞在 SKILL.md，需要拆分材料并加脚本。
  • 修改合同摘要 Skill，需要判断哪些规则可脚本化、哪些表达保留给模型，并补齐自查清单。
  • 把一段长提示词改成可复用 Agent 技能，需要写出具体 description、references 目录和 scripts 脚本。

适合人员

  • 要为客服 Agent 编写可维护技能的工程师，需要把长 Prompt 拆成 SKILL.md、references 与 scripts。
  • 负责 Agent 技能评审的技术负责人，需要检查触发场景、职责边界和可脚本化动作是否清楚。
  • 把提示词沉淀为团队复用资产的 AI 应用开发者，需要补齐模板、示例、字段说明和自查清单。
  • 维护文档或合同处理自动化流程的产品工程，需要区分模型判断步骤与固定脚本步骤。