写出有效的 brief

项目里的每一轮都从 composer 开始——项目屏幕底部的输入框(新项目 则是主屏幕上的那个)。你往里写什么,比任何设置都更能决定这次 run: 本页讲它的控件,以及如何给 agent 写出好 brief。

composer——输入框、agent 芯片、effort、quality 模式和 Send 按钮

控件

  • Input ——brief 本体。每轮一条消息;Enter 发送,Shift+Enter 换行。
  • Agent chip ——这一轮跑在哪个 CLI 和模型上(Claude Code · Default)。点击可按 run 切换 agent 或模型。
  • Effort ——agent 在问题上用多大力气;迭代用 Fast,打磨用更高档。
  • Quality mode ——Fast、Reviewed 或 Council ——结果 落地前怎么检查(见质量模式)。
  • Attach ——把文件或视频参考放进这一轮(见 附件与视频参考)。
  • History ——恢复项目的更早状态(见 历史与恢复)。
  • Send ——启动这一轮;agent 工作期间它会变成忙碌状态。

brief 的解剖

好 brief 承载三样东西,通常一两句话就够:

  1. 它是什么 ——"一个落地页"、"定价区块"、"一个空状态"
  2. 为谁/为什么做 ——"给一个咖啡订阅"、"给首次使用的用户"
  3. 感觉 ——"深色、编辑风、自信的字体排印"、"安静、有高级感"

规格书式的细节(精确像素、精确色值)留给设计系统——那些决定归它管, 逐条覆盖的结果往往比一致地应用一个清晰方向更差。

后续追加是 steering,不是重启

第一轮之后,composer 是一场对话。每次追加就地编辑同一批文件—— "把主图换成产品照"或"让导航感觉轻一点"——所以你在打磨而不是 重新生成。如果要完全不同的方向,就分叉一个 version 或跑 variants。

Tip: 修复针对某个具体元素时,别描述它——pin 它。在预览里 ⌥-click 那个元素,评论会附着到确切的节点上。见 点选、评论与圈画。

pin、评论和参考随行的方式

你用 ⌥-click 放的评论、Designer Talk 笔记和附加文件会自动 折进下一份 brief——agent 在上下文里看到 steering,而不是一条孤立 指令。修复落地后就 resolve 或清掉 pin,免得下一轮还在读过期的 笔记。

相关阅读