From 5949c2fd582719e26f31d6d400ab5c46cd22999d Mon Sep 17 00:00:00 2001 From: kdletters Date: Mon, 10 Aug 2026 20:14:30 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A7=84=E8=8C=83=E9=80=80=E5=BD=B9=E5=AF=B9?= =?UTF-8?q?=E8=B1=A1=E5=9B=9B=E4=B8=8D=E5=86=99=E5=8E=9F=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 明确无现役依赖对象不写历史兼容代码与退役行为测试 禁止墓碑注释和墓碑文档并要求权威文档表达当前状态 保留公开契约、持久化数据和正式迁移的必要兼容边界 --- AGENTS.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 694ec26fe..f7969ee42 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -26,6 +26,12 @@ - 后续新增 Markdown 文档文件名必须以分类标签开头，格式为 `【标签名】中文标题-日期.md`；历史文档不要求批量重命名，除非本次任务明确涉及。 - 工程修改要同步更新对应 `docs/` 文档；产生长期有效的架构约定、接口变化、排障经验、开发流程或协作规则时，同步更新 `docs/project-memory/shared-memory/`。 - 默认保持系统简洁：优先复用、修改、扩展现有系统、页面和公共组件，不新建平行系统或平行页面。 +- 对已明确退役且不存在现役调用方、公开契约、持久化数据、活跃实例或迁移要求的对象，坚持“四不写”： + 1. 不写历史兼容代码。 + 2. 不写用于维持退役行为的防御性兼容测试。 + 3. 不写仅说明其曾存在或已删除的墓碑注释。 + 4. 不写仅记录其已删除的墓碑文档；直接将权威文档更新为当前状态。 +- 公开 API、持久化数据、SpacetimeDB schema、跨版本重放、活跃实例和正式迁移不适用“四不写”；必要兼容应最小化、白名单化并配套契约或迁移测试，迁移完成后同步删除兼容实现与对应测试。 - UI 面板中不要默认写功能说明、规则描述或开发解释文案；移动端优先，同时保证网页端可正常显示和操作。 - 点击按钮弹出独立面板的设计，不要实现成在当前面板下面追加内容。