把现有系统改造成 Agent Native 接口的方法论和工具。
基于《从 GUI 到 CLI:现有软件的 Agent 化改造思路》— 探讨如何把现有软件(GUI、CLI、REST API)改造成 AI agent 可直接调用的 Skill + CLI 形态。
Skill + CLI 是改造现有系统的最优解。
| 方案 | 本地安装 | 分发成熟度 | 云端成本 | 调用延迟 |
|---|---|---|---|---|
| 纯 Skill | ✅ | 低 | 快 | |
| Skill + CLI | ✅ | ✅ pip/npm/brew | 低 | 快 |
| MCP | ✅ | 高 | 中 |
- 幂等优先 — 重复执行不破坏状态,给 agent 试错的勇气
- 输出结构化 — stdout JSON,stderr 人类可读,exit code 精确
- 粒度重设计 — 一个 CLI 完成一个业务目标,而非一个技术操作
- 参数自解释 —
--user-id好过--uid - 文档即 prompt —
--help的内容就是给 agent 的使用说明
service-to-cli/
├── SKILL.md # OpenClaw 技能文件
└── README.md # 整体说明
当需要把某个现有系统改造成 agent 可用的工具时,运行此 skill,它会:
- 分析现有系统,梳理业务原子
- 按五大原则设计 CLI 粒度
- 生成 Skill.md + CLI 代码骨架
- 输出完整交付物
MIT