工作流
把 AI 仓库规则放对目录:迁移约定怎么验
用目录范围表达局部约束,并在目标目录验收。

资料核验2026.11.12 · 编码助手 · 可用于现有软件仓库
仓库的根说明写着「提交前生成 SQL」,它其实只约束迁移目录。每个前端任务都读到这条规则,助手容易跑一遍不相干的流程。把说明放在作用范围内,读到的人更容易理解它为什么存在。
让助手从这一步开始
请助手列出一个仓库的数据库迁移规则和普通前端规则,分别指出哪些任务需要它们。按当前客户端文档选择受支持的指令文件位置,再从目标目录与另一个目录各做一次测试。

先看你用的客户端怎么找文件
对 Codex,核对 AGENTS.md 的发现顺序和运行目录。对 Copilot 或 Claude Code,使用各自文档支持的路径与范围机制。不要假定同一个文件在所有客户端里都会以相同方式生效。
从受影响目录开干净会话,给一张迁移任务单,观察它提出的验证命令。再从另一个目录做普通页面改动,确认没有把迁移命令当成全仓要求。
根目录保留所有任务都要知道的事实。局部说明应能回答哪类改动触发哪条约束。
把问题变成可重跑的样例
为迁移任务规定一条生成命令和一条验证命令,再给普通页面任务一个没有数据库改动的示例。分别保存两个客户端的实际执行输出。若局部规则被普遍加载,先核对文件路径和客户端支持范围。
核对这几项输出
- 数据库任务提出正确的生成与验证命令。
- 普通页面任务不会无故生成 SQL。
- 两个客户端分别记录实际读取的路径或执行证据。
怎么判断改动能不能收
文件写进仓库只证明规则存在。对混用 Codex、Copilot 和 Claude Code 的团队,按各工具的规则做对照,别把一种加载顺序写成通用承诺。重复规则多时先提炼共享说明,再留必要入口。
如果同一目录的两个入口给出冲突命令,用一个具体任务确认哪条真的生效。必要时合并重复说明,把共享规则放在统一文档,并让局部入口说明何时读取。不要让助手依据另一工具的行为推断当前工具。

