Brief Me
让 AI 先组织好复杂度,再回来汇报。用户应当顺着一条清楚的主线看懂局面、看见关键关系,并在理解之后方便地表达判断。
成功是一段连续的体验:知道要判断什么 → 看懂理由与关系 → 追问必要依据 → 表达自己的意见 → 带着反馈继续对话。 页面形式由当前任务决定。
先形成可以讲给人听的判断
从已有材料恢复受众、当前问题、约束和本次希望获得的回应。只追问会实质改变交付且无法从材料恢复的缺口。材料杂乱或判断任务隐含时,读取 decision-context.md;这些背景用于内部理解。
在画页面或列组件前,先用连贯的自然语言把事情讲通:发生了什么,为什么影响当前判断,材料支持怎样的建议或取舍,还有什么条件会改变它。用户要自行判断时,以关键差异为主线;需要建议时,给出建议与成立条件。
这段综合是 Agent 的工作底稿,足够指导制作即可,不新增用户审批步骤。检查理由是否真正支持主张、建议是否回应发现。一个响亮标题加一串分类标签,还没有完成综合。
把主线变成可见、可回应的体验
设计时读取 briefing-design.md,其中包含两组虚构材料的正反示例。根据当前问题选择阅读路径、视觉和用户动作,再选择所需的前端、可视化或其他辅助能力;不固定依赖外部 Skill。
- 保持判断的完整性。 围绕当前问题连接发现、证据、影响和回应。标题、短段、图与必要对照各司其职;把内部分析字段留在后台,让读者能连续理解论证。
- 把关键关系画出来。 用空间、连接、尺度、对齐或变化表达至少一项决定性关系。层级帮助找到重点,图形帮助理解结构;有必要画清的依赖、因果或取舍时,排版整齐仍不够。
- 在理解发生的位置参与。 让用户在看过相关分析后就能比较、追问或留下判断。提供预设之外的自由意见入口,反馈能复制或导出。筛选、滑块、目标切换等只在当前任务需要时加入。
- 按需深入。 主阅读层保留判断所需的关键依据与限制,完整来源、历史和逐项材料按需展开。多个关联问题先交代关系,再按用户理解的顺序展开。
默认交付可直接打开、便于分享的自包含 HTML;确有需要才采用小型静态项目。保持跨宿主可用,不强制某种图表、框架、页数或组件。
保持反馈与事实一致
数字保留来源、时间、单位和口径;推断、假设和未知在影响判断的位置说明。材料不足时讲清能判断到哪里,不扩张成未经请求的研究。
只对现有数据支持的确定性逻辑进行页面内重算。条件变化后同步相关数字、结论、理由与反馈。新文字需要 AI 重新理解时,保留用户输入,标明哪些判断需要回到对话重审;页面不伪造新分析。
复制或导出的反馈保留实际发生的选择、条件、自由意见和待重审部分。默认说明“复制后粘贴回 Agent 继续讨论”;只有真实接入并验证过发送通道,才能声称已交给 AI。页面选择属于讨论反馈,执行、发送、发布和写回仍需相应授权。
用真实阅读与操作验收
打开实际页面,依次检查下列结果;修复后只复查受影响部分。
- 能讲通。 从首屏开始读主线,能说清本次问题、主要判断和理由。需要反复跳转栏目才能连起来时,先重组论述,再调整版式。
- 能看懂关系。 指出一项具体关系,以及图形如何帮助理解它。做删除测试:删去视觉后,若理解同样容易,就换一种表达或删去装饰。
- 能就地回应。 实际比较或追问一次,再输入预设之外的意见。确认用户不必离开相关分析很远才能回应。
- 能接着工作。 实际复制或导出,回读内容;确认选择、条件和自由意见完整且一致。复制受限时提供可手动复制的文本,不能假报成功。
- 能正常使用。 检查窄屏、键盘路径和核心状态;信息有明确阅读次序,操作可识别,减少动态效果设置得到尊重。
窄屏不是把桌面版缩小:在实际视口检查 document.documentElement.scrollWidth <= innerWidth,给网格子项和面板设置 min-width: 0,让长标签换行;路线、表格或对照内容需要横向阅读时,只让局部容器滚动,不让整页被撑宽。
结构检查、功能检查和体验判断分别说明。字段齐全、图形存在、按钮可点,只证明对应部分;整体理解仍困难时,继续修复主线、关系表达或回应位置。
交付时给出产物入口、实际走查结果及仍影响使用的限制。没有真实判断任务时直接说明不适用;不强行生成决策界面。