任务 ID: task-audit-skill-changes | 文件: task.md | 最后修改: 2026-02-25 09:19:50

Task task-audit-skill-changes — 审查 research/SKILL.md 改动与新文件

文件路径

task.md（本文件，创建后不再修改）：/root/.openclaw/workspace/tasks/task-audit-skill-changes/task.md
session.md（执行日志，只追加）：/root/.openclaw/workspace/tasks/task-audit-skill-changes/session.md

原始需求

在未经主人确认的情况下，research/SKILL.md 被修改，同时新增了若干文件。主人要求 reviewer 对这些改动进行全面审查，输出审查报告，评估：
1. 改动是否合理、安全
2. 是否有潜在问题（指令冲突、逻辑漏洞、对 researcher 行为的不良影响）
3. 建议：保留 / 修改 / 回滚

需要审查的文件

修改文件：
- /root/.openclaw/workspace/skills/research/SKILL.md
- 新增「⚠️ 写入强制规则（全局）」章节（文件头部）
- 新增 Step 5 的 PDF scratch 处理流程（5a/5b/5c）
- 新增 Step 2 末尾的 scratch 体量检查逻辑（>300行时通知爱衣）
- 新增「Scratch 文件规范」章节（文末）

/root/.openclaw/workspace-researcher/TOOLS.md
新增「🛠️ 研究专用脚本」章节（pdf_fetch.py 使用说明）

新增文件：
- /root/.openclaw/workspace/scripts/pdf_fetch.py（PyMuPDF PDF提取脚本）

审查重点

research/SKILL.md 改动：
写入强制规则是否与其他章节现有指令冲突？
scratch 文件机制是否清晰可执行（路径、初始化、读取规则是否一致）？
体量检查逻辑（>300行通知爱衣）的阈值是否合理？通知方式是否明确？
新增内容是否有歧义或执行障碍？
TOOLS.md 改动：
pdf_fetch.py 的用法说明��否准确？
使用策略建议是否合理（特别是 max-chars 15000 的建议）？
pdf_fetch.py 脚本：
功能实现是否完整（URL下载、本地文件、--info、--pages、--proxy、--max-chars）？
错误处理是否健全（网络失败、文件不存在、页码越界）？
是否有安全隐患？

审查报告格式

输出文件：/root/.openclaw/workspace/tasks/task-audit-skill-changes/audit-report.md

格式要求：
- 每个文件单独一节
- 每处改动：描述 → 评估（✅合理 / ⚠️需修改 / ❌建议回滚）→ 具体建议
- 末尾给出总体结论：全部保留 / 部分修改（列出） / 建议回滚

执行链

reviewer → 爱衣质检

各 Agent 职责

Ai.Rev（session key: `agent:reviewer:main`）

任务：读取上述所有文件，进行逐项审查，输出 audit-report.md。

开始时：
1. 发工作日志：
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer receive "审查SKILL改动" task-audit-skill-changes

完成后：
1. 将审查摘要追加到 session.md
2. 发工作日志：
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer handoff "审查SKILL改动" main task-audit-skill-changes
3. sessions_send 通知爱衣（agent:main:main，必须传 timeoutSeconds=0，禁止省略）：
task_id=task-audit-skill-changes task=/root/.openclaw/workspace/tasks/task-audit-skill-changes/task.md

⚠️ 爱衣质检 SOP（收到最终通知后执行）

Step 1：评估工作区大小

du -sb /root/.openclaw/workspace/tasks/task-audit-skill-changes/

超过 80KB → 跳至「超限处理」
未超过 80KB → 继续 Step 2

Step 2：读取 session.md

wc -l /root/.openclaw/workspace/tasks/task-audit-skill-changes/session.md

若行数 N > 0，read session.md 全文。

Step 3：质检要点

通用检查（每次必须）：
- 产出是否符合原始需求？
- 执行过程是否有明显问题？

任务特定检查：
- audit-report.md 是否存在且完整（三个文件均有审查节）？
- 每处改动是否有明确结论（✅/⚠️/❌）？
- 是否给出了总体结论（保留/修改/回滚）？
- reviewer 的建议是否具体可执行？

Step 4：输出结论

通过 →
1. 发工作日志：
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main done "审查SKILL改动" task-audit-skill-changes
2. 生成审查报告分享链接：
bash python3 /root/.openclaw/workspace/scripts/fileview-share.py \ /root/.openclaw/workspace/tasks/task-audit-skill-changes/audit-report.md
3. 用 message 工具发送给主人（telegram, 92763607），附审查结论摘要和报告链接

不通过（rejectCount == 0） →
1. 分析问题根因
2. 创建新的 task.md（task_id 加后缀 -retry1），session.md 独立
3. 在原 session.md 末尾追加一行 rejectCount=1
4. sessions_send 给 reviewer 重新执行
5. 发工作日志：
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main retry "审查SKILL改动" "reviewer → main" reviewer 1 task-audit-skill-changes

rejectCount >= 1（第二次仍失败） →
1. 发工作日志：
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main fail "审查SKILL改动" task-audit-skill-changes
2. message 主人，归纳问题，请主人裁决

超限处理（工作区 > 80KB）

仅读 task.md（了解需求）
读 session.md 末尾 200 行
message 主人：任务已完成，但工作区内容繁多，建议人工审计