HiHuo00 · AI 阅读协议与设计决策
适用：开始一个 UI 任务、接手旧项目、对现有页面提出改进。产出是一张简短决策表，而不是把整套手册全部塞进上下文。
AI-01 · 先识别任务，再选择章节
先检查仓库已有规范、路由、组件、token、设计稿、目标平台和真实内容。记录用户、主要任务、使用频率、错误代价、输入方式与设备环境。
所有产品 UI 实现同时读取 23 · 质量关卡。它要求面向用户写文案、按职责复用、保护个例、明确数值来源，并检查复杂交互和跨页一致性。
| 任务信号 | 读取章节 | 核心问题 |
|---|---|---|
| 新页面或改版 | 01、02、05、13 | 信息和状态是否完整？ |
| 表单、搜索、上传 | 03、04、05 | 如何输入、校验、取消和恢复？ |
| 品牌或主题调整 | 08、09、11 | 视觉决策能否转成共享 token？ |
| 动画、拖拽、实时内容 | 03、10、12 | 替代操作和静态形式是什么？ |
| 支付、权限、AI 代理 | 05、06、07 | 哪些动作需要确认、授权或查询结果？ |
| 修复“像调试页”的界面 | 01、05、09、13 | 缺的是内容、设计依据还是异常状态？ |
| 文案与产品受众不匹配 | 17、20 | 是否泄露内部规则，长度与布局如何管理？ |
| 代码重复、变量混乱、个例被改坏 | 18、19 | 共享语义、规则来源和例外边界是什么？ |
| 深度交互、多页持续迭代 | 21、22、23 | 谁拥有状态，谁受公共变更影响，哪些仍缺设计？ |
索引中的关键词只是检索入口。不能因为出现“动画”就给页面加动画。
AI-02 · 明确设计依据的优先级
在遵循项目工作规则的前提下，设计决策按以下顺序处理：当前任务明确要求 → 已确认的项目设计和平台约束 → 现有组件与 token → 本手册的条件性建议 → 探索方案。
发现冲突时写清楚冲突点。例如：“项目按钮高度为 40px；移动端主操作采用 44px 作为本次设计建议，需与现有组件策略协调。”不要把手册里的示例数字伪装成行业强制标准。
本系列使用三种标签：
- 规范：外部规范的具体要求，附条款和链接，注明等级、条件与例外。
- 建议：本手册的设计默认值，允许根据项目证据调整。
- 示例：用于解释行为的代码或数值，不能直接证明生产环境可靠性。
AI-03 · 把行为、文案、缺口分开
| 类型 | 内容示例 | 对 AI 的要求 |
|---|---|---|
| 行为 | 保存失败保留输入；再次提交不重复创建 | 落到状态和逻辑中 |
| 可见表达 | 标题“项目名称”；失败提示“未能保存，请重试” | 进入界面与读屏反馈 |
| 设计缺口 | 暂无批量操作的移动端方案 | 提出具体方案或沿用明确母版，并标注假设 |
“已接入接口”“失败保留内容”“支持响应式”等实现说明，不应出现在面向普通用户的产品界面。对读者有意义的实现解释可以出现在独立标识的教学说明中，不能混入被展示的产品表单。详见用户文案。
AI-04 · 每个决定保留理由和适用边界
decision:
id: projects.list.pagination
user_goal: 找到并打开一个项目
choice: 分页 + URL 中保存筛选条件
reason: 需要稳定定位、分享和返回原位置
alternatives: [无限滚动, 加载更多]
exception: 以连续浏览为主的图片流可选择加载更多
rules: [IA-02, CMP-05, ST-03]
evidence: 产品需求；已有管理列表母版
verify: 筛选后翻页、刷新、返回，位置和条件仍合理
理由应关联用户任务。“更高级”“更现代”“用户体验更好”无法指导实现或验收。
AI-05 · 交付覆盖范围，不交付虚假的确定性
实现前列出页面 × 状态；实现后分别报告：已实现、已运行检查、已截图、待人工确认。不要把代码编译成功写成“所有交互验收通过”。
遇到未知结果先保留用户工作，再查询或恢复。涉及不可逆操作时，应按项目授权与产品规则处理；视觉确认框不能代替权限和服务端校验。
自检
随机抽取一个按钮，AI 应能指出：任务、规则 ID、触发后状态、键盘行为、失败出口和对应检查。说不清楚，说明还需要补规格。
下一步：通用原则。