AI 简明手册
Vibe Coding 与 AI 编程协作 · 环境与安全把环境事实写进 Rule

把环境事实写进 Rule

目标

环境事实要进入每次相关任务的上下文,包括运行命令、技术栈、数据格式和已知交互陷阱。Rule 是一种自动注入方式,但具体配置仍要以所用工具版本和项目事实为准。

操作步骤

  1. 用可版本化规则注入环境事实

    本词条不再重复 Rule 与普通文档的完整比较;核心是把模型端点、超时、代理、流式要求等环境事实写进可版本化且会自动加载的规则,并为网络失败和长任务定义重试与取消策略。

  2. 格式跟随数据消费者

    数据格式要跟消费者走:工具调用采用运行时支持的 schema,对外 API 遵循既有契约,项目配置使用生态最成熟的格式。不要把 XML、YAML、JSON 固定成与场景无关的三分法;应以解析、校验和错误恢复结果决定。

  3. 技术栈锁定是人的决策

    技术栈锁定是项目决策。以一个项目为例,后端、前端和数据库一旦在架构记录中确认,Agent 就不应每轮重新建议替代方案。中文输入场景还要处理输入法组合状态,例如发送前检查 isComposing;这些要求应写成带适用范围的项目规则。

完成检查

  • isComposing 解决的是什么问题: 中文输入法确认候选词时会触发 Enter,如果只判断 e.key === 'Enter' 就会把未完成的拼音当成消息发送。isComposing 在输入法组合中为 true,需要先用它排除这种情况。

  • 工具参数格式应该怎样选: 优先使用运行时原生支持、能做 schema 校验且错误可恢复的格式;再用目标模型和真实样本比较生成稳定性。