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

AGENTS.md

适用范围：D:\AI Code\3danzhuang 全仓库。

1. 默认方式

• 默认中文沟通，面向非程序员表达。
• 默认回复尽量简短、直白、好理解，非必要不展开。
• 默认先说“现在你要做什么 / 结论是什么”；技术细节、文件路径、命令和长解释只在用户要求时展开。
• 默认按当前会话直接开发。
• 没有“规范审查结论”，任务不算完成。

2. 三条硬规则

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

3. 固定流程

1. 开始前先用 1-2 句说明：目标、验收标准、根因判断。
2. 开发时优先复用现有实现，不顺手改无关问题。
3. 改完先做最小必要验证。
4. 交付前必须单独做一次规范审查。
5. 最终默认只交代：现在你要做什么、是否完成、有没有风险；技术细节只在用户要求时展开。

团队协作固定入口

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

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

这 3 份文档就是进入 furniture-3d-system/ 的固定协作入口，不再额外约定第二套平级入口，也不再靠聊天记录补口头规则。

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

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

固定协作口径：

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

4. 规范审查

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

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

结论只能是：

• passed
• passed with warnings
• rejected

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

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

5. 标准来源

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

6. 边界

• 用户未指定目录时，默认在 furniture-3d-system/ 执行。
• 未经用户明确要求，不主动 commit / push。
• 禁止破坏性操作，除非用户明确授权。