用途：这是一个编码智能体（如 Claude Code、Codex 等）在开发本仓库时运行的斜杠命令工作流，可通过 /review-and-improve 调用，或描述任务后自动触发。它面向“公开发布就绪”做全仓库漂移巡检，属于可反复运行的周期性检查：干净仓库以“无差异”结束，脏仓库则把一切恢复一致。AGENTS.md 是仓库约定的唯一事实来源，CLAUDE.md 是指向它的符号链接，改一处两处同步。
主要能力：自动就地修复机械性偏差，包括文档中过期的文件路径、代码实际读取但 example.env 缺失的环境变量、无人读取的过期变量（除非注释说明为可选/未来功能）、架构图缺失的已注册智能体或工作流、磁盘上新增但未在 app/main.py 导入的智能体文件、已注册智能体缺失的 quick_prompts 块、文档与 .agents/skills/*/SKILL.md 之间缺失或错误的交叉链接、以及文档间或文档与代码矛盾的单行事实性描述。需要用户决策的则只标记不修改：章节级文档重写、导入之外的代码改动、pyproject.toml 依赖修改、db/、compose.yaml、Dockerfile 中的内容、失败的评测用例或异常智能体。
使用方式：先确认容器可达（curl -sSf http://localhost:8000/health 返回 200，否则先 docker compose up -d --build），建议新建分支 git checkout -b review/$(date +%Y%m%d)。随后依次进行范围确认、清单盘点、一致性比对、活容器冒烟测试（curl -s http://localhost:8000/agents 核对已注册智能体，再逐个用 quick_prompt 调用）、格式化与校验（./scripts/format.sh、./scripts/validate.sh）、可选评测（python -m evals --profile release，会调用 OpenAI 产生费用，需先询问），最后输出报告：自动修复项、待用户决策项、git diff --stat 与建议提交信息。
适用场景与限制：适合公开发布前或定期巡检本仓库。评测步骤涉及外部 API 与费用，需用户确认；质量类问题（回答看似合理但错误、缺少引用、工具调用错误）不在本技能范围内，应转交 improve-agent 或 extend-agent。若磁盘存在多个 worktree，仅一个容器能绑定 localhost:8000，需交叉核对。