111 lines
3.2 KiB
Markdown
111 lines
3.2 KiB
Markdown
|
# OpenClaw 执行诊断与修复
|
|||
|
|
|
|||
|
|
## 结论
|
|||
|
|
|
|||
|
|
`llm-intelligence` 当前的问题，**主因不是规划文档写得不够多，而是 OpenClaw 没有形成项目内执行闭环**。根因排序如下：
|
|||
|
|
|
|||
|
|
1. **协作问题最严重**
|
|||
|
|
- 项目没有本地 `GOALS.md` / `TASKS.md`
|
|||
|
|
- 验证器默认读取的是全局 `~/.openclaw/workspace/TASKS.md`
|
|||
|
|
- `openclaw.json` 中唯一明确绑定的 MCP `cwd` 指向 `ai-customer-service`，不是本项目
|
|||
|
|
- 结果是：`llm-intelligence` 被塞进全局流程里，执行上下文被其他项目污染
|
|||
|
|
|
|||
|
|
2. **角色设计问题第二严重**
|
|||
|
|
- 任务全部挂在“宰相”单角色上
|
|||
|
|
- `subagents/runs.json` 为空，说明并没有真实发生多角色并行
|
|||
|
|
- 文档、设计、采集器、前端、验收没有拆给不同责任面
|
|||
|
|
|
|||
|
|
3. **skills 问题是次要但真实存在**
|
|||
|
|
- 关键技能如 `code-analyzer`、`frontend-design`、`github`、`review-pr` 是可用的
|
|||
|
|
- 但很多技能通过软链挂到 `~/.agents/skills`，被 OpenClaw 以 `symlink-escape` 拒绝加载
|
|||
|
|
- 这会导致“看起来安装了，运行时却没真正可用”的错觉
|
|||
|
|
|
|||
|
|
## 现状误区
|
|||
|
|
|
|||
|
|
### 误区 1：规划已完成，执行自然会跟上
|
|||
|
|
|
|||
|
|
不是。现在仓库里主要是：
|
|||
|
|
- `PRD.md`
|
|||
|
|
- `FEATURE_LIST.md`
|
|||
|
|
- `BUSINESS_MODEL.md`
|
|||
|
|
- `TECHNICAL_DESIGN.md`
|
|||
|
|
|
|||
|
|
但没有：
|
|||
|
|
- 数据采集脚本
|
|||
|
|
- `db/migrations`
|
|||
|
|
- `frontend/`
|
|||
|
|
- `reports/daily/`
|
|||
|
|
|
|||
|
|
说明执行没有从“文档阶段”切到“实现阶段”。
|
|||
|
|
|
|||
|
|
### 误区 2：任务状态是可信的
|
|||
|
|
|
|||
|
|
不是。全局 `TASKS.md` 中出现这种状态漂移：
|
|||
|
|
- `TECHNICAL_DESIGN.md` 已标记完成
|
|||
|
|
- 后续任务仍写着“等待技术设计完成后启动”
|
|||
|
|
|
|||
|
|
这是典型的任务依赖没有被回收更新。
|
|||
|
|
|
|||
|
|
## 修复策略
|
|||
|
|
|
|||
|
|
## 一、项目内闭环
|
|||
|
|
|
|||
|
|
本项目必须有自己的：
|
|||
|
|
- `GOALS.md`
|
|||
|
|
- `TASKS.md`
|
|||
|
|
- `scripts/verification_executor.go`
|
|||
|
|
|
|||
|
|
不要继续依赖全局 `~/.openclaw/workspace/TASKS.md`。
|
|||
|
|
|
|||
|
|
## 二、角色拆分
|
|||
|
|
|
|||
|
|
建议固定四个责任面：
|
|||
|
|
|
|||
|
|
- **产品架构师**
|
|||
|
|
- 负责 PRD、Feature List、技术范围一致性
|
|||
|
|
- **数据后端**
|
|||
|
|
- 负责采集器、数据库、日报生成
|
|||
|
|
- **前端实现**
|
|||
|
|
- 负责 Explorer / Dashboard
|
|||
|
|
- **集成验收**
|
|||
|
|
- 负责验证器、任务回收、日报推送
|
|||
|
|
|
|||
|
|
角色不是为了“显得高级”，而是为了让任务能并行、状态能落地。
|
|||
|
|
|
|||
|
|
## 三、执行顺序
|
|||
|
|
|
|||
|
|
按这个顺序推进：
|
|||
|
|
|
|||
|
|
1. 冻结 Phase 1 范围
|
|||
|
|
2. 产出 OpenRouter 采集器
|
|||
|
|
3. 产出 PostgreSQL migration
|
|||
|
|
4. 产出日报生成器
|
|||
|
|
5. 搭 Explorer 最小页面
|
|||
|
|
6. 接日报推送
|
|||
|
|
7. 每一步通过项目内验证器回收
|
|||
|
|
|
|||
|
|
## 四、技能治理
|
|||
|
|
|
|||
|
|
短期内不需要继续“装更多 skill”，先把现有能力用好。
|
|||
|
|
|
|||
|
|
优先使用：
|
|||
|
|
- `code-analyzer`
|
|||
|
|
- `frontend-design`
|
|||
|
|
- `github`
|
|||
|
|
- `review-pr`
|
|||
|
|
- `self-improving-agent`
|
|||
|
|
|
|||
|
|
后续要处理的是软链越界问题，不然技能表会继续出现“已安装但跳过加载”。
|
|||
|
|
|
|||
|
|
## 推荐动作
|
|||
|
|
|
|||
|
|
### 立即做
|
|||
|
|
- 使用本项目 `TASKS.md`
|
|||
|
|
- 只围绕 `llm-intelligence` 运行验证器
|
|||
|
|
- 把任务从“写文档”切到“产出采集器 / migration / frontend skeleton”
|
|||
|
|
|
|||
|
|
### 不要做
|
|||
|
|
- 不要继续往全局 `TASKS.md` 塞本项目任务
|
|||
|
|
- 不要把所有任务都挂在单角色“宰相”名下
|
|||
|
|
- 不要再新增一轮大而全设计文档，先把实现骨架跑起来
|