技能指南
将以下提示词粘贴到你的 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 质量的项目负责人,关注命名、模板和占位符问题。
- 正在创建项目级工作流规范的开发者,想把脚本、文档和校验步骤一起打包。