怎么让原型替你标出需求
给和 Claude 一起做原型的产品同学。不讲组件是什么,只讲——你该怎么说,它才会在那个地方替你标。
看法很简单:每个食谱左边是你想要的效果,中间是你照着说的话(可复制),右边是它产出的样子(能点的真能点)。
① 让某个改动点旁出现"能点开的需求标签"
需求标签 / 需求便签 = 贴在改动元素旁、点一下弹出需求说明、说明文字能复制的小徽标。只要标在原型改动点旁,它默认就是可点开的——你不用特别说"要能点开"。你交代清三件事就行:标在哪、什么改动、说明写什么。
效果:在「厂商版本」字段旁,挂一个能点开的修改需求标签
你这样说
「在核查项管理页的「厂商版本」字段旁加个需求标签,改动类型修改,说明写:把厂商版本合并字典拆成厂商、版本两个字段,版本随厂商级联,方便下游分别选。」
它产出(点徽标试试)
厂商版本
v0.3.3 修改 !
改动说明
厂商版本合并字典拆成厂商、版本两个字段,版本随厂商级联,下游可分别选。
带「!」= 能点开;点开里面的字可选中复制。
可不可点,由位置决定,不用你指定:标在原型改动点旁 → 默认就是可点开的需求标签(带「!」);标在原型说明里 → 默认是静态徽标(见下条)。
② 只想在原型说明里标一下(不用能点)
标在原型说明里(页面底部"原型设计说明"、字段规格表)的徽标,默认就是静态的——同样三色,但不带「!」、点不开,因为说明文字本来就写在旁边,不用再点开看。
效果:在该页原型说明里,静态标一条修改
你这样说
「这条在该页原型说明里标一下:厂商版本拆为厂商 + 版本两字段。」
它产出
v0.3.3 修改
厂商版本拆为厂商 + 版本两字段,版本随厂商级联。
无「!」= 纯标识,旁边就有字,不用点。
一句话区分,看你标在哪:原型改动点旁 → 可点的需求标签;原型说明里 → 不可点的静态徽标。你只管说位置,点不点它自动跟着走。
③ 指定是新增、修改、还是删除
你说哪个类型,它就用哪个颜色和措辞——词固定为"新增 / 修改 / 删除"。修改和删除还会把旧内容用删除线保留,让人看出改动前后。
| 你说 | 它产出 |
|---|---|
| 「这是新增字段:适用版本」 | 适用版本(随厂商级联) v0.3.3 新增 |
| 「这是修改,原来叫厂商版本」 | |
| 「这条删除:视图类型」 |
不用记颜色,直接说类型词即可。徽标会自动带上当前版本号(下一节讲版本号怎么定)。
④ 每个版本号什么意思,你什么时候让它用哪个
版本号跟着原型给谁看走。你只要告诉它现在到哪个阶段了,它就用对应版本号挂徽标。
| 版本号 | 意思 | 你这样说(触发) |
|---|---|---|
v0.1 | 自己内部画,还没发给别人 | 「现在还在内部做原型」→ 全新页不标、只标改的旧内容 |
v0.2 | 已发给产品以外的人;评审通过前一直 v0.2 | 「这版要发给研发 / 评审了,定到 v0.2」→ 之后改动都用删除线保留旧的 |
v0.3.0、v0.3.1… | 设计评审通过后进入 | 「评审通过了,从现在走 v0.3.0」 |
升不升号看一句话:「这次改完我已经通知研发了」→ 升一位(v0.3.0→v0.3.1);没通知、还在自己打磨 → 说「先并进当前版本,别升号」。
⑤ 让它把这次改动记进 index 版本变更记录
改动点旁标完,还要在首页 index 的「版本变更记录」表里登记一行,评审 / 研发从首页就能看到本版动了什么。你交代版本号、涉及哪页、类型、摘要,它就加一行(最新的排最上面)。
效果:在 index 版本记录顶部加一行
你这样说
「在 index 版本变更记录加一行:v0.3.3,涉及核查项管理页,类型修改,摘要:厂商版本拆分为厂商 + 版本。」
它产出
| 版本号 | 时间 | 类型 | 涉及页面 | 摘要 |
|---|---|---|---|---|
| v0.3.3 | 2026-06-16 | 修改 | 核查项管理 | 厂商版本拆为厂商+版本 |
同一处改动会落在三处、口径一致:① 改动点旁的需求标签 ② 原型说明里的静态徽标 ③ index 这张表登记一行。你说一次,三处它会对齐。
⑥ 变更摘要怎么写(给研发的需求提示,不是给运维的改动清单)
摘要是给评审 / 研发看本版业务上变了什么,不是工程流水账。你说业务话,它就记业务话;你要是报文件改动,它会被淹没。下面是好 / 坏对照,照"好"那栏的口吻说就行。
✓ 这样说(业务 / 原型层)
6 项厂商规则回退到原口径
到期提醒文案细化,带变量和点击链接
批量忽略时顶部展示设备清单
到期提醒文案细化,带变量和点击链接
批量忽略时顶部展示设备清单
✗ 别这样说(工程细节)
index 加 target=_blank
JS 引用 ?v= 破除缓存
文件结构调整 / 某页加了个 span
JS 引用 ?v= 破除缓存
文件结构调整 / 某页加了个 span
一句自检:"这件事能用一句业务话讲清吗?" 能 → 一条摘要;不能 → 拆 2-3 条,但每条都是业务句子。
⑦ 想自己在网页上改这些标注 / 说明?下载「原型编辑器」
前面讲的是让 Claude 替你标。原型出来后,如果你(或不懂技术的同事)想自己直接改需求标签的文字、原型说明——不用回来找 Claude、不用碰代码——用这个小工具:在网页上点开需求便签就能改,改完自动写回原型。
- 双击打开后,浏览器弹出控制页,点「选择原型文件夹」,选中要改的原型目录。
- 新标签进入原型,打开右下角「编辑态」,直接在页面上点开需求便签、改文字(原型说明同理)。
- 改完关掉那个标签即可——改动已自动写回该原型的
data/annotations.js;控制页还留着,可接着选下一个(最近 5 个有历史,可删)。
只有你用编辑器打开(本地 localhost)才可改。发布到内网给评审看、或别人直接双击 HTML,都是只读、看不到编辑入口——不担心改动被别人误碰。
话术模板速查(改改就能用)
| 你想要的 | 照着说 |
|---|---|
| 原型改动点旁标(默认可点) | 在「哪页·哪个字段/按钮」旁加需求标签,类型新增/修改/删除,说明写:需求口径。 |
| 原型说明里标(默认静态) | 这条在该页原型说明里标一下:一句话。 |
| 定阶段版本号 | 现在「内部画 / 发给研发了 / 评审通过了」,用 v0.1 / v0.2 / v0.3.0。 |
| 升版本号 | 这次改完已通知研发,升一位;(或)没通知,先并进当前版本别升。 |
| 记一条版本变更 | 在 index 版本记录加一行:版本号 / 涉及页面 / 类型 / 摘要。 |
| 写好摘要 | 摘要只说业务变化,别写文件 / 参数 / 缓存这类工程细节。 |
本页随 prd2prototype skill 维护;规范以 SKILL.md 为准。这里只讲"怎么开口让它替你标"。