问题域/PD-196

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 到用户机器的全自动二进制分发链