cdsl-cad/AGENTS.md

CAD Agent 运行原则

首要目标

产品的首要目标是稳定、可执行的 CAD 生成流程。任何已经获得可执行检查点的任务，系统都必须发布当前最完整、最可用的 CAD 模型。严格满足全部需求是期望目标，但绝不能因此进入无限修复循环，也不能丢弃本来可用的模型。

必须将以下两类结果严格区分：

• 执行可靠性： 工作流只接收有效协议数据，只调用引擎支持的操作，保留有效工作；只要存在可执行模型，就必须以最佳可用结果终止。
• 需求符合度： 最终模型可能满足全部、部分或不满足用户要求。未满足项必须作为警告和证据报告，不能成为销毁、隐藏可用模型的理由。

职责边界

• 服务端负责校验输出格式、schema、有限数值、操作可用性、selector/reference 有效性、Runtime 安全、持久化和状态转换。
• 服务端不得判断 LLM 是否“正确理解”了用户的设计语义。不得引入基于语义分歧而阻止建模的 reviewer 循环。
• 可以使用工程默认值补全常见但描述不足的零件，但未指定的值不得变成虚构的、严格的确定性验收尺寸。例如，仅因为 verifier 需要数值，不能把未指定的孔径编译成硬性的 1 mm claim。
• 不要求 LLM 输出内部运行时 ID，例如 task、revision、action、candidate、requirement、claim、evidence、source ID。所有这些值由服务端从当前状态生成和绑定。
• LLM 的规划、坐标、宿主面、操作选择或几何策略错误，通常属于模型质量问题，不是程序失败。必须保留诊断，并按下述恢复规则继续。
• schema 无效、引擎不支持的操作、非法状态转换、provider 协议不兼容、持久化失败或 Runtime 崩溃，属于程序、协议或服务问题，必须准确报告。

结果与用户沟通

• 始终保留并暴露最新可执行 STEP、GLB 和渲染工件。
• 完成结果必须区分：已满足目标、未解决目标、因依赖跳过的操作、Runtime/协议故障和 LLM 规划局限。
• 不得把未满足需求声称为已通过；同样不得因仍有未满足需求而隐藏可用模型。
• 需求文档和完成文档是面向用户的工程工件。需求文档可以用已接受的 CAD 默认规则完善描述不足的提示词；完成结果必须描述生成模型实际达成了什么。

改动评审指引

修改本系统时，优先保证执行确定性、部分结果可持久化、失败可诊断，以及终止行为有边界。避免加入语义审查关卡、要求复制 ID 的协议，或会在没有改善可执行模型的情况下无限消耗调用的重试机制。