# 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` 塞本项目任务
- 不要把所有任务都挂在单角色“宰相”名下
- 不要再新增一轮大而全设计文档，先把实现骨架跑起来