Agent Skills
返回列表
智能体技能工坊

智能体技能工坊

AI Agent 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_246d1f61/yinzhou-create-agent-skills

技能介绍

要解决的问题

给 AI 代理添加领域知识时，最常见的做法是把所有指令塞进系统提示词或对话历史里。这种做法在初期能跑通，但很快会遇到两个麻烦：一是上下文窗口被大量重复或不必要的解释占满，真正关键的指令反而被淹没；二是知识无法复用和分发，换一个项目就要从头再写一遍。Agent Skills 的思路是把程序性知识打包成模块化的独立单元，但「怎么打包」本身就是一个容易踩坑的问题——文件结构怎么组织、哪些内容放主文件、哪些放参考文档、指令写多细，这些决策直接影响技能的实际效果。

技能如何工作

这个技能提供一套完整的创建流程，核心是三个设计原则：

  • 简洁至上：默认 AI 已经很聪明，只补充它尚未拥有的上下文。每条信息都要问自己：AI 真的需要这段解释吗？
  • 匹配自由度：根据任务的脆弱性和可变性选择指令的具体程度。高风险操作用低自由度的固定脚本，开放性任务用高自由度的文字描述。
  • 渐进式披露：元数据（name + description）始终在上下文中，SKILL.md 正文仅在技能触发时加载，scripts/、references/、assets/ 中的资源按需读取或直接执行。

具体创建流程分为七个步骤：先用具体示例理解技能的使用场景，再规划可重用的脚本、参考和资产，然后运行 init_skill.py 初始化目录结构，接着编写 SKILL.md 正文和资源文件，如需中文版本运行 translate_skill_md.py 翻译，最后用 package_skill.py 打包验证。

适用边界与注意点

  • SKILL.md 正文控制在 500 行以内，超出时拆分到 references/ 中并从主文件引用
  • 参考文件不要深层嵌套，保持与 SKILL.md 一级深度
  • 技能目录里不要放 README.md、CHANGELOG.md 等辅助文档，只保留 AI 完成工作所需的信息
  • 脚本必须实际运行测试，不能只靠阅读代码判断正确性

使用场景

  • 需要为 docx 文档处理创建 Agent Skill，让 AI 代理知道如何处理 .docx 文件的修订跟踪和注释
  • 要为前端 Web 应用开发创建技能，把 HTML/React 样板代码作为 assets 模板供 AI 构建待办应用或仪表板时复用
  • 需要将开发完成的 Agent Skill 翻译成中文版本，在保留 YAML frontmatter 结构的同时更新 name 字段
  • 准备将技能打包为 .skill 文件分发，需要先验证 frontmatter 格式、命名约定和目录结构是否符合规范

适合人员

  • 为团队 AI 代理构建领域专用技能的工程师，需要掌握技能目录结构和渐进式披露设计来管理上下文窗口
  • 维护企业 AI 工作流的开发者，希望将公司特定的数据模式和业务逻辑封装成模块化的 Agent Skill 供多个项目复用
  • 需要为 AI 代理创建中文本地化技能的开发者，希望在翻译正文时保留 frontmatter 的机器可读结构
  • 负责 AI 工具标准化的技术负责人，需要确保分发的技能都经过打包脚本验证并符合命名和目录规范