使用 Cursor 规则文件清理 AI 生成的遗留代码
TuBrief 편집팀
2026년 8월 25일
0
Computing/Software원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
커뮤니티의 다른 글
댓글 (0)
Log in to leave a comment
아직 작성된 글이 없습니다
원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
Log in to leave a comment
아직 작성된 글이 없습니다
AI 编写的代码很容易聚合成单个脚本。随着庞大的单体对象模式的创建，原有的结构遭到破坏。这就是 3 到 7 年经验的开发人员每周花长达 8 小时在调试上的原因。因为他们跳过了重构，并不断往上堆砌代码。
在项目根目录下创建 .cursor/rules 目录，并放入 .mdc 规则文件。在核心架构指南文件中开启 alwaysApply: true 选项。将依赖方向固定为 Presentation -> Application -> Domain -> Infrastructure 的顺序。限制文件长度不得超过 150 行。
修复已经纠缠不清的组件时，按顺序输入三个提示词。首先，分析遗留代码以提取类型。接下来，用 100 行左右的自定义 Hook 剥离业务逻辑。最后，结合 Vitest 和 MSW 提取单元测试代码。经历这个过程后，调试时间将降至每周 3 小时以下。
仅靠 TypeScript 编译器无法捕获 AI 抛出的 API 响应错误或条件逻辑错误。必须在运行时边界处严格锁死类型。使用 Zod 和 Effect 库创建架构层。Zod 负责外部 API 验证，Effect 管理内部域逻辑。
必须搭好框架，让 AI 优先声明 Zod 架构。让 AI 先编写用于验证用户资料更新 API 输入值的 Zod 架构。接着要求其实现接收该架构和类型并更新数据库的服务函数。结合在验证失败时抛出 400 错误的解析逻辑。
将 Dependency Cruiser 连接到 CI 管道，阻止错误代码进入主分支。在 .dependency-cruiser.cjs 配置文件中写入禁止循环依赖和层违规的规则。将 npx depcruise --config .dependency-cruiser.cjs src 命令固化到 GitHub Actions 中。在 Pull Request 阶段自动过滤架构违规代码。
由于训练数据的局限性，AI 在使用 Svelte 5 或 Next.js 14 等最新框架时，往往会与旧版本语法混用。这是导致构建错误的主要原因。必须将官方文档的核心迁移指南压缩并塞入上下文中。
需要在项目内部单独开辟一个用于最新技术规范的文档存储库。在项目根目录下创建一个 .docs 文件夹，并以 Markdown 格式保存迁移指南。在 .cursorignore 文件中写入 node_modules 和构建文件夹以消除噪音。通过直接指向 @.docs/svelte5-migration.md 文档的提示词来引导编写最新语法的代码。排查旧版本语法错误的时间将不复存在。