6c6c282203
视觉统一（Zen Minimal × Future Organic 白皮书语言，全站浅色单主题）： - 登录页：品牌→由壹点·品牌中心，白纸底+发丝线+柔光光晕，黑按钮 - 作品过稿：深灰头→白皮书，返回链接→返回创意资产库 - 绩效考核：桌面+移动双头部换白皮书，标题改绩效考核，返回改链接 - 组织架构：BoardShell+页面 76 处调色板全量替换（#eef1f4→#fafafa 等） - admin 后台：MaterialsHeader（面包屑治理与设置），Tab 栏墨色高亮 - 深色主题废弃：globals.css 移除媒体查询，tailwind darkMode:'class' 不挂 .dark - 设计文档同步更新：AGENTS.md UI 基线/DESIGN.md/PRODUCT.md/README.md/design-qa.md 个人档案（原个人中心）： - API 合并权威人员档案（getEmployeeByUserId → 花名/工号/部门/职位/M-P等级/主管/状态） - 页面白皮书化：权威档案卡（只读 HR 字段）+ 账号区（头像上传）+ 素材/收藏 顶栏平台化： - MaterialsHeader 双模式：首页（五板块导航+全套工具+菜单）/板块（面包屑） - 菜单重排：我的档案/绩效考核/作品过稿看板‖更新记录/提交反馈‖治理与设置‖退出 - 菜单头身份行：花名+职位·部门（权威档案） - 首页排序：01 创意资产库（全员）→ 02 组织管理（管理员）→ 03-05 规划中 - 素材库改名创意资产库，全站同步（索引/导航/卡片/按钮/页脚） - 排行榜换白皮书（白底发丝线+琥珀前三名） 构建修复： - tsconfig 排除 output/（本地审计临时文件不再卡类型检查） - 存储边界门禁豁免 output/（与 .dockerignore 对齐）
130 lines
7.1 KiB
Markdown
130 lines
7.1 KiB
Markdown
# gongxiangp2 的 Codex 项目规则
|
||
|
||
适用范围：本文件仅对当前项目生效。
|
||
|
||
## 1. 项目背景
|
||
|
||
- 本项目是线上运行中的内部素材平台，稳定性优先于速度。
|
||
- 当前默认以“新素材链路”为主，不把“新老素材兼容”作为默认核心门禁。
|
||
- 只有在任务明确涉及历史数据、旧下载路径、旧存储迁移时，才重新拉高“老素材兼容”优先级。
|
||
|
||
## 2. 基本工作原则
|
||
|
||
- 默认使用中文说明，优先自然语言，少量必要代码示例。
|
||
- 先做只读摸底，再决定是否修改。
|
||
- 非必要不要使用兜底逻辑；优先把原生主链路和标准流程做好，只有在明确需要兼容、降级或应急，并说明原因和影响范围时，才增加兜底处理。
|
||
- 修改后必须验证，先跑最相关的验证，再视情况扩大范围。
|
||
- 不触碰其他应用配置，不把项目规则写入全局 `Codex` 配置。
|
||
|
||
## 3. 项目内 Multi-agents 规则
|
||
|
||
当任务满足以下任一条件时，优先启用内置多代理：
|
||
|
||
- 任务同时涉及前后端、接口与页面联动。
|
||
- 任务涉及上线前审查、发布门禁、回归检查。
|
||
- 任务需要同时做“功能正确性 + UI 统一性 + 发布风险”判断。
|
||
- 任务跨越多个目录，单代理容易遗漏影响范围。
|
||
|
||
当用户明确写出以下任一表达时，默认必须真正进入多代理流程，而不是只解释角色定义：
|
||
|
||
- “按项目的审查模式处理”
|
||
- “按项目的修复模式处理”
|
||
- “按项目的发布模式处理”
|
||
- “用 Multi-agents 处理”
|
||
- “启用项目团队”
|
||
|
||
默认团队结构：
|
||
|
||
- `orchestrator`：主控代理，负责拆解任务、分配角色、汇总结论。
|
||
- `backend`：后端代理，负责 `app/api/**`、`lib/**`、`prisma/**` 风险审查与修复建议。
|
||
- `frontend`：前端代理，负责 `app/**` 页面层、`components/**`、`hooks/**` 交互回归。
|
||
- `ui_auditor`：UI 统一规范审查员，负责视觉系统和组件一致性审查。
|
||
- `release_gate`：发布守门代理，负责按证据给出可上线/有条件上线/不可上线结论。
|
||
|
||
默认子代理模型规则：
|
||
|
||
- 只要启用 `subagent` / 子代理，默认使用 `gpt-5.4`。
|
||
- 默认推理强度使用 `xhigh`。
|
||
- 只有在用户明确要求更换模型或推理强度时，才允许偏离这条默认配置。
|
||
|
||
对外沟通规则：
|
||
|
||
- 只有 `orchestrator` 直接和用户对话。
|
||
- 其它子代理只负责内部执行、审查、汇总，不直接面向用户输出。
|
||
- 用户默认把需求交给 `orchestrator`；由 `orchestrator` 自行决定是否派发、派给谁、何时汇总。
|
||
- 除非用户明确要求查看子代理原始结果，否则对外只输出主控汇总后的结论。
|
||
|
||
按需附加角色：
|
||
|
||
- `explorer`：跨文件侦察员，用于快速搜集上下文、文件归属和影响范围。
|
||
- `worker`：定点执行代理，用于在职责明确后修改小范围文件。
|
||
|
||
## 4. 角色分工边界
|
||
|
||
- `backend` 默认优先处理：上传、下载、转码、权限、批量操作、后台统计、外部接口。
|
||
- `frontend` 默认优先处理：管理后台页面、上传组件、分享页、首页、交互状态。
|
||
- `ui_auditor` 默认不先改代码，先审查视觉问题；只有明确要求修 UI 时才参与改动建议。
|
||
- `release_gate` 只做汇总和判定，不直接承担业务实现。
|
||
- `worker` 只能接收已经明确边界的子任务，避免和主代理重复改动。
|
||
|
||
自动派单规则：
|
||
|
||
- 用户只需要把任务交给 `orchestrator`，不需要手动指定团队成员。
|
||
- `orchestrator` 根据任务类型自动决定是否启用团队，以及启用哪些角色。
|
||
- 默认分配逻辑：
|
||
- 单一页面或纯 UI 小改动：`frontend` + `ui_auditor`
|
||
- 纯接口、下载、上传、转码、权限、批量操作：`backend`
|
||
- 前后端联动：`backend` + `frontend`
|
||
- 前后端联动且涉及视觉统一：`backend` + `frontend` + `ui_auditor`
|
||
- 上线前审查、高风险任务、改动范围大：`backend` + `frontend` + `ui_auditor` + `release_gate`
|
||
- 影响范围不清：先派 `explorer` 摸底，再决定后续角色
|
||
- 用户不负责选人，角色编组由 `orchestrator` 内部完成。
|
||
|
||
高风险边界规则：
|
||
|
||
- 下面这些任务默认视为高风险：
|
||
- 涉及数据库写入、删除、恢复、批量更新、批量删除
|
||
- 涉及权限判断、角色判断、下载资格、管理员能力
|
||
- 涉及上传、下载、转码、外部接口、批量操作
|
||
- 涉及后台统计、日志、导出、审计记录
|
||
- 涉及可能影响线上已有数据、用户可见结果或管理后台操作结果的改动
|
||
- 高风险任务默认至少派出：`backend`
|
||
- 如果高风险任务同时影响页面或交互，再追加：`frontend`
|
||
- 如果高风险任务还影响视觉一致性，再追加：`ui_auditor`
|
||
- 如果任务准备上线、范围较大、或存在不确定性，再追加：`release_gate`
|
||
- 只要任务落入高风险边界，`orchestrator` 默认采用更保守的判断和验证策略。
|
||
|
||
UI 基线规则（2026-08-15 更新）：
|
||
|
||
- 平台主体已切换为「由壹点·品牌中心」看板，UI 统一标准以**看板首页**为基线（`app/page.tsx`）。
|
||
- 基线语言：Zen Minimal × Future Organic 白皮书风（白纸 #fafafa / 墨字 #1a1c1d / 发丝线 / 编号索引 / 柔紫光晕点缀 / 无阴影平面化），完整令牌见 `DESIGN.md`。
|
||
- **全站浅色单主题**：深色主题已废弃（`tailwind darkMode: 'class'` 且不挂 `.dark`，`dark:` 变体全部失效）；新代码不得再写 `dark:` 类。
|
||
- logo 双版本：浅底表面用 `loginLogoUrl`（深色图案），黑底遗留表面用 `headerLogoUrl`。
|
||
- `ui_auditor` 在审查其它页面时，优先对齐上述语言；遗留页面（admin/profile/share/edit 与组织架构页旧壳）按「逐页统一」节奏迁移。
|
||
- 如果某个后台页面或特殊业务页面需要偏离基线风格，必须说明原因和影响范围。
|
||
|
||
## 5. 前端体验与 Impeccable 规则
|
||
|
||
- 凡涉及页面、组件、样式、布局、交互、响应式、可访问性或其它前端体验的工作，默认必须优先调用并严格遵循 `$impeccable` Skill；除非用户明确要求跳过。
|
||
- 开始修改前，先读取项目现有代码、视觉规范、组件库和产品上下文，并判断当前页面属于 `Operate`、`Persuade`、`Read` 还是 `Experience` 模式。
|
||
- 保留当前产品的视觉语言和业务语义，不套用千篇一律的 AI 前端模板；不得滥用渐变、套娃卡片、超大标题、装饰性面板和无意义动画。
|
||
- 实现后必须检查桌面端与移动端实际页面，并处理层级、间距、字体、颜色、溢出、空状态、错误状态、交互反馈、响应式和可访问性问题。
|
||
- 交付前执行与任务匹配的 `$impeccable critique`、`$impeccable audit` 或 `$impeccable polish` 流程，并保留必要的验证证据。
|
||
|
||
## 6. 输出要求
|
||
|
||
多代理任务的输出默认按下面结构收敛：
|
||
|
||
- `发现的问题`
|
||
- `严重级别 P0 / P1 / P2`
|
||
- `影响范围`
|
||
- `修复建议`
|
||
- `验证清单`
|
||
- `最终结论`
|
||
|
||
## 7. 建议先读的文档
|
||
|
||
- `README.md`
|
||
- `docs/CODEX_MULTI_AGENTS.md`
|
||
- `.private\gongxiangp2-完整敏感接管清单-2026-08-13.md`
|