Agent Skills
返回列表
Skill 开发母规范

Skill 开发母规范

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_343d53e3/disu01。

技能介绍

解决什么问题

Agent Skill 交付常卡在细节：YAML 字段过多、依赖环境变量、脚本入口不唯一、API 路径未验证、zip 包里 SKILL.md 不在根目录。这些问题不会在本地一次运行中立刻暴露，却会让后续加载、分发和复现失败。本技能把开发流程约束成一套可检查的母规范，减少“能跑一次”和“能交付”之间的差距。

如何工作

它按开发步骤推进：先确认技能名称、核心能力、输出格式与外部依赖；再生成需求说明书、目录结构和 SKILL.md。核心要求包括：

  • YAML 头部只保留 name 与 description
  • 配置写入 resources/config.json
  • 执行方式只保留 curl 或 Python 脚本之一
  • API 端点必须真实验证
  • 打包时 SKILL.md 位于 zip 根目录

同时要求编写正常、边缘、不适用和异常用例，并按安全清单检查密钥、权限、日志和合规。

适用边界

它适合用于规范化 Agent Skill 开发，不适合模糊需求或一次性脚本。若功能复杂，应拆分为多个子技能；若 API 端点无法验证，应先停止开发；每个技能应保持单一职责和可复现输入输出。

使用场景

  • 团队要把分散的 Agent Skill 开发约定统一，避免 YAML、脚本入口和目录结构不一致。
  • 交付前需要检查 `SKILL.md` 是否在 zip 根目录、API 端点是否验证、配置是否内嵌。
  • 开发新技能时需生成需求说明书、目录结构、测试用例和安全自查清单。
  • 排查子账号或云端环境下 API Key 不稳定，希望改成读取 `resources/config.json`。

适合人员

  • 负责把 Prompt 流程沉淀为可交付 Agent Skill，且希望统一结构、测试与打包的工程师。
  • 维护多个 Agent Skill 仓库，需要控制命名、目录和 zip 结构一致性的平台研发。
  • 要给 Agent 增加外部 API 能力，但要求配置内嵌、端点验证和最小权限的应用开发者。
  • 需要评审技能开发流程，确保需求、用例、异常处理和安全自查可执行的团队负责人。