chore: prepare repository for publishing

scripts/review/OPENCLAW_MULTI_REVIEW_PROMPT.md

@@ -0,0 +1,77 @@
+# 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）
+- 建议验证方法
+
+完成后，在最终回复中只输出简洁摘要，并列出本次生成/更新的文件。

scripts/review/preflight_task_write_guard.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROJECT_ROOT="/home/long/project/llm-intelligence"
+GLOBAL_GUARD="/home/long/.openclaw/workspace/scripts/preflight_task_write_guard.sh"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  preflight_task_write_guard.sh <writer-role> <target-path> [target-path...]
+
+Writer roles:
+  main-session
+  llm-intelligence-agent
+  llm-intelligence-review
+  llm-intelligence-cron
+EOF
+}
+
+if [[ $# -lt 2 ]]; then
+  usage >&2
+  exit 64
+fi
+
+writer_role="$1"
+shift
+
+case "$writer_role" in
+  main-session)
+    generic_role="main-session"
+    ;;
+  llm-intelligence-agent)
+    generic_role="project-agent"
+    ;;
+  llm-intelligence-review)
+    generic_role="project-review"
+    ;;
+  llm-intelligence-cron)
+    generic_role="project-cron"
+    ;;
+  *)
+    printf '%s\n' "preflight: unsupported writer role: $writer_role" >&2
+    exit 68
+    ;;
+esac
+
+exec "$GLOBAL_GUARD" "$generic_role" "$PROJECT_ROOT" "$@"