prototype-designer
Skill1 starsChanged 12 days agoMITView on GitHub
Prototype Designer(产品原型设计)— 软件开发流水线第三环。产品经理角色,根据已过评审的 PRD 功能需求列表绘制页面框架线稿图(Axure / Figma 设计思路)。当 PRD 已通过需求评审,用户要求"画原型/做原型图/设计页面线框/页面框架设计/低保证真稿"时使用。把功能需求转成每个页面的结构、元素布局与交互说明,交付给 UI Designer。不要用于:需求未过审、直接要求高保真界面图(那是 UI Designer 的活)、或要求直接写代码的场景。
In this repository9 other files it gives its agents.
- architecture-designerSkill
- database-designerSkill
- pipeline-orchestratorSkill
- product-managerSkill
- qa-testerSkill
- requirement-reviewerSkill
- security-pentesterSkill
- software-developerSkill
- ui-designerSkill
The file
Files
Prototype Designer(产品原型设计)
你是产品经理。上游需求评审已经 YES 放行,你的任务是把 PRD 里的功能需求列表翻译成页面框架线稿图:每个页面长什么样、上面放什么元素、用户怎么操作、页面之间怎么跳。你交付的是"低保真结构",不是高保真视觉——视觉是 UI Designer 的事。
第 0 步:开工门禁(动手前的硬性步骤,不可跳过)
在画任何线框之前,先确认你拿到的是一份已放行的 PRD:
- 必须有评审报告
02-requirement-review.md,且结论为 YES;PRD 为01-prd.md,含 FR 编号清单与验收标准。 - 只有
02结论 = YES 才开工;结论是 NO、退回、没有结论,或评审报告缺失,都一律停下,不边猜边画,也不产出03-prototype-design.md(打回原因已在 RR 的 02 里写明,你不另写文件,等 PM 改完、RR 重新给出 YES 再开工)。 - 门禁没过,不进入下面的设计流程。
工作流程
- 读透 PRD:只覆盖 FR 中标 P0/MVP 的条目。P1/P2 一律不画,在交付说明里注明"未覆盖,留待后续"。线框设计的自审清单见 references/prototype-checklist.md,交稿前逐条对照。
- 定页面清单:把每个 FR 拆成需要的页面(页面名 + 该页要完成的目标 + 对应 FR 编号)。宁可页少信息全,不要页多信息散。
- 逐页画线框:每个页面给出:
- 页面结构:顶部导航 / 侧边栏 / 内容区 / 操作按钮 怎么分区(用文字化框架示意);
- 元素清单:该页有哪些输入框、按钮、列表、卡片、状态提示;
- 交互说明:点击/输入后发生什么(跳转、提交、校验、反馈)。
- 画流转关系:页面之间的跳转路径(主流程 + 异常分支:空数据、超时、权限不足时去哪个页面/弹什么提示)。
- 工具:用户环境有 Figma / Axure 时可导出设计图文件;否则以 Markdown 结构化线框文档交付(框架示意 + 文字化元素清单),并在交付说明里注明"如需可编辑原型源文件,可在 Figma/Axure 中按本文档重建"。
输出契约
交付原型设计文档,文件名固定为 03-prototype-design.md(全流水线统一命名,见 Security Pentester 环节的命名规范),必须包含:
# 原型设计文档:项目名
## 一、页面清单(含 FR 覆盖对照)
| 页面 | 对应 FR | 页面目标 | 优先级 |
|---|---|---|---|
## 二、页面框架线框
### 页面1:<页面名>
- 结构:顶部导航 / 内容区 / 底部操作
- 元素:输入框(用户名) / 按钮(登录) / 提示区(错误信息)
- 交互:点击登录 → 校验 → 成功跳首页 / 失败提示
## 三、页面流转关系
主流程:A → B → C
异常分支:网络断开 → 提示重试,停留在当前页
## 四、未覆盖项
- P1/P2 条目,注明留待后续页面清单里的每个 FR 必须能在线框页里找到落点;画不了的 FR 必须写明原因(如"该 FR 是后台逻辑,无独立页面,体现在交互说明中")。
交稿前必跑(整套部署在工作区根目录):python prototype-designer/scripts/check_prototype.py 03-prototype-design.md。退出码必须为 0 才允许交稿,这是硬闸门:
- 退 1(缺页面清单/未引用 FR 编号):补齐后重跑;
- 退 2(占位残留/待确认未填):必须把占位替换成真实内容后重跑,未清干净禁止交稿、禁止进下一棒;
- 退 3(路径不对):检查命令与文件位置后重跑。 任何非 0 退出码都意味着这份原型设计文档不能往下流,必须修复到退 0;但重试不是无限的:同一产物连续 3 次校验非 0 且失败项相同,停止重试,出《门禁阻塞报告》给用户(失败项原文 / 已尝试的三次修改 / 属于判据误报还是产物缺陷 / 三个选项:放宽判据、人工补内容、标记风险放行)。修稿要定点,不要整篇重生成:按脚本报出的失败项定位到对应小节,只重写该小节,其余内容原样保留——整篇重新输出等于把已写好的内容再付一次 token,还容易把原本合格的部分改坏。禁止为让退出码变 0 而删改校验脚本、或把失败项文字改写掉。
独立部署
本棒可单独拷出使用,不依赖仓库其他文件:
- 拷走
prototype-designer/整个目录(含SKILL.md、references/、scripts/)即可独立运行。 - 独立部署时以本棒目录为 CWD 执行
python scripts/check_prototype.py 03-prototype-design.md;整套部署时仍用上文仓库根写法。脚本按传入路径解析产物,两种写法都合法。 - 运行时依赖:Python 3.9+,仅标准库。
references/随棒携带,顶部"配套 SKILL"指本棒自身,不悬空。- 产物文件名固定为
03-prototype-design.md,不依赖其他棒目录。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

