diff --git a/AGENTS.md b/AGENTS.md index 85feb897..bddeb737 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -79,6 +79,13 @@ 枚举用列表,二维对照用表格,按内容形态选;散文是最后手段。 +## 主动检索提醒(软提醒,非硬性红线) + +- **触发**:问题落在版本敏感或时效敏感的知识上(引擎 API、设计模式、架构实践、行业惯例、工具链用法),或我自判没把握——即使训练记忆里有现成答案,也先用 WebSearch/WebFetch 查证再下结论。训练数据有截止日期,记忆里的做法默认可能偏旧。 +- **来源取舍**:官方文档与官方迁移指南优先,其次是被广泛引用的现行实践;结论取最新且主流的,来源的日期与版本须匹配本项目环境(引擎版本、项目约定),过期内容不采信。 +- **落点纪律**:外查结论只作呈报与待裁点证据——要进文档走 doc-design、要进代码走五段流水线,不因检索结果直接改数值或架构单源;仓库内部事实一律查库内权威文档(规范导航表),不外查。 +- **引擎专项**:API 级既有规则不变(`design/engineering/engine-reference/godot/VERSION.md`),本节是它的通用版,两者并行不冲突。 + ## 硬性红线(勿违反;操作细则在 process-conventions.md 与各规约) - 车道铁律(判据与改动域划分同一,按文件性质切)——代码面(`game/` 下非 `.md` 的行为载体)唯一强制独立 worktree(迭代批全套仪式不变);其余一切面(含 `game/` 内 `.md` 与 `.zcode/`、`.qoder/` 等不入 git 面)主工作区直改+直提,commit 点由 git pre-commit 钩子(`tools/hooks/pre-commit`,`core.hooksPath` 挂载)现场跑文档域闸,绿落地红拦;主区直提代码面被该钩子拦;`--no-verify` 仅属用户,agent 禁用(细则见 process-conventions §1)