交互描述助手
文档管理
继续使用 discuss-requirements 创建的需求文档。
追加记录
- •读取当前需求文档（
docs/requirements/YYYY-MM-DD-<主题>-需求.md） - •追加交互细节到"确认的需求点"部分
- •更新"讨论进度"为"交互设计"
记录时机
在以下步骤后自动记录：
- •Step 2: 核心交互描述完成后
- •Step 4: 示例描述完成后
使用场景
需求明确后，需要描述交互细节时使用。
工作流程
Step 1: 确认时机
确保需求已经明确：
- •核心功能已确定
- •用户流程已清晰
- •不需要再讨论"做什么"
Step 2: 描述核心交互
只描述 MVP 必须的交互，不要过度设计：
必须描述：
- •加载状态：数据加载时显示什么？
- •操作反馈：用户操作后有什么提示？
- •空状态：没有数据时显示什么？
- •确认对话框：危险操作需要确认吗？
可选描述（MVP 后）：
- •动画细节
- •hover 效果
- •微交互
Step 3: 模板
使用以下模板：
markdown
## 交互：页面/组件名称 ### 加载状态 - 初始加载：显示骨架屏 - 加载时间 > 1s：显示加载提示 ### 用户操作 - 点击 X：弹出 Y / 跳转 Z - 提交成功：提示成功，1 秒后消失 - 提交失败：Modal 显示错误信息 ### 空状态 - 无数据时：显示"暂无数据" + 新建按钮 ### 确认对话框 - 删除操作：弹出确认框，确认后删除
Step 4: 示例
用户列表页：
markdown
## 交互：用户列表页 ### 加载状态 - 表格显示骨架屏 ### 用户操作 - 点击"新建"：弹出 Modal 表单 - 点击表格行编辑：弹出 Modal 表单（填充数据） - 点击删除：弹出确认框，确认后删除并刷新 ### 反馈 - 成功：Toast 绿色提示 - 失败：Modal 红色错误提示 ### 空状态 - 无用户：显示"暂无用户" + "新建用户"按钮
用户表单：
markdown
## 交互：用户表单 Modal ### 打开方式 - 点击新建/编辑：Modal 从上方滑入 ### 表单验证 - 实时验证：输入后 500ms 验证 - 错误：边框变红 + 错误提示 - 正确：边框变绿 + 对勾图标 ### 提交 - 点击提交：验证所有字段 - 有错误：第一个错误字段获得焦点 - 成功：Toast 提示 + 关闭 Modal + 刷新列表 ### 关闭 - 点击遮罩：关闭 Modal - 点击取消：关闭 Modal - 关闭时：清空表单数据
重要原则
- •MVP 优先：只描述核心交互
- •先功能后美化：先保证能用，再优化体验
- •具体明确："显示提示" → "Toast 绿色提示，顶部显示，1 秒后消失"
产出
- •交互描述文档
- •供 AI 生成代码使用