claw-code/PHILOSOPHY.md

114 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Claw Code 哲学
## 不要只盯着文件看
如果你只看这个仓库里生成的那些文件,那你就看错了层面。
Python 重写只是一个副产品。Rust 重写也同样如此。真正值得研究的是背后那个**产生这一切的系统**:一个基于 clawhip 的协同循环,人类给出方向,多个 autonomous claws 负责执行工作。
Claw Code 不只是一个代码库。它是一个公开的示范,展示了当以下条件具备时会发生什么:
- 人类提供清晰的方向;
- 多个编码 agent 并行协作;
- 通知路由被移出 agent 的上下文窗口;
- 规划、执行、评审、重试循环实现自动化;
- 人类**并不**坐在终端里一步步微观管理。
## 人类的界面是 Discord
重要的界面不是 tmux、Vim、SSH 或者终端复用器。
真正的人类界面是一个 Discord 频道。
一个人可以用手机打出一句话然后走开、睡觉、或者去做别的事。claws 读取指令,拆解成任务,分配角色,编写代码,运行测试,争论失败,自动恢复,在所有工作通过后推送代码。
这就是哲学的核心:**人类设定方向claws 承担劳动。**
## 三部分系统
### 1. OmX`oh-my-codex`
[oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex) 提供了工作流层。
它把简短的指令转化为结构化的执行过程:
- 规划关键词
- 执行模式
- 持久化的验证循环
- 并行的多 agent 工作流
这一层将一句话转化成一个可重复的工作协议。
### 2. clawhip
[clawhip](https://github.com/Yeachan-Heo/clawhip) 是事件与通知路由器。
它监听:
- git 提交
- tmux 会话
- GitHub issues 和 PRs
- agent 生命周期事件
- 频道消息分发
它的职责是把监控和通知的负担**放到 coding agent 的上下文窗口之外**,让 agents 能集中精力于实现本身,而不是处理状态格式化和通知路由。
### 3. OmO`oh-my-openagent`
[oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) 处理多 agent 协作。
这里包含了规划、任务交接、分歧解决以及跨 agents 的验证循环。
当 Architect、Executor 和 Reviewer 出现分歧时OmO 提供结构化框架让这个循环收敛,而不是崩溃。
## 真正的瓶颈已经变了
瓶颈不再是打字速度。
当 agent 系统可以在几小时内重新构建一个代码库时,稀缺的资源变成了:
- 架构清晰度
- 任务拆解能力
- 判断力
- 品味
- 对什么值得构建的笃定
- 识别哪些部分可以并行、哪些部分必须保持约束
一个快速的 agent 团队不会消除思考的需求。相反,它让清晰的思考变得更有价值。
## Claw Code 演示了什么
Claw Code 展示了一个代码库可以:
- **在公开场合被自主构建**
- 由 claws/lobsters 协作完成,而不只是人和人结对编程
- 通过聊天界面来驱动
- 通过结构化的规划/执行/评审循环持续改进
- 作为协作层的展示而存在,而不仅仅是输出文件
代码是证据。
协同系统才是产品层面的经验。
## 什么依然重要
随着编码智能变得越来越便宜和易得,持续的差异化因素不再是原始的编码产出。
依然重要的东西是:
- 产品品味
- 方向感
- 系统设计
- 人类的信任
- 运营稳定性
- 关于下一步构建什么的判断
在那个世界里,人类的工作不是超过机器的打字速度。
人类的工作是决定什么值得存在。
## 短版本
**Claw Code 是一个自主软件开发的演示。**
人类提供方向。
Claws 协作、构建、测试、恢复、推送。
仓库是产物。
哲学是背后支撑这一切的系统。
## 相关解释
关于这一哲学的更长公开说明,请参考:
- https://x.com/realsigridjin/status/2039472968624185713