@chinhae/atw-cli 0.5.0 → 0.7.0

package/dist/templates/common/bundled-skills/atw-ui/references/visual-language.md

@@ -1,39 +1,49 @@
 # 视觉语言
 
+## 目录导航
+
+- [从整体到局部](#从整体到局部)
+- [焦点与空间](#焦点与空间)
+- [字体与内容](#字体与内容)（含 [可读性是交付门槛](#可读性是交付门槛)）
+- [色彩与表面](#色彩与表面)
+- [控件与图标](#控件与图标)
+
 ## 从整体到局部
 
-先查看信息焦点、构图和内容密度，再调整空间、排版、色彩与细节。前一层已经解决问题时，不为显得精修而继续添加样式。
+先看信息的焦点、构图和内容的疏密，再调空间、排版、色彩和细节。前一步已经把问题解决了，就不为了显得用心再往上加样式。
 
-使用项目有效的视觉变量、组件和参考关系。没有标准时只定义当前需要的文字、颜色与间距角色；不凭空生成完整设计系统。
+项目里现成的视觉变量、组件和参考，能用就用。没有现成标准时，只定义眼下用得到的几种文字、颜色和间距，不凭空造一整套设计系统。
 
-每次修改能说明：哪个可见元素、哪种关系存在问题、调整什么、期待改善什么。源码检查可以证明样式不一致，不能单独证明画面更好。
+每次修改都要说得出：哪个看得见的元素有问题，问题出在它和谁的关系上，打算怎么调，调完应该好在哪里。看源码能证明样式不一致，证明不了画面变好了。
 
 ## 焦点与空间
 
-- 每个任务区域有可辨认的主信息或主动作，辅助信息通过尺度、字重、对比或位置退后；不用多种强强调同时争夺注意力。
-- 同类关系保持同类间距，组内更紧、组间更松。先用对齐与留白建立结构，再判断是否需要容器或分隔线。
-- 留白承担分组、焦点或节奏。工具界面不为追求空旷牺牲必要信息，品牌页面也不强制塞满首屏。
-- 非对称、越界图形或大尺度文字可以表达选定方向，但需要稳定的局部对齐和清楚阅读顺序；不把有意的非对称自动当成错误。
-- 父布局负责区域排列，组件负责自身内部空间。同一距离不要同时由多层样式重复增加。
-- 先把内容直接放在画布上，通过对齐、字号和留白组织。容器只在确有分组、选择、背景对比或操作边界时出现；不要把页面、模块、条目和条目说明逐层套成卡片。
+- 每个区域都要让人一眼认出最重要的那条信息或那个动作，其余信息靠更小的字、更轻的字重、更低的对比或靠边的位置退到后面；不让几种强调同时抢注意力。
+- 同一种关系用同一种间距，一组之内紧一些，组和组之间松一些。先用对齐和留白把结构立起来，再看需不需要容器或分隔线。
+- 留白是用来分组、突出重点和控制节奏的。工具界面不为了显得空旷而砍掉必要的信息，品牌页面也不必把首屏塞满。
+- 不对称的版式、跨出边界的图形和很大的文字，都可以用来表达选定的方向，但局部要对得齐，阅读顺序要清楚；有意做成的不对称，不当成错误去改。
+- 区域之间怎么排由父布局管，组件只管自己里面的空间。同一段距离，不要由好几层样式各加一遍。
+- 先把内容直接放在画布上，靠对齐、字号和留白来组织。只有真的需要分组、表示选中、拉开背景对比或划出操作范围时才加容器；不要把页面、模块、条目和条目说明一层层套成卡片。
 - 分隔线和边框不要重复。每条线只做一件事：同一处分隔不叠双线、单线再加一个框；留白已经分开的地方不再补线；不要每个层级都画一遍线。线的粗细对应层级，例如粗线分版面、细线分栏，全页一致。线本身是风格的一部分时照样保留，只删重复的那些。
 
 ## 字体与内容
 
-- 按标题、正文、辅助信息、标签和数据建立文字角色。角色稳定，层级有足够区别；实际内容长度决定换行和空间。
-- 检查目标语言的字形、字重与回退字体。英文样例好看不能证明中文排版成立；中英混排检查基线与视觉重量。
-- 正文行长与行高服务阅读；密集表格按扫描与比较安排，不套用文章排版。需要纵向比较的数字可使用等宽数字。
-- 重要名称和说明不靠固定高度裁切。确需截断时保留完整内容的可访问入口，避免相近名称截断后无法区分。
-- 先写具体产品内容再调布局。按钮说明动作结果；价值表达使用真实用途，不用空泛口号、虚构背书或无意义英文填版。
+- 把文字分成标题、正文、辅助信息、标签和数据几种角色，每种角色的样式固定下来，层级之间的差别要够大；换不换行、留多少空间，按真实内容的长度来定。
+- 用产品实际的语言检查字形、字重和回退字体。英文样例好看，不代表中文排出来也成立；中英文混排时，看基线是否对齐、两种字看起来是否一样重。
+- 正文的行长和行高，按读起来舒服来定；密集的表格是给人扫视和比较的，不照搬文章的排版。要上下比较的数字用等宽数字。
+- 重要的名称和说明，不用固定高度去裁。确实要截断时，留一个能看到完整内容的入口，并且别让相近的名称截断以后分不出谁是谁。
+- 先把具体的产品内容写出来，再调布局。按钮上写按下去会发生什么；讲产品好在哪里时写真实的用途，不用空泛的口号、编造的背书或没有意义的英文来填版面。
 
 ### 可读性是交付门槛
 
-字号与行高在真实视口、实际字体和 100% 阅读尺寸下判断，缩略图只能用来判断构图。阅读型页面的中文正文通常从 16–18px 起步，产品界面正文 14–16px，每天长时间使用的高密度工具可以到 13–14px（见设计方向里的密度）；正文无单位行高 1.6–1.75；操作文字通常 14–16px。它们是起点，不是跨产品的死规定。不要靠 9–12px 的说明、低对比细字或压缩行高营造“精致”。信息太多先删冗余、调层级或重排。
+字号与行高在真实视口、实际字体和 100% 阅读尺寸下判断，缩略图只能用来判断构图。阅读型页面的中文正文通常从 16–18px 起步，产品界面正文 14–16px，每天长时间使用的高密度工具可以到 13–14px；正文无单位行高 1.6–1.75；操作文字通常 14–16px。它们是起点，不是跨产品的死规定。不要靠 9–12px 的说明、低对比细字或压缩行高营造“精致”。信息太多先删冗余、调层级或重排。
 
 多行中文标题通常先用 1.2–1.35 的行高，按真实字形检查。不要照搬英文大写海报的极紧行高，不把标题高度固定为单行，不用负外边距挤压后续内容。展示字确需更紧时，必须看过每个支持视口的实际换行并确认字形不碰撞。
 
 中文断行要主动控制：`text-wrap: pretty` 或 `balance` 只能减少孤字，不能消除。数字和单位（38 秒、47 分钟）、“不会”这类不可拆的词用不换行包起来；首屏说明、页边批注这类短段落按语义手动断句。行末只剩一两个字，或者词被拆到两行，都算缺陷。
 
+**窄幅展示字（Condensed / Compressed）**：只用于展示标题和极短的编号标签；它牺牲横向辨识度，正文和长阅读用常规宽度的字体。
+
 验收时看长标题、两到三行正文、中英混排、数字单位与字体回退；在窄屏和放大阅读后检查行间、上下区块及按钮内部。文字重叠、截断关键信息或被相邻区域压住属于未完成。先修行高、内容驱动高度和容器伸缩，再考虑减小字号。
 
 ### 示例数据要像真的
@@ -42,25 +52,31 @@
 
 ## 色彩与表面
 
-颜色按文字、背景、动作、选中与状态等含义使用。品牌色与语义状态可以共存，但不能只靠颜色区别重要状态。
+每种颜色都有固定的用处：文字、背景、动作、选中或状态。品牌色和表示状态的颜色可以同时存在，但重要的状态不能只靠颜色来区分。
 
-边框、阴影、材质和渐变要与方向一致，并帮助分层、表达氛围或建立品牌识别。不要把紫色、圆角、渐变列为一律禁用；问题在于无意义重复、主次混乱和不适合任务。
+边框、阴影、材质和渐变要和方向一致，并且真的在帮忙：分出层次、带出氛围，或者让人认出品牌。紫色、圆角和渐变都不是禁用项；出问题的是没有理由地到处重复、主次不分，或者不适合这个任务。
 
-避免每张普通卡片都使用不同的强调色、重边框与重阴影。相同层级保持一致重量；内部嵌套轮廓与外部容器协调。
+不要给每张普通卡片都配上不同的强调色、粗边框和重阴影。同一层级的东西看起来一样重；套在里面的轮廓，要和外面的容器协调。
 
-配色做两个自检：去掉所有发光和模糊后，配色是否还成立；能否说出一个用类似配色的成功产品或出版物。表面层级优先用色温和色相的偏移来区分，而不只靠明暗；背景用带一点温度的中性色；选了黑白方向时，纯白和接近纯黑都可以用，层次靠几级灰来分。
+表面层级可以用色温和色相的偏移来区分，不只靠明暗。配色怎样选、怎样自检，见 atw-prototype 设计方向的“定色彩”；这一节只管颜色怎样用。
 
 质感按调性的完成度取用，不混用：
-- 精致一端：表面的高光、层次柔和的阴影、细微的冷暖交叉色、细线分隔。
+- 精致一端：公差小、层次细，具体手段从这个方向的生成引擎里找。
 - 粗粝一端：手工和印刷留下的痕迹，从这个方向的生成引擎里找，不套一组固定的道具。
 
-核对文字、控件边界、焦点和选中态在实际背景上的可辨认性，尤其是图像、透明和动态背景。遵循项目已有的可访问性目标；基础阅读与操作不能依赖猜测。
+**单色与双色体系**：除了多级中性灰加一种强调色，也可以全页只用一种主色和一种底色，次级信息、边框和禁用态都由主色按透明度或和底色混合派生。
+
+**正反色块交替**：长页面各区块可以在深底亮字与浅底深字之间以硬边直接切换，不用渐变过渡，形成清楚的段落停顿。
+
+在实际的背景上看一遍文字、控件的边界、焦点和选中态是否看得清，背景是图片、半透明或会动的时候尤其要看。项目已有可访问性要求的，照它来；读内容和做基本操作，都不该让人靠猜。
 
 ## 控件与图标
 
-同一界面维持一致的图标语言、光学大小与文字对齐。通用图标优先使用成熟资源；特殊品牌插图单独制作，不为每个标题机械添加图标。
+同一个界面里的图标是同一种画法，看起来一样大，并且和旁边的文字对齐。通用图标优先用成熟的图标库；品牌专属的插图单独画，不给每个标题都硬配一个图标。
+
+能点的东西要让人看得出能点，点了要有反馈。默认、按下、聚焦、选中、禁用和处理中是不同的意思，样子也要不同；只在鼠标悬停时才出现的入口，触屏和键盘也要有办法到达。状态变化时，点击区域不变大变小，也不挤动旁边的布局。
 
-可点击元素需要可识别的入口及相应反馈。默认、按下、聚焦、选中、禁用与处理中表达不同含义；鼠标悬停不能替代触屏与键盘入口。反馈变化保持点击区域与邻近布局稳定。
+控件是一套语法：圆角、描边、字重、阴影、按下时的位移、选中的表达和状态图标，在按钮、输入、标签、开关和空状态之间用同一套逻辑。方向不只贯穿整页，也贯穿每个控件。按钮和输入框还停在组件库的默认样子，换了主色也认不出是哪个产品，就说明控件还没有进入方向。
 
 陌生图标配可见文字；纯图标按钮仍需可访问名称。箭头符号有含义：↗ 表示打开新页面或外部链接，提交、检查这类原地动作不用它。静态标签和装饰不要伪装成按钮，行内按钮不要误触外层卡片动作。
 
@@ -83,6 +99,6 @@
 - **一个产品只用一套。** 需要补缺时，挑描边、端点和圆角一致的，统一成相同的画布尺寸和描边宽度。
 - **粗细跟字重走。** 图标描边接近同尺寸正文的笔画粗细：细字配 1–1.5px，粗黑体配 2px 以上或实心。图标尺寸约为字号的 1–1.25 倍，按视觉中心和文字对齐，不按外框。
 - **能不用就不用。** 编辑类方向常用字符本身：→ ↗ ※ §、编号、缩写。只在能加快识别的地方用图标。
-- **品牌时刻手绘。** 核心动作、空状态这类少数位置，可以用方向自己的线条语言画专属 SVG；通用动作仍用库。
+- **品牌时刻手绘。** 核心动作、空状态这类少数位置，可以用方向自己的线条语言画专属的线条图标或小插图；通用动作仍用库。角色、道具和场景这类主视觉不靠手画 SVG，见 [素材](media.md)。
 - **小样内联。** 自包含小样只内联用到的 SVG，不引用图标字体或 CDN。存量项目沿用已有的库，换库属于改版。
 - **核对许可。** 多数是 MIT、Apache 或 ISC；SF Symbols 只能用在 Apple 平台的界面里，不能用于网页；需要署名的库按要求署名。

package/dist/templates/common/bundled-skills/atw-ui/references/visual-review.md

@@ -1,94 +1,38 @@
-# 视觉评审协议
+# 视觉评审派发协议 (主 Agent 专用)
 
-## 评审者的独立性
+主 Agent 用这份文件派发独立评审。打分标准和检查规则在 [评审手册](reviewer-manual.md) 里，由评审者读；主 Agent 不读，只按下面的清单交接。
 
-选择能实际看图的隔离执行者，不固定供应商、模型价格或参数规模。遵循用户的模型偏好和预算，不假定更贵必然更懂设计。
+## 1. 什么时候该派发？触发什么模式？
 
-首次评审与后续独立复查均使用新上下文。只传当前版本的必要证据，不继承制作对话，也不将旧评审粘进去。主 Agent 保留历史，用于判断建议是否反复和修改是否有效。
+当你完成了一个关键页面、设计方案或改动后，按以下清单触发对应的评审子 Agent：
 
-没有隔离看图能力时，主 Agent 可以直接检查当前画面，但不能称为独立评审。不能看图时只给结构或源码诊断，不根据文件名猜测画面。
-
-## 交接内容
-
-| 提供 | 不提供 |
+| 你做了什么改动 | 子 Agent 的提示词 (Prompt) 模板 |
 | --- | --- |
-| 用户任务、受众、交付范围和目标设备 | 制作者的论证、已经投入的时间 |
-| 已确定的方向、品牌与不可改变约束 | 源码、实现细节与技术借口 |
-| 当前版本截图，注明页面、状态与逻辑视口 | 旧版本截图、旧评分和旧评审结论 |
-| 已实际查看的必要参考与其用途 | 预设问题清单、希望评审者赞同的答案 |
-| 需要评估的可见状态或过程证据；记忆点是动效时，一段 3–5 秒录屏或开始、中间、结束三帧，并写明触发它的动作 | “必须给到某个分数”等通过暗示 |
-
-有记忆点时，评审单独回答：这一刻是否让人记住，动作和结果能否一眼对上。只有静态截图时，评审记录写明记忆点没有评审。
-
-新评审者需要理解任务约束，不能只凭一张图自由改题。参考图用于说明方向或质量基线，精准还原任务除外，不作为要求照抄的目标。
-
-截图文件必须能被评审者访问。交接前确认文件属于当前版本；长页同时提供整体与必要局部，细节图不能替代整体构图。交互只能依据提供的状态与过程证据判断，单张截图不能证明提交或键盘行为正确。
-
-## 可直接使用的评审任务
-
-> 根据提供的用户任务、设计方向、约束和当前画面评审设计。先用一两句话说出这个画面想成为什么体裁和风格；再设想这一体裁里顶尖的设计团队会怎样完成同一任务，可以举一两类真实可参照的作品；然后指出当前画面与那个标准之间差距最大的一到三处。先看主构图、阅读顺序、主视觉和内容与操作的关系，再看排版、空间、色彩和细节。留意过度、夸张或一看就是模型生成的做法并扣分，例如首屏左边大标题、右边说明或图片的默认分栏，无来由的渐变与发光，处处圆角卡片，表情符号图标、随意给文字上色、空泛或晦涩的比喻式文案。画面里多个元素同时争当主角、处处都在用力，也算问题；反过来，处处及格却没有一处让人记住，也指出来，并说出最值得集中发力的位置。留意重复的线框：同一处分隔叠了好几条线，留白已经分开的地方又加线，或者每个层级都画一遍线，让画面发碎。承担风格和结构的线不算问题。单侧的彩色边线（引文、提示、反馈、当前项左边的一条色条）也算问题。画面上的制作说明，例如“示例”“待核实”“示意图”“未接入”，也列进可以直接删掉的文字。体裁指产品本身，例如展览落地页；借用的其他媒介只是风格来源，不按“像不像那个媒介”评判，也不为了更像而建议补上更多部件。如果是工具或后台，再说出一屏能看到几个对象、主动作离当前对象有多远，并和这一体裁里最好的工具比较密度。另外单独列出两类小问题：可以直接删掉的文字，以及对齐、圆角、阴影、标点、状态这类看得出的细节瑕疵；表格和列表要放大看，各列的行线和基线是否对齐。每处问题写清位置、观察、影响和可执行的调整方向，必要时给伪代码或属性关系，不写含糊的散文。敢下判断，给出有主见的建议，不退回安全、容易的做法。区分可观察缺陷与风格偏好；没有明显问题时直接说明，不为凑数提出修改。最后按 10 分制打分，表示当前画面离顶尖水准还有多远。只提供评审，不修改文件，不启动其他评审者。未看到或无法验证的内容明确说明。
-
-如果有同类的优秀作品截图，更好的做法是把它们和当前画面放在一起，例如四张专业作品加一张当前截图，请评审者按完成度和品味排序并说明差距。有视觉基线的比较比“想象顶尖团队”更稳定。这些作品是基线和情绪板，不是要照抄的目标。
-
-用“顶尖团队会怎么做”作为参照，是为了拉高标准、让建议有方向，不是要求照抄某个作品。评审只给方向和具体修改点，不自己重做页面；让评审者直接重做通常时间和成本都会翻倍。
-
-主 Agent 在任务后附实际材料。没有真实材料时不能原样发送模板并让评审者自行想象。
-
-评审同时核对设计北极星是否在构图、字体、素材和交互中形成呼应，突破是否增强主题，以及是否用冗余文字和层层容器掩盖薄弱的主视觉。阅读尺寸下的文字碰撞、过小正文和错误裁切应直接指出；不要仅凭整体缩略图判定可读性通过。
-
-## 给已有界面评审
-
-在已有项目里润色界面时，评审的标准是这个产品自己的设计规范，不是评审者心里的理想风格。规范管“用什么”：哪些颜色、字号、间距、组件；[视觉语言](visual-language.md) 里关于层级、对齐、留白、文字和减法的判断管“怎么用得好”，照常使用。
-
-什么时候用，由 SKILL.md 步骤 4 决定：润色一整页或多页、做完局部重构之后，或者用户要求评审现有界面、没有要求重新设计时。单个元素的小改动不评审；用户要求改版或重新探索时，用上面的正常评审。
-
-### 先确定规范
-
-1. **有成文规范时以它为准。** 优先读 `.atw/spec/` 里界面所在层的 `design-system.md`；其次是设计文档、设计变量（颜色、字号、间距、圆角、阴影）、组件库文档或组件目录。
-2. **没有成文规范时，从现有实现里读出来。** 看设计变量文件和主题配置、共享组件和它们的变体、同类页面的做法，整理一份简短的现状规范：字体和字号层级、每种颜色的用途、间距和圆角、按钮与表单等关键组件的样子、用哪套图标。实现里本来就不一致的，比如三种按钮，以多数用法为准，少数用法记为待统一。
-3. **规范本身有问题时说出来。** 不在评审里悄悄绕开，单独列出，交给用户决定。
-
-### 交给评审者
-
-- 当前版本的截图，注明页面、状态和逻辑视口。
-- 规范：有成文规范时给相关文件或摘录；没有时给整理好的现状规范，再附两三张用了同样组件的其他页面截图，作为一致性的参照。
-- 不能动的清单：品牌、字体、主色、组件库、全局导航，以及用户指定保留的部分。
-- 用户任务和受众。
-
-和正常评审一样，不给源码、制作过程和旧版截图。
-
-### 评审任务
-
-> 根据提供的设计规范、不能改动的清单、用户任务和当前画面，评审这个已有界面。先读规范，再看画面。第一部分，逐条列出画面偏离规范的地方：用了规范以外的颜色、字号、间距或圆角，同类组件长得不一样，没用已有组件而是另做了一个。第二部分，在规范范围内指出最影响完成度的三处问题，依据是层级、对齐、留白、文字、状态和减法这些设计判断。每条建议都要能用现有的设计变量和组件做到；确实需要新增变量或组件时，单独列出并说明理由。不建议更换品牌色、字体、组件库或整体布局。另外列出可以直接删掉的文字，以及对不齐、间距不一这类细节瑕疵。每处写清位置、观察和调整方向。只提供评审，不修改文件，不打分，不启动其他评审者。未看到或无法验证的内容明确说明。
-
-### 处理结果
-
-- 只做一轮。改完由主 Agent 和基线做前后对比，不为分数复查。
-- 偏离规范的问题优先改，改在共享的设计变量和组件上，不在单个页面上覆盖。
-- 需要扩展规范或违背规范的建议，不直接采纳，连同理由交给用户决定。
-
-## 反馈格式
-
-先用短段落说明当前画面如何表达任务与方向。随后按影响列问题，每项包含：
-
-- 位置：页面、区域、状态或元素。
-- 观察与证据：实际看到了什么；不能只说“普通”“不高级”。
-- 影响：妨碍了识别、任务完成、视觉焦点或选定方向中的哪一项。
-- 建议：可执行的调整，必要时提供布局示意或属性关系；不猜不存在的文件与行号。
-- 验证：修改后应检查什么，并指出是否只是主观偏好。
-
-10 分制评分用来衡量差距。分数必须附带具体差距，只有数字的评审不算有效。同一评审模型的前后分数可以比较；不同模型的数值不直接比较，也不把分数当作审美事实。分数高但用户不喜欢时，以用户判断为准。
+| 探索了新界面，或推翻现状重新设计（重塑） | `请读取 references/reviewer-manual.md，按照【全新界面与改版评审】标准，评审这些截图，并给出 1-10 的打分。` |
+| **给已有界面评审**：在已有界面上整理、升级、润色或扩展 | `请读取 references/reviewer-manual.md，按照【存量已有界面润色评审】标准，对比提供的现状规范，指出偏离点。不打分。` |
+| 小改动、单处间距或颜色微调 | **无需派发子 Agent**，主 Agent 结合上下文自行核对即可。 |
 
-## 主 Agent 如何处理反馈
+模板里的路径换成本 Skill 目录下的绝对路径：子 Agent 的工作目录不是本目录。
 
-先处理任务阻碍、内容错误与明显视觉层级问题，再处理有依据的精修。将接受的反馈映射到实际实现；用户指定的风格不能被评审者随意替换。
+## 2. 派发前，主 Agent 要准备的“交接清单”
 
-评审单独列出的“可以直接删掉的文字”默认照删；只有删了会影响理解时才保留，并在记录里写一句理由。
+调用宿主提供的隔离执行能力时，必须提供以下物料：
+- **必给**：当前版本的截图/录屏（注明设备视口）、用户原始任务、设计边界和约束；有方向卡时，再给北极星那一句。方向卡里其他需要评审知道的硬性约束，例如品牌要求每屏出现字标，摘成一句写进约束，不交整张方向卡。
+- **如果有**：现有项目的色彩规范、组件约束（存量老项目必须给）；方向卡的选色记录，即“色彩”一栏里颜色来自这个产品的什么那一句；`.atw/spec/` 里界面所在层有 `design-system.md` 时用它，没有时用项目里的 `DESIGN.md` 或同类设计文档：存量润色评审整份给出并以它为标准，新界面与改版评审只把其中的品牌资产和“不要做”摘进约束。
+- **截图工具的默认做法提示**：`report.json` 里 `lint` 字段的提示原样给出；你决定保留的项，每项附一句理由。
+- **不给**：源代码、为自己的做法辩护的说明、之前评审打过的分数（评分要独立）。
 
-多个评审对不同方向给出同一条建议时，分别在每个方向里找它自己的落地形式，不用一种实现套到所有方向上。
+截图必须属于当前版本，且能被评审者访问；这一轮没有改到的状态和动效，可以沿用上一轮的证据文件，交接时注明哪些是沿用的。长页同时提供整页与必要局部；细节图不能替代整体构图。
 
-建议违反用户约束、仅表达另一种偏好或缺乏证据时，可以不采纳并保留简短理由。为了更像借用的媒介而增加部件、线框或装饰的建议，先对照北极星判断，通常不采纳。一次完成相关改动后集中取证；不每改一个细节就重新派发。
+动效不用逐项备证据：取证那一次的录屏一并交给评审就够。评审能自己打开页面时，把页面地址也给它，录屏里看不清的它会自己操作一遍。
+没有隔离、能看图的执行者时，主 Agent 按同一手册自检，交付时写明“未独立评审”；没有实际画面时不打视觉分。
 
-记录版本、已接受改动、未解决问题与检查结果。保持相当的视口、内容和状态进行前后比较；后续独立评审只看当前版本，前后收益由主 Agent 检查，重大主观取舍由用户判断。
+## 3. 主 Agent 如何处理子 Agent 的反馈
 
-出现持续换风格、互相推翻或细节调整无可见收益时停止美学循环，保留最符合任务与方向的版本。停止不能掩盖仍然存在的功能缺陷或未经验证的部分。
+子 Agent 返回报告后，按以下原则修改：
+- **第一条是“重做”**：回到方向卡，重定被点名区块的骨架或主视觉，不逐条修补。
+- **按清单顺序改**：问题清单从影响最大的一条往下改；“保留”那一行记进设计说明，改的时候对照，别把它修平。
+- **提升条目同样要做**：精致度、设计感和动效的提升不是可选建议，和问题一样按清单做；做不了的在交付说明里写明原因。
+- **默认照删**：子 Agent 列出的“可以直接删掉的无用文字”照删，除非会产生功能歧义。
+- **落到具体调整**：把子 Agent 的高层要求（如“太挤”“层级不清”）落成间距、字号和阴影的实际调整。子 Agent 提议更改用户锁定的品牌色或大框架时，写一句理由后不采纳。
+- **防止死循环**：如果双方审美意见陷入僵持、来回横跳且无可见收益，保留你认为最佳的版本并停止循环。