Agent Skills
返回列表
技能指南

技能指南

教育学习 更新于 2026.08.30

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

请根据官方安装指南 https://skillhub.cn/install/skillhub.md,将规范名为 @org-ola92r0d/skill-guide 的技能安装到您的 AI 助手中。

技能介绍

它解决什么问题

通用 Agent 并不天然知道某个团队的工作方式:流程散落在文档里,模板藏在仓库角落,校验脚本和领域规则也难以在一次对话中完整注入。结果就是每次都要重新解释背景,或者把大量上下文塞进提示词,容易遗漏约束、产出不一致。Skill 的价值在于把这些可复用的程序性知识打包成独立模块:触发条件、执行步骤、模板、脚本和验收标准集中放在一起。

Skill 如何组织与工作

这个技能面向两类任务:解释 Skill 的概念,或直接指导创建。它先建立类比——Skill 类似“入职指南”,让 Agent 进入特定领域;再进入结构:

  • SKILL.md 是主入口,保持精简,写清楚任务流程和必要约定。
  • 元数据中的 name 和 description 常驻上下文,负责决定何时触发。
  • references/ 保存按需加载的详细资料,避免主文件膨胀。
  • assets/ 承载模板、脚本和示例资源。

创建时,技能会优先调用 skill-creator 的脚手架生成标准骨架。用户级技能放在 ~/.workbuddy/skills/,项目级技能放在 .workbuddy/skills/。接着编写 SKILL.md:全程使用祈使句,description 用第三人称写清“做什么”和“何时触发”,并删除无用示例。完成后运行 package_skill.py 校验 frontmatter、命名和目录结构,生成 zip,再通过真实任务迭代。

适用边界与注意点

它适合沉淀领域工作流、工具集成方式、业务规则和可复用资源,不适合把所有零散笔记都塞进一个技能。高质量 Skill 应控制主文件长度,把细节下沉到 references,并在检索关键词、触发条件、验收清单之间保持一致。评审时应逐项检查是否存在 TODO、占位符、多余示例和误导性触发描述。

使用场景

  • 需要在团队内沉淀多步骤操作流程,让 Agent 按固定顺序调用工具和检查产物。
  • 想把公司特有的校验规则、Schema 和模板打包,避免每次对话重新解释。
  • 已有一份 Skill 但触发混乱,需要依据清单逐项评审 description 和目录结构。
  • 准备发布新技能,需要运行打包脚本检查 frontmatter、命名与生成 zip。

适合人员

  • 正在设计 Agent 技能的后端工程师,希望建立清晰的触发条件和加载结构。
  • 负责团队流程治理的技术写作者,要把重复操作沉淀为可执行指南。
  • 需要验收第三方 Skill 质量的项目负责人,关注命名、模板和占位符问题。
  • 正在创建项目级工作流规范的开发者,想把脚本、文档和校验步骤一起打包。