CLI 技能化架构
CLI Skill Architecture
将CLI工具封装为AI Agent可调用的Skill,通过SKILL.md定义工作流和自然语言接口
子问题
1.Skill元数据与工作流定义
2.自动安装与二进制分发
3.自然语言到CLI命令映射
4.多 Provider 图片生成服务的统一接口与工厂路由
5.SKILL.MD references 子目录的按需上下文加载
6.OpenClaw 插件市场元数据与版本管理
各项目的解法1 solutions
Signals
横向对比
| 维度 | md2wechat-skill |
|---|---|
| 工作流定义 | SKILL.MD 用 YAML frontmatter + Markdown 6步 checklist 定义完整工作流 |
| 二进制分发 | run.sh 三级查找(缓存→本地→GitHub Release 下载),100KB 最小体积校验 |
| 命令路由 | cobra 9 子命令 + PreRunE 延迟配置加载,JSON 统一输出协议 |
| 自然语言映射 | SKILL.MD 内嵌大量 User/Agent 对话示例,few-shot 驱动意图识别 |
| 配置管理 | 三级优先级(env > YAML/JSON 配置文件 > 硬编码默认值),支持 6 个搜索路径 |
| 多Provider适配 | Provider 接口 + 工厂路由,支持 5 个图片生成服务(OpenAI/TuZi/ModelScope/OpenRouter/Gemini) |
| CI/CD集成 | GitHub Actions tag 触发,5 平台交叉编译 + checksums + 自动 Release |
最佳实践
1.SKILL.md定义完整工作流步骤,run.sh处理安装与路由
2.JSON 统一输出协议让 Agent 可靠解析 CLI 执行结果
3.PreRunE 延迟配置加载使 help 命令零配置可用
4.GitHub Actions + run.sh 实现从 tag 到用户机器的全自动二进制分发链