78 lines
4.1 KiB
Markdown
78 lines
4.1 KiB
Markdown
# OpenClaw Multi Review Prompt
|
||
|
||
目标：对 `llm-intelligence` 项目执行一次高频真实状态 review，并顺手沉淀 OpenClaw 能力优化项。
|
||
|
||
执行要求：
|
||
|
||
1. 只基于当前仓库真实状态做判断。
|
||
2. 如果本轮要写 `TASKS.md` 或 `GOALS.md`，必须先执行预检守卫：
|
||
- `bash scripts/review/preflight_task_write_guard.sh llm-intelligence-review /home/long/project/llm-intelligence/TASKS.md`
|
||
- `bash scripts/review/preflight_task_write_guard.sh llm-intelligence-review /home/long/project/llm-intelligence/GOALS.md`
|
||
- 守卫失败时，立即停止写回，不得继续尝试 `edit` 或 `write`
|
||
3. 必须先检查：
|
||
- `git status --short`
|
||
- 最近提交记录
|
||
- `TASKS.md`、`GOALS.md`、`OPENCLAW_EXECUTION.md`、`reports/`
|
||
- 当前可执行的验证入口（例如 `Makefile`、脚本、前后端命令）
|
||
4. 选择最合适的非破坏性验证命令执行；不要伪造“已验证”。
|
||
5. 如果某项能力缺失，明确写成 gap，不要包装成“基本完成”。
|
||
6. 这个 review 任务默认不改业务代码；重点是判断真实进展、识别缺口、更新 OpenClaw 优化 backlog。
|
||
7. 默认**不要更新任何 TASKS/GOALS 状态**。review 是审查，不是任务回收。
|
||
8. 如果用户明确要求在 review 中同步任务状态：
|
||
- 只能写 `/home/long/project/llm-intelligence/TASKS.md`
|
||
- 禁止写 `~/.openclaw/workspace/TASKS.md` 与 `~/.openclaw/workspace/GOALS.md`
|
||
- 写回前必须先跑一次对应目标文件的预检守卫
|
||
- 必须先重新读取最新文件，再决定是否 `write`
|
||
|
||
输出文件：
|
||
|
||
1. 单次 review 报告：
|
||
- 路径：`reports/openclaw/YYYY-MM-DD-HHMM-review.md`
|
||
- 模板：`reports/openclaw/REVIEW_TEMPLATE.md`
|
||
2. OpenClaw 能力优化 backlog：
|
||
- 路径：`reports/openclaw/OPENCLAW_CAPABILITY_BACKLOG.md`
|
||
- 追加或更新发现的问题与建议
|
||
|
||
落盘规则：
|
||
|
||
1. 写输出文件前，先 `read` 现有文件内容。
|
||
2. 生成输出文件时，统一使用 `write` 工具整文件重写。
|
||
3. 不要使用 `edit` 工具追加、替换或局部修改文件。
|
||
4. 如果需要更新 `OPENCLAW_CAPABILITY_BACKLOG.md`，先读完整文件，再把旧内容与本次新增内容合并后一次性 `write` 回去。
|
||
5. 如果工具返回错误，不要原样重试同一个 `edit`；改为重新读取文件并使用 `write` 全量覆盖。
|
||
6. 对任何共享文档，禁止连续使用同一份 stale `oldText` 重试 `edit`。
|
||
7. 如果仓库状态与上一次 review 相比没有 delta，不要机械重复整份完成项清单；要显式写出“无 delta”并把重点转向风险老化、未提交变更、未验证项。
|
||
|
||
`YYYY-MM-DD-HHMM-review.md` 必须与项目 daily memory 使用完全一致的字段命名：
|
||
|
||
- 允许保留标题与 metadata block
|
||
- 除标题与 metadata block 外，顶层 section 只允许：
|
||
- `## Context`
|
||
- `## Evidence`
|
||
- `## Outcome`
|
||
- `## Next`
|
||
- 不要再使用 `Executive Summary`、`当前真实阶段判断`、`已完成项`、`未完成项` 作为顶层 section 标题
|
||
- 推荐字段映射：
|
||
- `Context`：review ID、trigger、scope、时间窗口、当前真实阶段判断、本轮背景
|
||
- `Evidence`：验证命令与结果、已完成项、未完成项、伪进展/文档与实现不一致项、关键 gap 及其证据
|
||
- `Outcome`：执行摘要、风险判断、阶段结论、本轮最重要的落地结论
|
||
- `Next`：下一轮最值得推进的 3 件事、明确 owner 或建议动作
|
||
- `Evidence` 和 `Next` 下允许继续使用二级小节或表格，但字段名必须保持上述四段式
|
||
- `Evidence` 段中的每条关键结论，必须尽量标明证据等级：
|
||
- `runtime-verified`
|
||
- `artifact-present`
|
||
- `doc-claimed`
|
||
- 如果只有 `doc-claimed`，必须直接指出“未做真实验证”，不能包装成完成
|
||
- 新报告默认参考 `reports/openclaw/REVIEW_TEMPLATE.md` 生成，避免自由发挥
|
||
|
||
`OPENCLAW_CAPABILITY_BACKLOG.md` 必须包含：
|
||
|
||
- 日期时间
|
||
- 本次 review 暴露出的 OpenClaw 能力问题
|
||
- 问题影响
|
||
- 优化建议
|
||
- 优先级（P0/P1/P2）
|
||
- 建议验证方法
|
||
|
||
完成后，在最终回复中只输出简洁摘要，并列出本次生成/更新的文件。
|