OpenCLI 学习 05：能力暴露与自由组合

1. 我当前最强烈的一个感受

不同 Agent、不同底层模型，对同一套 CLI 的理解能力并不一样。

这意味着：

• 同样一个 harness
• 不同 Agent 的使用效果可能差很多

所以真正重要的不只是“有没有这些命令”，而是：

这些能力是如何暴露给 Agent 的。

2. 我目前理解到的关键点

这个项目不是简单把旧软件的功能堆成一堆命令，而是在思考：

• 怎么让 Agent 更容易理解工具能力
• 怎么让 Agent 在面对真实任务时更容易选对命令
• 怎么降低不同模型之间的理解差异带来的问题

也就是说，命令设计、文档、Skill、JSON 输出，这些都不是附属物，而是能力暴露设计的一部分。

3. 我目前觉得这个项目最精髓的地方

它没有把任务流程完全写死。

它做的是：

• 提供一棵结构化的能力树
• 让 Agent 根据真实需求去决定调用哪几个命令
• 让 Agent 自己把这些命令组合成实际工作过程

这一点和固定工作流系统很不一样。

我目前觉得，这恰恰是它最值得学习的地方。

4. 但这里的“自由”不是完全随意

这一点我也逐渐意识到：

• 它不是纯自由探索
• 也不是完全没有边界

更准确地说，是：

在被设计过的命令树和接口边界内，让 Agent 自由组合。

也就是说：

• 命令粒度已经被人设计过
• 命令分组已经被人设计过
• 状态接口和输出格式也已经被人设计过

Agent 的自由，是建立在这些结构化边界之上的。

5. 我目前觉得自己最欠缺的经验

不是具体怎么写某个命令，而是：

• 哪些能力应该暴露
• 应该如何分组
• 命令粒度多大才合适
• 哪些流程要留给 Agent 判断
• 哪些状态必须显式暴露
• 怎样降低 Agent 的理解成本

这更像是“给 Agent 设计工具接口”的经验，而不是普通业务代码经验。

6. 我当前的一句话总结

这个项目真正厉害的地方，不只是把能力做成 CLI，而是把复杂能力整理成一棵结构化、可探索、可组合的命令树，并通过 Skill、JSON 输出和状态接口，尽量降低 Agent 的理解成本，同时又不把任务流程固定死。