Agent 技能协议
Agent Skill Protocol
定义 Agent 可消费的技能指令格式，实现跨 Agent 平台的能力注入与命令参考
子问题
1.技能指令格式标准化(SKILL.md)
2.多 Agent 平台技能目录适配
3.触发词与命令映射
4.故障排查指南集成
5.双受众文档设计(人类+Agent共用同一URL)
6.doctor驱动的诊断-修复-验证自愈循环
7.wheel打包确保技能文件版本与工具版本锁定
各项目的解法1 solutions
Signals
横向对比
| 维度 | Agent |
|---|---|
| 技能格式 | YAML frontmatter + Markdown body 双层结构 |
| 部署方式 | importlib.resources 包内读取 + 三目录探测自动部署 |
| 命令映射 | SKILL.md 直接列出 12+ 上游工具原生命令，不做 wrapper |
| 故障排查 | doctor 驱动单入口诊断，SKILL.md 不穷举修复步骤 |
| 版本管理 | wheel force-include 随包分发，pip install 即版本锁定 |
| 平台覆盖 | OpenClaw + Claude Code + 通用 Agent 三平台 |
最佳实践
1.SKILL.md 包含完整命令参考让 Agent 自主调用
2.自动检测并部署到已知 Agent 平台的 skills 目录
3.技能文件随包分发确保版本一致
4.SKILL.md 用 doctor 单入口替代穷举式故障排查，避免文档膨胀
5.install.md 分 For Humans/For AI Agents 双受众，同一 URL 服务两类消费者
6.pyproject.toml force-include 确保 skill 目录进入 wheel，避免 MANIFEST.in 遗漏