task_id: task-agent-revise
创建时间: 2026-02-24
状态: 待执行
执行人: Ai.Rev 🔍
爱衣写了 AGENTS.md 模板和 Agent 生命周期 SOP，你（Ai.Rev）完成了评审，爱衣对评审意见进行了仲裁，确定了需要修订的问题清单。本任务由你负责按仲裁结果修订这两个文件。
/root/.openclaw/workspace/tasks/task-agent-template/AGENTS-template.md/root/.openclaw/workspace/memory/docs/sop/agent-lifecycle.md/root/.openclaw/workspace/tasks/task-agent-review/review-report.md以下是需要修订的内容，注意驳回的意见不要修改：
| # | 修订项 | 说明 |
|---|---|---|
| M1 | 占位符加粒度引导 | 在 Code Style 等章节的占位符注释里加"好例/坏例"对比，让使用者知道够具体的标准 |
| M2 | 文件开头加 Onboarding Path | 2-4 行，给 agent 明确的第一步：先做什么、再做什么 |
| M3 | Environment 拆三个独立小节 | 把 Note 大杂烩拆为：Sandbox Constraints（移到 Environment 之后紧跟）、Required Env Vars、Version Requirements |
| M4 | Architecture 章节重写占位符 | 加层依赖方向的示例，让使用者知道这里该写什么粒度 |
| M5 | build 强约束移到 Security 重复 | 在 Security/Forbidden 里明确列出 build 命令的约束 |
| M6 | Testing 加可选失败上报规则 | 加一条：N 次失败后停下来向用户报告（N 用占位符，项目方自填） |
| M7 | Project Overview 加 Monorepo 跳转提示 | 加一行条件提示：如果是 monorepo，先看文末的 Monorepo 章节。章节位置不动 |
以下意见被驳回，不要修改：
- ❌ Environment 章节加"失败处理"说明（超出文件职责范围）
- ❌ Commands 表格预设 agent 何时主动跑 build（项目特定，模板不预设）
- ❌ Monorepo 章节移到文件前面（单仓库项目占多数，末尾是正确位置）
| # | 修订项 | 说明 |
|---|---|---|
| S1 | Step 2→3 之间加停止条件 gate | 职责与现有 Agent 超过 50% 重叠、或无法清晰定义触发条件 → 停下来重新讨论 |
| S2 | Step 7 改为端到端冒烟测试 | 在文件系统检查之外，加一个发测试消息确认 Agent 响应的步骤 |
| S3 | 修改章节加回滚步骤 | 操作失败时如何用备份恢复 openclaw.json |
| S4 | Step 5 加降级说明 | 找不到被引用 SOP 时：停下来联系爱衣，不要自行猜测步骤 |
直接修改原文件（in-place 修订）：
- /root/.openclaw/workspace/tasks/task-agent-template/AGENTS-template.md
- /root/.openclaw/workspace/memory/docs/sop/agent-lifecycle.md
修订完成后，写一个简短的修订说明到：
- /root/.openclaw/workspace/tasks/task-agent-revise/revision-notes.md
- 每条修订做了什么，以及 diff 摘要
发通知给 agent:main:main，格式：
task_id=task-agent-revise
task=/root/.openclaw/workspace/tasks/task-agent-revise/task.md
爱衣收到通知后将读取修订后的文件进行质检：
1. 所有 M1-M7、S1-S4 修订项均已落实
2. 驳回的意见未被修改
3. 文件整体结构未被破坏，可读性不低于原版
4. revision-notes.md 有清晰的变更记录