与 AI 开发工具协作：从需求到验收

先说明用户希望发生什么

开发需求应从用户动作和结果开始。例如「在工具页搜索名称，列表只显示匹配工具，找不到时提供重置入口」。这比「加一个智能搜索模块」更容易实现和检查。

本篇是一套通用协作方法，不要求自动执行工具输出的命令。具体代码与操作应结合实际项目审查。

在修改之前建立项目上下文

让工具先阅读品牌、产品、交互与开发约定。说明当前页面、已有组件、允许修改的范围，以及必须保留的行为。EXVEIL 的四份项目文件就是这样的上下文入口。

请先阅读项目约定，再完成：[用户动作与预期结果]。修改范围：[页面或模块]。保留：[已有视觉与行为]。边界：[本次不扩展的功能]。验收：[可以实际检查的步骤]。先检查现有实现，复用已有组件；如需求与项目约定冲突，请指出冲突，不要自行改产品方向。

把验收写成实际步骤

不要只以「代码没有报错」判断完成。以搜索为例，至少检查正常结果、空结果、清空条件和手机布局。

1. 打开工具库，确认默认内容可见。
2. 输入已有工具名称，确认只显示匹配结果。
3. 输入不存在的关键词，确认出现可理解的空状态。
4. 重置条件，确认完整列表恢复。
5. 在手机宽度检查控件、文字和页面溢出。

阅读修改，而不只接受总结

出现问题时，提供观察证据

记录操作、预期、实际结果与环境。例如「360px 宽度下工具名称挤出卡片」比「手机不好看」更有帮助。反馈不必包含所有实现细节，但应让问题能够重现。

Cursor面向软件开发的 AI 工具，从理解项目到修改代码，保留可审查的工作过程。↗

把完成条件带回产品目标

最后再次检查：新功能有没有帮助用户更容易完成任务？如果只是增加配置与点击，应考虑简化。阅读EXVEIL 首页制作过程，查看视觉、代码与验证如何共同构成可交付页面。