OpenCLI 学习 06：Agent-First 与设计重心

1. 我当前对这个项目最核心的一个判断

我现在越来越觉得，这个项目的核心是 agent-first。

也就是说，它是先站在“未来软件能力会越来越需要被 Agent 调用”的前提出发，再反过来思考：

• 接口应该长什么样
• 能力该如何暴露
• 什么样的形式最适合 Agent 理解和调用

在这个前提下，CLI 形式的 harness 就变成了一种非常现实的工程落地方式。

2. 为什么它不把流程写死

我当前的一个重要理解是：

这个项目不想做固定工作流系统。

它更希望做的是：

• 把领域能力整理成结构化命令树
• 把这些能力作为一组可组合的工具暴露出来
• 把具体任务编排尽量交给 Agent 自己决定

所以它信任 Agent 的地方在于：

• 让 Agent 去选命令
• 让 Agent 去组合步骤
• 让 Agent 去形成任务级流程

3. 但这不是“少设计”

这一点是我现在特别明确的一个修正。

不能把这个项目理解成：

• 因为相信 LLM 很强
• 所以就少设计
• 甚至过度设计完全多余

这个理解是不准确的。

更准确的理解是：

它不是少设计，而是把设计重点从“预设流程”转移到了“能力接口”。

也就是说：

• 不设计死的工作流
• 但会高度设计命令树、状态模型、JSON 输出、Skill、反馈接口和测试机制

4. 我现在理解的真正平衡点

这个项目的平衡点不是：

• 完全交给 Agent 自由发挥

而是：

• 人类先设计稳定的能力边界
• Agent 再在这些边界内自由编排

所以更准确地说：

它不是在赌 Agent 不需要设计，而是在赌“只要能力边界设计得好，任务流程就不需要被提前写死”。

5. 为什么 CLI 适合这个思路

在这个项目里，CLI 的意义不是“黑框操作”，而是：

• 有明确命令和参数
• 可探索
• 可组合
• 可输出 JSON
• 人和 Agent 都能用

所以 CLI 很适合作为 Agent-first 接口的外在形式。

而 harness 则是让这种外在形式真正接上复杂软件能力的内在实现。

6. 我当前的一句话总结

这个项目的核心不是“为 CLI 而 CLI”，也不是“因为相信 LLM 很强所以不设计”，而是站在 agent-first 的角度，把设计重点从固定流程转移到能力接口，让人类负责设计清晰边界，让 Agent 负责在这些边界内自由编排任务。