AI 代码调试与 Rules 约束指南

AI 代码调试与 Rules 约束指南

在开发过程中，遇到 Bug 是家常便饭。如果只是截图或者在 Chat 里面抱怨“我的代码报错了，怎么修？”，AI 往往无法定位错误，甚至会胡乱改写其他正常的文件，导致项目“越修越错”。

高效的 AI 调试 Prompt 应该包含以下三要素：

1. 完整报错信息：从控制台（Console）复制精确的报错堆栈（Stack Trace）。
2. 当前上下文代码：指出报错发生在哪个文件的哪一行，并把关联的代码片段附上。
3. 防破坏约束：使用 Request 限制 AI 的改动范围（例如：“只修改 utils.js 中的 getFormatDate 函数，禁止修改其他任何逻辑”）。

同时，我们还可以在项目根目录下创建 .rules 文件（例如 .cursorrules 或者是项目的开发守则），对 AI 的技术选型进行强约束，彻底杜绝 AI “胡乱引用”的毛病。

📝 选择题

💡 独立开发实战：阻止 AI 胡乱引入第三方库 在原生小程序开发中，AI 经常会误引入 Web 端的 Node 宿主模块（如 import fs from ‘fs’），导致小程序编译报错无法在手机端运行。要想根治这个问题，最有效率的方案是？

• A. 每次遇到报错就对 AI 说一遍：“不要引入 fs，微信小程序不支持这个库”。
• B. 在项目根目录下新建规则文件（如 .rules），写入：“[Code Style]: We are using native WeChat Mini Program. Do NOT import any Node.js core modules like ‘fs’ or ‘path’ in frontend JS.”
• C. 放弃原生小程序开发，改用复杂的服务器端渲染框架以容忍 fs 的引入。

答案：B（在项目根目录下新建规则文件（如 .rules），写入：“[Code Style]: We are using native WeChat Mini Program. Do NOT import any Node.js core modules like ‘fs’ or ‘path’ in frontend JS.”） 建立 .rules 规则文件可以作为全局“红线”，AI 在每次执行代码生成和修改时都会预先加载这些规则，从源头上遏制了胡乱引包的发生。

一个标准的项目 .rules 文件（规则规范）主要包含三大部分：

• Tech Stack (技术栈说明)：告诉 AI 项目使用的核心框架及版本，避免其使用过时版本。
• Coding Standards (代码编写规范)：例如样式必须使用 Flexbox 布局，颜色必须通过全局 CSS 变量定义等。
• Do Not Do (黑名单)：列出不能干的事情（如“绝对禁止在 App 端直接操作数据库密钥”）。

✏️ 填空题

💡 独立开发实战：安全规则编写 在编写项目的安全规则文件（.rules）时，对于涉及敏感操作的后端代码，我们需要对其位置进行强校验。请填入约束词，确保所有数据库交互操作都必须且只能在服务器端执行：

## Security Rules
Ensure all DB write operations are ___-side only and authorized.

答案：server server (服务端) 才是安全的数据库交互区域。在规则中约束 DB 读写必须在 server-side，可以完全断绝 AI 在客户端直连 DB 的越权设计。