写给开发者的修复笔记

记录智能编程工具链、接口配置、错误日志与部署环境中的真实问题，强调复现条件、证据来源和可回溯的修复过程。

我如何让 AI 只改该改的文件

AI Agent 顺手重构、改坏样式或覆盖已有改动时，先收紧文件范围：让它先读再改、禁止任务外重构，并用 diff review 收尾。

当 AI Agent 每次都忘记包管理器、测试命令和禁止操作时，把项目规则写进 AGENTS.md 或 CLAUDE.md：让它先读规则，再按边界改代码。

AI 改完页面后，别只看能不能打开。逐个检查链接、移动端、空状态、旧数据和 SEO 字段，避免表面可运行但行为已经偏掉。

让 Claude Code 或 Codex 改完代码后，先看 diff、再跑最小检查，并把验证要求写进项目规则，避免只拿到一句“已完成”。

把 Claude Code 用在真实项目里：先确认安装和 Shell，再写 CLAUDE.md、收紧 settings 权限、保护敏感文件，并用 doctor、context、permissions、hooks 和 MCP 验证配置是否真的生效。

同一个项目里不知道用 Claude Code 还是 Codex 时，先看任务需要项目内结对修改，还是仓库级搜索、命令执行、diff review 和验证交付。

在 Claude Code、Codex 和 Gemini 之间分配开发任务：先按代码修改、终端自动化、长文档分析选择模型，再用小任务验证成本、可靠性和失败边界。

把 Codex 和 Claude Code 当日常开发工具时，先用 10 个 Skills 固化代码审查、CI 修复、官方文档查询、前端验收、文档写作和安全检查流程。

把 Codex CLI 用在真实项目里：先写 AGENTS.md、收紧权限、让它先读代码再改文件、要求验证证据，并把重复流程沉淀成 Skill 和 MCP。