---
name: soloforge-prototype-spec
description: 把真实原型素材转成按端、按页可实现和可验收的 UI 约束。
when: 原型说明 / prototype_spec / 涉及前端时
---

# 原型说明

## 适用性

在任务涉及前端，且存在图片、HTML、设计文件、视频、可运行原型或用户确认的文字交互规格时使用。没有视觉素材时仍可记录交互与数据契约，但视觉结论必须标待确认，不能臆造。

## 事实输入

- 用户提供的原型素材及其版本、来源和可见状态。
- 需求端清单、已确认的项目目录和页面范围。
- 路由、数据字段、权限和异常分支等上游契约。
- `template.md` 和 `examples.md`。

## 关键决策

- 哪些页面属于本期、哪些状态必须覆盖、哪些视觉值可精确读取。
- 图片只能近似推断的尺寸或颜色必须标注“近似”并安排人工校对。
- 素材之间冲突时，以用户指定的权威版本为准，不能自行拼接。

## 产出方法

1. 按已确认的端目录和页面拆分，一页一份说明。
2. 默认路径为 `docs/analyze/{端目录}/pages/{页面}-原型说明.md`；brownfield 或自定义 project map 服从解析后的权威路径和目录命名。
3. 引用共享设计系统，只提取本页实际使用或偏离的约束；再完成布局、组件数据、交互状态、异常、响应式、无障碍和动效。
4. 每条重要约束标明素材类型与具体来源位置。
5. 把无法从素材确认的内容列为待确认项，不写成事实。

## 禁止项

- 不得从其他产品、组件库默认值或个人审美补视觉规则。
- 不得用通用登录页、通用表格等示例骨架替代真实页面。
- 不得省略空态、错误态、加载态、权限态和不可用态。
- 不得把多个端或多个页面合并成一份模糊说明。

## 交付自检

- 每个本期页面都有独立文件并归属正确端目录。
- 交互事件能落到前后状态、数据变化和失败反馈。
- 精确值、近似值和未知值区分清楚。
- 共享约束与页面级差异分开，没有为填表重复抄整套 token。
- 页面与需求、路由和数据字段可追溯。

## 权威验证

编辑后先处理 quick 反馈，再调用 `sf_verify action="full" task_id="当前任务ID" artifact="prototype_spec"`。full 通过后仍需在实现和测试阶段按页做交互与视觉验收。


## 交付前对抗审查

`sf_verify` 通过只证明结构/编译/测试层；语义质量（承接正确性、异常/并发/权限/边界是否可靠、是否含空话或无法证伪的承诺）须经独立对抗审查。advance/deliver 前用 `sf_review action="start" task_id="当前任务ID" artifact="<本产物 kind>"` 发起 per_artifact 审查，用**独立 session/subagent**（非产出本产物的同一会话）执行返回的 prompt、submit findings，按 next_step 完成 K 次独立采样与闭环。deliver 会阻断未完成/未闭环的审查；活跃豁免与被驳回 error 会被注入审查 focus 供独立复核。