AI 编程工具接入本地项目的检查清单

把 AI 编程工具接入项目之前，先确认项目可以在本机稳定运行。依赖安装、环境变量、数据库、缓存、构建命令和测试命令都应有明确记录。如果人都无法稳定跑通，Agent 更难判断失败来自代码还是环境。

实践要点

第二步是整理项目边界：哪些目录可以修改，哪些配置不能动，哪些命令有破坏性，哪些测试必须通过。建议把常用命令写进 README 或项目说明里，让 Agent 每次都能读取同一套事实来源。

第三步是权限与成本控制。API Key 不要写进仓库，生产配置不要暴露给工具，长任务要明确停止条件。对于大型仓库，可以先让工具分析小范围模块，再逐步扩大到跨模块修改。

后续内容

这是一篇种子文章，后续会围绕“AI 编程工具接入本地项目的检查清单”补充更完整的操作截图、命令、配置示例和问题排查记录。