furniture-3d-system-Wu/AGENTS.md

AGENTS.md

适用范围：D:\AI Code\3danzhuang 全仓库。
未单独说明时，先遵循全局规则：C:\Users\54972\.codex\AGENTS.md。
这份文件只补充本仓库特有规则，不重复全局通用要求。

1. 默认执行口径

• 用户未指定目录时，默认在 furniture-3d-system/ 执行。
• 当任务发生在 furniture-3d-system/ 时，默认按当前会话直接开发。
• 未经用户明确要求，不主动 commit / push。
• 禁止破坏性操作，除非用户明确授权。
• 没有“规范审查结论”，任务不算完成。

2. 三条硬规则

• 必须符合企业级架构标准。
• 必须符合统一视觉标准。
• 必须优先做根因修复，不能拿补丁冒充完成。

3. 固定协作入口

当任务发生在 furniture-3d-system/ 时，人和 AI 都必须先读取下面 3 份协作文档，再开始改代码：

• furniture-3d-system/docs/workflow/团队协作模式.md
• furniture-3d-system/docs/workflow/模块边界说明.md
• furniture-3d-system/docs/workflow/主线同步操作手册.md

如果任务和包装协作有关，再额外读取：

• furniture-3d-system/docs/workflow/同事交接模板.md
• furniture-3d-system/docs/workflow/同事本地AGENTS模板.md
• furniture-3d-system/docs/开发指南/包装方案增强/新平台包装底座-同事AI对接说明-20260331.md

4. 协作与分支口径

• main 只作为 WuYongJie 的主线收口分支，其他协作者默认不能直接推主线。
• xuxiake 的长期包装分支固定为 codex/xuxiake-packaging。
• xuxiake 的临时任务分支固定为 codex/xuxiake-packaging-<任务简称>。
• 新分支统一使用 codex/<负责人>-<工作域> 或 codex/<负责人>-<工作域>-<任务简称>。
• 不再使用 feature/packaging、packaging/...、codex/xuxiake-dev 这类泛分支名。
• 长期包装分支同步 main 时固定使用 merge main。
• 临时个人任务分支同步 main 时才使用 rebase main。

5. Gemini 前端协作口径

• 如项目已指定 Gemini（前端专家） 负责前端，则前端代码、UI 视觉、排版动效和 3D（立体） 表现层默认由 Gemini 主导。
• 我不主动改 Gemini 已定稿的前端样式；我默认负责底层逻辑、接口、数据、数据库、部署和非前端部分。
• 与 Gemini 联调时，必须优先遵守 Gemini 已确定的数据结构和类型口径，避免因为字段或格式不一致导致前端渲染异常。
• docs/前端UI改动清单.md 只作为当前轮次的轻量对接板使用，不作为长期规范来源、历史总账或唯一协作入口。

6. 规范审查

规范审查固定只查三件事：

• 架构有没有被破坏
• 视觉有没有跑偏
• 这次是不是根因修复

结论只能是：

• passed
• passed with warnings
• rejected

只要架构违规、视觉违规，或明显是补丁式修复，就必须 rejected。
如果这次不是独立复审，必须明确写出“这是自审，不是独立复审”。

统一清单：docs/workflow/规范审查清单.md

7. 标准来源

• furniture-3d-system/.cursor/rules/*.mdc
• furniture-3d-system/docs/设计规范/苹果风格视觉标准.md
• docs/workflow/规范审查清单.md