81 lines
3.1 KiB
Markdown

# 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`。
- 禁止破坏性操作,除非用户明确授权。