From 33d6a2a6e90caf3fa9c8547d983adfdcbff275cc Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Thu, 29 Oct 2026 07:22:18 +0800 Subject: [PATCH] =?UTF-8?q?rules(=E8=A1=8C=E4=B8=BA=E6=8F=90=E9=86=92):=20?= =?UTF-8?q?AGENTS.md=20=E6=96=B0=E5=A2=9E=E3=80=8C=E4=B8=BB=E5=8A=A8?= =?UTF-8?q?=E6=A3=80=E7=B4=A2=E6=8F=90=E9=86=92=E3=80=8D=E8=BD=AF=E6=8F=90?= =?UTF-8?q?=E9=86=92=E8=8A=82=EF=BC=88=E9=9D=9E=E7=A1=AC=E6=80=A7=E7=BA=A2?= =?UTF-8?q?=E7=BA=BF=EF=BC=89=E2=80=94=E2=80=94=E7=89=88=E6=9C=AC=E6=95=8F?= =?UTF-8?q?=E6=84=9F/=E6=97=B6=E6=95=88=E6=95=8F=E6=84=9F=E7=9F=A5?= =?UTF-8?q?=E8=AF=86=EF=BC=88=E5=BC=95=E6=93=8E=20API/=E8=AE=BE=E8=AE=A1?= =?UTF-8?q?=E6=A8=A1=E5=BC=8F/=E6=9E=B6=E6=9E=84=E5=AE=9E=E8=B7=B5/?= =?UTF-8?q?=E8=A1=8C=E4=B8=9A=E6=83=AF=E4=BE=8B/=E5=B7=A5=E5=85=B7?= =?UTF-8?q?=E9=93=BE=EF=BC=89=E6=88=96=E8=87=AA=E5=88=A4=E6=B2=A1=E6=8A=8A?= =?UTF-8?q?=E6=8F=A1=E5=A4=84=EF=BC=8C=E5=8D=B3=E4=BD=BF=E8=AE=AD=E7=BB=83?= =?UTF-8?q?=E8=AE=B0=E5=BF=86=E6=9C=89=E7=8E=B0=E6=88=90=E7=AD=94=E6=A1=88?= =?UTF-8?q?=E4=B9=9F=E5=85=88=20WebSearch/WebFetch=20=E6=9F=A5=E8=AF=81?= =?UTF-8?q?=E5=86=8D=E4=B8=8B=E7=BB=93=E8=AE=BA=EF=BC=9B=E6=9D=A5=E6=BA=90?= =?UTF-8?q?=E5=8F=96=E5=AE=98=E6=96=B9=E4=B8=8E=E4=B8=BB=E6=B5=81=E7=8E=B0?= =?UTF-8?q?=E8=A1=8C=E5=AE=9E=E8=B7=B5=E3=80=81=E6=97=A5=E6=9C=9F=E7=89=88?= =?UTF-8?q?=E6=9C=AC=E9=A1=BB=E5=8C=B9=E9=85=8D=E9=A1=B9=E7=9B=AE=E7=8E=AF?= =?UTF-8?q?=E5=A2=83=E3=80=81=E8=BF=87=E6=9C=9F=E5=86=85=E5=AE=B9=E4=B8=8D?= =?UTF-8?q?=E9=87=87=E4=BF=A1=EF=BC=9B=E5=A4=96=E6=9F=A5=E7=BB=93=E8=AE=BA?= =?UTF-8?q?=E5=8F=AA=E4=BD=9C=E5=91=88=E6=8A=A5=E4=B8=8E=E5=BE=85=E8=A3=81?= =?UTF-8?q?=E7=82=B9=E8=AF=81=E6=8D=AE=EF=BC=8C=E8=A6=81=E8=BF=9B=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E8=B5=B0=20doc-design=E3=80=81=E8=A6=81=E8=BF=9B?= =?UTF-8?q?=E4=BB=A3=E7=A0=81=E8=B5=B0=E4=BA=94=E6=AE=B5=E6=B5=81=E6=B0=B4?= =?UTF-8?q?=E7=BA=BF=EF=BC=8C=E4=B8=8D=E8=B6=8A=E6=95=B0=E5=80=BC/?= =?UTF-8?q?=E6=9E=B6=E6=9E=84=E5=8D=95=E6=BA=90=EF=BC=8C=E5=BA=93=E5=86=85?= =?UTF-8?q?=E4=BA=8B=E5=AE=9E=E6=9F=A5=E8=A7=84=E8=8C=83=E5=AF=BC=E8=88=AA?= =?UTF-8?q?=E4=B8=8D=E5=A4=96=E6=9F=A5=EF=BC=9B=E5=BC=95=E6=93=8E=20API=20?= =?UTF-8?q?=E4=B8=93=E9=A1=B9=E8=A7=84=E5=88=99=E7=BB=B4=E6=8C=81=20engine?= =?UTF-8?q?-reference=20=E4=B8=8D=E5=8F=98=EF=BC=8C=E6=9C=AC=E8=8A=82?= =?UTF-8?q?=E4=B8=BA=E5=85=B6=E9=80=9A=E7=94=A8=E7=89=88=E2=80=94=E2=80=94?= =?UTF-8?q?=E6=BA=90=E8=B5=B7=3D=E7=94=A8=E6=88=B7=202026-10-29=20?= =?UTF-8?q?=E8=A3=81=EF=BC=9Aengine-reference=20=E6=97=A7=E8=A7=84?= =?UTF-8?q?=E5=88=99=E8=A7=A6=E8=BE=BE=E4=B8=8D=E5=8F=AF=E9=9D=A0=E4=B8=94?= =?UTF-8?q?=E5=8F=AA=E8=A6=86=E7=9B=96=20API=EF=BC=8C=E9=9C=80=E5=B8=B8?= =?UTF-8?q?=E8=BD=BD=E5=85=A5=E9=9D=A2=E7=9A=84=E9=80=9A=E7=94=A8=E6=8F=90?= =?UTF-8?q?=E9=86=92=EF=BC=9B=E7=99=BB=E8=AE=B0=E4=B8=8E=E5=AE=8C=E6=88=90?= =?UTF-8?q?=E5=90=8C=E4=BC=9A=E8=AF=9D=E5=9D=8D=E7=BC=A9=E6=9D=A1=E7=9B=AE?= =?UTF-8?q?=E5=85=8D=E8=90=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) 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）