用 AI 生成交互说明文档，最有效的输入是具体页面、已确认的业务规则和异常情况，而不只是一句“帮我写交互说明”。先让 AI 列出页面里的操作，再逐项补成“什么条件下触发、数据和界面怎样变化、失败后如何继续”的说明表。这样得到的文档才能回答研发关心的实现问题，也能让测试直接拆出用例。
如果原型和文档需要一起修改，可以用墨刀 AI 的方案撰写与原型能力整理初稿，再把文档中的页面编号对应到原型。本篇沿用一个电商 App 首页，完整写清搜索、轮播图、商品详情和加入购物车；你可以替换商品与规则，直接使用下面的提示词和说明表。
交互说明要写到什么程度？让下一步不靠猜
“点击加入购物车，提示添加成功”还不够。商品有多个规格时先选哪个？未登录是否允许添加？按钮连点两次会不会加两件？库存刚好售罄时页面怎么办？这些差异会改变实现和测试范围，不能靠按钮旁边的一句描述带过去。
一条可用的说明至少包括：定位、触发条件、业务判断、界面反馈和后续去向。只有涉及数据读写时，才补充数据变化、重复请求和失败恢复。交互说明不必复制整份 PRD；价格计算、优惠叠加等已有规则，可以引用对应规则编号，避免两处越改越不一致。概念和文档结构可进一步参考交互说明文档的写法。
先准备这一页的材料：截图、编号和规则
本例首页记为 H01，包含搜索框、活动轮播图、推荐商品卡片、加入购物车按钮和底部购物车入口。先给原型中的页面命名，再截取默认、空结果、缺货等已有状态；截图里没有展示的规则，用文字单独补充。
| 材料 | 本例内容 | AI 应如何使用 |
|---|---|---|
| 页面目录 | H01 首页；SR01 搜索结果；D01 商品详情；C01 购物车；L01 登录；SK01 规格弹层 | 说明跳转时使用页面编号，不写含糊的“跳到下一页” |
| 页面截图 | H01 默认页、商品缺货态、SK01 规格弹层 | 识别可见控件、文案和相对位置，不推断隐藏业务规则 |
| 规则 R01 | 浏览和搜索无需登录；加购及查看账户购物车需登录。加购中登录成功返回原操作位置，不自动代为添加 | 区分浏览权限与账户操作，明确登录后的动作 |
| 规则 R02 | 多规格商品先选规格；单规格商品默认添加 1 件；购物车角标显示商品总件数 | 不要把“商品种类数”和“总件数”混用 |
| 规则 R03 | 空搜索不提交；去除首尾空格后搜索；无匹配结果保留关键词 | 覆盖空值、有效提交与空结果 |
| 待确认项 | 活动失效时的落地页、单次购买上限、库存变化接口约定 | 列为问题，不自行给出最终规则 |
例如截图只显示购物车角标“3”，不能据此推断它代表三类商品还是三件商品。把 R02 写进输入，AI 才有依据选择文档中的用词。接口路径、错误码和超时秒数同样应来自研发约定，不要让模型补一个看起来合理的值。
已经有墨刀原型，如何减少重复整理？
可以先按Codex 读取墨刀原型的步骤获取页面目录和目标画布的结构信息，再把实际读取结果与业务规则交给 AI 整理。页面读取能帮助定位控件与已有交互，不能替代需求方确认库存、权限或支付规则；没有出现在读取结果中的功能，也不要在文档里写成“原型已经支持”。
在墨刀 AI 中生成第一版：先列操作，再展开状态
1. 进入方案撰写，先提交范围
在墨刀 AI 中进入方案撰写，输入页面范围和已有资料。若材料较多，先发送页面目录与规则，再补截图，避免把无关页面、历史需求和本次变更混在一条指令里。
先用一轮指令检查范围，比直接要求生成长文更容易发现遗漏：
根据我提供的 H01 电商首页截图、页面目录和 R01—R03 规则，先列出全部可操作元素。
每项只写：控件名称、所在区域、触发方式、已有依据、还缺什么信息。
将“截图可见”“规则明确”“待确认”分开。
不要自行增加优惠券、支付、推荐算法等本次未提供的功能。
先给操作清单，不要直接生成整篇文档。这一轮重点看有没有漏掉商品卡片和“加入购物车”按钮的区别：点击卡片进入详情，点击按钮则执行加购路径。若把整个商品卡片只算成一个操作，后面的表格也会漏掉规格选择和登录分支。
2. 用完整规则生成交互说明表
确认清单后，把下面的任务与前面的规则一起发送。输出列控制在必要范围内，复杂分支拆成独立行，比把一整套流程塞进一个单元格更便于评审。
为 H01 电商 App 首页编写交互说明。
读者：研发和测试。沿用刚才确认的操作清单及 R01—R03，不改变业务规则。
页面编号：H01 首页、SR01 搜索结果、D01 商品详情、C01 购物车、L01 登录、SK01 规格弹层。
输出列：事件编号、触发与前置条件、处理规则、界面反馈与去向、测试关注点。
分别写搜索空值/正常提交/无结果；轮播图跳转；商品详情；未登录加购；多规格选择；提交中；成功；库存不足；请求结果未知；购物车入口。
提交中禁止再次发送同一加购操作。库存校验失败不增加角标。
网络异常若无法确定是否已写入，不显示“添加成功”，也不直接允许反复重试；先提示检查购物车。
未提供的接口、限制数值与活动失效策略放入“待确认问题”，每项说明影响哪一行。
不写产品介绍，不承诺生成速度，不重复业务背景。
可直接改用的电商首页交互说明表
下面按上述规则整理出一份示例文档。它采用“一个关键分支一行”的写法：开发可以按事件定位实现，测试可以把最后一列扩成用例。页面编号、按钮文案和规则应随你自己的原型同步替换。
| 事件 | 触发与前置条件 | 处理规则 | 反馈与去向 | 测试关注点 |
|---|---|---|---|---|
| E01 空搜索 | H01 点击搜索，输入为空或仅空格 | 不发起搜索请求 | 停留 H01，输入框提示“请输入搜索内容” | 全空格也按空输入处理 |
| E02 搜索提交 | 输入有效关键词并提交 | 去除首尾空格，传递关键词 | 进入 SR01，展示加载状态；结果返回后显示列表 | 搜索词在结果页保留，不擅自删掉词中间的空格 |
| E03 无结果 | SR01 返回空列表 | 保持当前关键词，允许修改后再次搜索 | 显示“未找到相关商品”，不显示网络错误 | 区分空结果与请求失败 |
| E04 活动跳转 | H01 点击有效轮播图 | 按该活动配置进入目标页面 | 展示对应活动；失效活动策略待确认 | 不得由 AI 自行补成外部网页或优惠领取页 |
| E05 商品详情 | 点击商品图片或标题 | 传递被点击商品的标识 | 进入 D01；返回后保留首页已浏览位置 | 点击加购按钮不能同时触发详情跳转 |
| E06 未登录加购 | 未登录，点击加入购物车 | 先登录；不发送加购请求 | 进入 L01，成功后返回 H01 原位置；由用户再次确认加购 | 取消登录仍回首页，不改变角标 |
| E07 选择规格 | 已登录，商品有多个规格 | 打开 SK01；有效规格选齐后才能确认 | 展示所选规格与库存状态；取消不修改购物车 | 缺货规格不可提交，未选齐有明确提示 |
| E08 提交中 | 已登录，单规格商品或已选有效规格 | 提交 1 件；同一操作未返回前禁止重复发送 | 按钮显示“添加中”，保留当前位置 | 连续点击不会产生多个相同请求 |
| E09 添加成功 | 服务端确认成功 | 以返回的购物车总件数更新角标 | 提示“已加入购物车”，恢复可操作状态，留在当前页面 | 失败响应不得增加角标；不要把总件数写成商品种类数 |
| E10 库存不足 | 提交后收到库存不足结果 | 不增加数量，按最新库存更新商品状态 | 提示“库存已变化，请重新选择”；多规格商品回到选择状态 | 不继续显示“添加成功”，保留用户上下文 |
| E11 结果未知 | 请求中断，无法确定写入结果 | 进入待核对状态；先检查购物车是否已有该次添加结果 | 提示“添加结果待确认，请查看购物车”，提供 C01 入口 | 不把未知当失败后直接重发；恢复方式与研发确认 |
| E12 购物车入口 | 点击底部购物车 | 按当前账号读取购物车；未登录先按 R01 登录 | 进入 C01；空购物车显示空状态与返回逛逛入口 | 空状态、加载失败、正常列表分别展示 |
“结果未知”值得单独保留：请求没有返回，不代表服务端一定没加成功。仅靠前端禁用按钮只能减少连点，不能解决重试后的重复写入。评审时应让研发确认如何识别同一次操作、如何读取最新购物车结果；确认后再把具体处理写回 E11。
生成后怎样修改？对照一个事件补缺口
不要只对 AI 说“再完善一下”。假设第一稿把 E06 写成“登录后自动加入购物车”，它就与 R01 冲突。指出冲突和允许修改的范围，能减少其他已确认行被一起改动。
检查 E06：规则 R01 明确“登录成功返回原操作位置，不自动代为添加”。
请仅修正 E06 及与之直接相关的测试关注点。
保留其他事件编号、页面编号和规则。
同时列出修正前后的差异；如果发现与 E07/E08 有冲突，提出问题，不自行修改加购策略。第二轮再检查异步状态。把“正常成功”“明确失败”“结果未知”分开，让 AI 逐条检查加载提示、按钮恢复、输入保留和下一步入口。对于搜索失败，应允许保留关键词后重试；对于加购结果未知，直接重试却可能重复添加。相同的“网络错误”提示不能套用同一恢复动作。
交给研发和测试时，把原型、文档和变更连起来
交付时提供同一版原型链接、说明表和待确认问题。文档开头写清适用页面与版本，例如“首页 H01，规则版本 R1.2”；原型中的对应说明也使用 E01—E12，评论“E10 库存更新后如何回到规格选择”比“这里不太对”更容易处理。
待确认项不要混在正文里装成已定方案。本例可保留三项：活动失效如何展示、商品购买数量限制、加购结果未知如何核对。分别标记它们影响的事件、负责确认的人和结论。结论确定后更新原行，并在变更记录中写明“E06 登录后自动添加改为用户再次确认”等具体变化。
测试可以从表中先拆一条完整路径：未登录点击加购 → 完成登录 → 返回首页 → 选择规格 → 提交中 → 添加成功 → 购物车显示正确件数。再替换其中一个条件测试取消登录、无库存和网络中断。后续需要扩展测试材料时，可继续阅读AI 生成测试用例的方法。
现在可以选你项目里最容易被反复追问的一页，把截图、页面编号和规则交给墨刀 AI 整理。先完成这页的说明与评审，再沿用已确认的写法扩展其他页面，文档会更容易维护。
