用途：在 PR 描述中生成并维护一个由标记分隔的“系统回顾”区块，作为高层级的可视化评审辅助。它不依赖部署或第三方服务，GitHub 直接渲染该区块（含 mermaid 图），PR 本身即存储位置。该回顾仅供参考、不阻塞流程，不能替代阅读 diff。
主要能力：支持两种模式，共用同一格式。计划模式在实现前或实现中描述预期改动；回顾模式在创建 PR 及每次有意义的更新时描述 diff 实际做了什么，并替换已有的计划模式区块。回顾模式以 git diff <base>...HEAD（加 git diff --stat）为事实来源，而非记忆。分类需先读取 docs/contributing/architecture/primitives.yaml，并逐字使用其中的 id。风险按 composes（低）、extends（中）、adds（高）分类，并汇总为最高等级；触及原语不变量时需显式标注。
使用方式：区块位于 PR 描述中 HTML 注释标记之间，包裹在 <details> 内，固定章节顺序。回顾模式流程为：读取 primitives.yaml；用 gh pr view <n> --json baseRefName,headRefName 获取分支，再用 git diff <base>...HEAD --stat 及完整 diff 获取事实；将变更路径映射到原语并分类汇总；按格式撰写区块；用 node .agents/skills/visual-recap/scripts/upsert-recap-block.mjs <pr-number> <block-file> 写入 PR 描述，脚本只替换标记之间的内容，首次运行则追加到描述末尾。推送重要新提交后需重跑。
限制：格式要求严格，<summary> 后及每个围栏块周围需空行，否则 GitHub 无法渲染；系统图只展示被触及原语及其直接邻居，整体区块建议远低于约 120 行；若 PR 新增、删除或实质改变原语，需在同一 PR 中更新 primitives.yaml 并在区块中说明。其他细节资料未提供。