跳到正文
Motux Build
手册目录

适用于已发布的模块化版本。
功能核对：2026-09-13

下载完整手册 .md
使用手册

需求梳理与产品决策

从想法到明确的第一版，使用 Brief 一次处理相关问题。

4 项说明

澄清目标与收敛 MVP

决定第一版必须做什么，以及暂时不做什么。

能帮你完成什么

Agent 先确认主要用户、真实问题和可观察结果，再梳理最短完整业务流程。收敛不是只删除功能：必要的失败提示、权限、数据完整性与恢复也属于可用的第一版。你会得到范围及重新考虑延期需求的条件。

使用前

提供现有想法、用户反馈或已确认约束；没有成熟 PRD 也可以开始。

怎么使用

  1. 描述谁在什么场景遇到问题，避免只列页面名称。
  2. 让 Agent 给选项、取舍和推荐，集中确认高影响决定。
  3. 确认第一版流程、验收标准、非目标和后续进入条件，再推进实现。

试着这样对 Agent 说

我想做一个内部报修工具。先帮我确定主要使用者、一次报修到确认修复的最小流程和第一版范围；把可以延期的功能与重新纳入条件写清楚。

如何判断完成

  • 清楚的用户任务、MVP 范围和验收条件。
  • PRD、用户路径或开放问题记录只更新已确认部分。

适用边界

  • 产品探索可以全面，第一版实现不因此包含所有被讨论功能。
  • 没有解决互相矛盾的目标时，先确认分歧再继续。

全面产品问卷

把新产品的大量相关问题整理成分组表单。

能帮你完成什么

Motux Brief 根据当前项目资料动态设计问题，不套固定问卷。适用于新产品、重大重新定位或需求尚不清楚的阶段，通常 20–60 题、4–10 个主题，复杂情况最多 100 题。每题说明为什么现在要问、选项差异及推荐理由。

使用前

让 Agent 读取已有产品资料和先前 Brief，避免重复询问已确认事实。生成器需要 Python，填写需要浏览器。

怎么使用

  1. 说明希望全面梳理的产品，并请求 comprehensive 模式。
  2. Agent 生成 question-set 和本地 motux-brief-form.html。
  3. 逐主题填写，可选预设项或“其他”；没答完也能保存进度。

试着这样对 Agent 说

请为这个内部报修产品生成全面的 Motux Brief。先读已有资料，按用户、核心流程、权限、通知、异常和上线范围分组，解释各选项的取舍。

如何判断完成

  • 本地可填写表单，而不是长串逐条聊天提问。
  • 每题有原因、2–4 个具体选项、推荐和自定义答案入口。

适用边界

  • 推荐不会预先替你选中；未填写的题目不能当作已同意。
  • 不要把密码、客户数据或服务器凭据写进答案。

聚焦决策表单

只解决当前阶段的一组关键选择。

能帮你完成什么

产品方向已确定，但某个模块仍有几个相互关联的取舍时，Brief 使用 focused 模式，常见为 3–10 题。它帮助你一次看完成本、体验、依赖和后续影响，不为小改动生成大问卷。

使用前

提供已确认决定和这次需要解决的边界；简单确定性实现一般无需表单。

怎么使用

  1. 明确当前阶段，例如通知渠道或界面导航。
  2. 要求保留已确认产品范围，只问会影响本阶段的选择。
  3. 保存为新的主题 JSON，确认决定后推进对应模块。

试着这样对 Agent 说

报修流程已经确定。请做一份聚焦 Brief，只比较第一版通知采用站内消息、邮件还是二者组合，考虑用户体验、成本和失败处理。

如何判断完成

  • 问题数量与当前决策规模相称。
  • 已有答案和早期决定不会被新问卷默认覆盖。

适用边界

  • 如果你明确要求全面探索，已有文档不意味着必须缩成 focused。

保存、继续填写与落地决策

让表单答案成为项目中可读取的决定记录。

能帮你完成什么

表单的“保存到项目”允许你在浏览器中选择一次项目根目录，然后写入页面显示的 JSON 位置。不支持目录写入的浏览器可以下载 JSON，再放到指定位置。Agent 读取完成状态和自定义答案后，检查冲突，再更新受影响的产品文档。

使用前

已生成当前表单。首次 Brief 使用未占用的 motux-brief.json；后续阶段使用新的主题文件名。

怎么使用

  1. 填写后点击保存到项目，在系统目录选择器里核对目标。
  2. 若使用下载方式，将 JSON 放到页面指定位置，再告诉 Agent 已保存。
  3. 让 Agent 读取 status、completion、answers，补齐剩余问题并确认冲突；之后更新 PRD、流程或计划。

试着这样对 Agent 说

我已保存 docs/product/motux-brief-notifications.json。请读取答案，保留已确认决定，指出未完成或互相矛盾之处；确认后只更新受影响的通知方案。

如何判断完成

  • JSON 标明完成或进行中；自定义答案优先于预设推荐。
  • 相关文档可追溯到本次决定，旧阶段记录得到保留。

适用边界

  • 新生成的表单不会自动载入旧答案；首次保存遇到同名文件会要求单独确认覆盖。
  • 浏览器页面不能自行得知系统目录的完整路径，请以目录选择器为准。