admin
d9445b5888
- oil-ui-pro 升到 0.22.2：references 13→28 份（新增 16、删 imagery.md）、assets 增 cards/（22 组）与 fonts/、SKILL.md 顶层五步结构未改名。 - 升级路径：官方 `npx github:oil-oil/oil-cli update` 稳定失败（error=replace、报「检查目录权限」）。 真身为 EXDEV —— 解压在 os.tmpdir()（C 盘）、技能目录在 E 盘，Windows 上 rename 不能跨盘； CLI 的 catch 把非 CliError 原生异常一律兜底成 replaceFailed，真错误一个字不吐。 做法＝借其 prepare() 只做下载+校验，再 cp 到同盘 stage、rename 交换；官方命令复验 up_to_date。 - 回归：product-planning 按名引用的 visual-review.md／tools.md／design-direction.md／style-explorer.md 全部健在；命名闸门 2061｜0｜27。 - session-mechanism/references/pitfalls.md 新增 P0-98（含通则：更新器把原生错误兜底成指错方向的人话）。
39 lines
3.8 KiB
Markdown
39 lines
3.8 KiB
Markdown
# 视觉评审派发协议 (主 Agent 专用)
|
||
|
||
主 Agent 用这份文件派发独立评审。打分标准和检查规则在 [评审手册](reviewer-manual.md) 里，由评审者读；主 Agent 不读，只按下面的清单交接。
|
||
|
||
## 1. 什么时候该派发？触发什么模式？
|
||
|
||
当你完成了一个关键页面、设计方案或改动后，按以下清单触发对应的评审子 Agent：
|
||
|
||
| 你做了什么改动 | 子 Agent 的提示词 (Prompt) 模板 |
|
||
| --- | --- |
|
||
| 探索了新界面，或推翻现状重新设计（重塑） | `请读取 references/reviewer-manual.md，按照【全新界面与改版评审】标准，评审这些截图，并给出 1-10 的打分。` |
|
||
| **给已有界面评审**：在已有界面上整理、升级、润色或扩展 | `请读取 references/reviewer-manual.md，按照【存量已有界面润色评审】标准，对比提供的现状规范，指出偏离点。不打分。` |
|
||
| 小改动、单处间距或颜色微调 | **无需派发子 Agent**，主 Agent 结合上下文自行核对即可。 |
|
||
|
||
模板里的路径换成本 Skill 目录下的绝对路径：子 Agent 的工作目录不是本目录。
|
||
|
||
## 2. 派发前，主 Agent 要准备的“交接清单”
|
||
|
||
调用宿主提供的隔离执行能力时，必须提供以下物料：
|
||
- **必给**：当前版本的截图/录屏（注明设备视口）、用户原始任务、设计边界和约束；有方向卡时，再给北极星那一句。方向卡里其他需要评审知道的硬性约束，例如品牌要求每屏出现字标，摘成一句写进约束，不交整张方向卡。
|
||
- **如果有**：现有项目的色彩规范、组件约束（存量老项目必须给）；方向卡的选色记录，即“色彩”一栏里颜色来自这个产品的什么那一句；项目里有 `DESIGN.md` 或同类设计文档时，存量润色评审整份给出并以它为标准，新界面与改版评审只把其中的品牌资产和“不要做”摘进约束。
|
||
- **截图工具的默认做法提示**：`report.json` 里 `lint` 字段的提示原样给出；你决定保留的项，每项附一句理由。
|
||
- **不给**：源代码、为自己的做法辩护的说明、之前评审打过的分数（评分要独立）。
|
||
|
||
截图必须属于当前版本，且能被评审者访问；这一轮没有改到的状态和动效，可以沿用上一轮的证据文件，交接时注明哪些是沿用的。长页同时提供整页与必要局部；细节图不能替代整体构图。
|
||
|
||
动效不用逐项备证据：取证那一次的录屏一并交给评审就够。评审能自己打开页面时，把页面地址也给它，录屏里看不清的它会自己操作一遍。
|
||
没有隔离、能看图的执行者时，主 Agent 按同一手册自检，交付时写明“未独立评审”；没有实际画面时不打视觉分。
|
||
|
||
## 3. 主 Agent 如何处理子 Agent 的反馈
|
||
|
||
子 Agent 返回报告后，按以下原则修改：
|
||
- **第一条是“重做”**：回到方向卡，重定被点名区块的骨架或主视觉，不逐条修补。
|
||
- **按清单顺序改**：问题清单从影响最大的一条往下改；“保留”那一行记进设计说明，改的时候对照，别把它修平。
|
||
- **提升条目同样要做**：精致度、设计感和动效的提升不是可选建议，和问题一样按清单做；做不了的在交付说明里写明原因。
|
||
- **默认照删**：子 Agent 列出的“可以直接删掉的无用文字”照删，除非会产生功能歧义。
|
||
- **落到具体调整**：把子 Agent 的高层要求（如“太挤”“层级不清”）落成间距、字号和阴影的实际调整。子 Agent 提议更改用户锁定的品牌色或大框架时，写一句理由后不采纳。
|
||
- **防止死循环**：如果双方审美意见陷入僵持、来回横跳且无可见收益，保留你认为最佳的版本并停止循环。
|