第8章 Agent 缺失的设计词汇
第8章:Agent 缺失的设计词汇
启动:赋予 Impeccable 项目上下文,以适配你的产品设计。本页共 3 个部分。
大多数 Agent 使用 /impeccable。在 Codex 中,请运行 $impeccable。
首次在项目配置 Impeccable,或当重要产品上下文发生变更时,运行 init。它会将产品服务对象、用户核心需求以及后续开发需保留的特性保存至 PRODUCT.md。
缺失或模糊的上下文会导致结果平庸。完善的产品档案能帮助 Impeccable 代表用户做出决策,包含那些无法单从代码中推导出的细节。
试一试
/impeccable init
Impeccable 会优先读取项目。你只需填补空缺并确认其推断结果,无需提前准备设计简报。
工作原理
- 读取项目:在提问前,先审视产品文档、功能、代码及现有资产。
- 确认核心要素:询问受众、其具体处境、产品目的及重要约束。将相关性问题归组。
- 保存上下文:将确认的事实写入
PRODUCT.md,并明确标记未决事项。 - 准备下一步:记录相关的工作流偏好,在适用时配置 Live Mode,并建议合适的起点。
PRODUCT.md 示例摘录
| 受众 | 咖啡馆经理,常在轮班间隙补货,通常使用手机操作。 |
| 目的 | 帮助他们复购常规订单、调整数量,并查看到货时间。 |
| 约束 | 配送日期取决于所选供应商。结账前需展示具体日期。 |
| 现有依据 | 已有产品照片和供应商排班表。尚无用户评价。 |
具体上下文决定了设计简报:熟悉的商品、快速的数量调整、可查询的配送日期。这是一个虚构示例,非必需的文件模板。
产品上下文与视觉设计是分离的。init 记录产品需求及现有的品牌承诺,不会选择新的调色板或撰写 DESIGN.md。使用 document 记录现有视觉系统,或描述你想构建的内容以开始新的设计工作。
除 PRODUCT.md 外,设置还改变了什么?
若图像生成功用可用,Impeccable 可能会询问新设计工作是应先从视觉原型开始,还是直接写代码。这将设定项目默认值;你可在设计选择器中针对特定会话切换。比较“原型优先”(comp-led)与“直接构建”(code-led)。如需使用原型功能,需通过编程工具或 OpenAI API 密钥启用图像生成。
对于现有的可运行 Web 项目,init 还可以为 Live Mode 准备配置。现有配置将被保留。原生应用及尚未可运行的项目将跳过此步骤。
检查结果
阅读 PRODUCT.md。纠正 Impeccable 误解之处,确保不确定事实仍标记为待定。明确陈述缺失的依据,以便后续工作知晓可用的资源。
若文件已存在,使用变更后的内容重新运行 init。它应更新上下文,而不重新打开已决事项。你也可直接手动编辑该文件。
接下来,使用 shape 进行规划,使用 critique 审查现有页面,或使用 Live Mode 直观探索变更。关于项目文件如何协同工作,请参见“上下文文件”。