# gongxiangp2 的 Codex 项目规则

适用范围：本文件仅对当前项目生效。

## 1. 项目背景

- 本项目是线上运行中的内部素材平台，稳定性优先于速度。
- 当前默认以“新素材链路”为主，不把“新老素材兼容”作为默认核心门禁。
- 只有在任务明确涉及历史数据、旧下载路径、旧存储迁移时，才重新拉高“老素材兼容”优先级。

## 2. 基本工作原则

- 默认使用中文说明，优先自然语言，少量必要代码示例。
- 先做只读摸底，再决定是否修改。
- 非必要不要使用兜底逻辑；优先把原生主链路和标准流程做好，只有在明确需要兼容、降级或应急，并说明原因和影响范围时，才增加兜底处理。
- 修改后必须验证，先跑最相关的验证，再视情况扩大范围。
- 不触碰其他应用配置，不把项目规则写入全局 `Codex` 配置。
- 数据库写入、删除或恢复，权限与下载资格，上传、下载、转码、外部接口、批量操作，后台统计、日志、导出与审计，以及影响线上数据或用户可见结果的改动，按高风险任务核对影响范围并加强验证。

## 3. 界面基线

- 品牌中心实际入口是 `/workspaces/dashboard/core-metrics`；`app/page.tsx` 只负责登录和权限跳转。界面改动以 `DESIGN.md`、`components/department-dashboard/DepartmentShell.tsx` 和对应页面的现状为准。
- 品牌中心采用深色导航轨与浅色内容区；素材资产库按其独立工作壳处理。
- 项目不挂载 `.dark` 主题类，新代码不要添加无效的 `dark:` 变体。

## 4. 前端体验与 Impeccable 规则

- 凡涉及页面、组件、样式、布局、交互、响应式、可访问性或其它前端体验的工作，默认必须优先调用并严格遵循 `$impeccable` Skill；除非用户明确要求跳过。
- 开始修改前，先读取项目现有代码、视觉规范、组件库和产品上下文，并判断当前页面属于 `Operate`、`Persuade`、`Read` 还是 `Experience` 模式。
- 保留当前产品的视觉语言和业务语义，不套用千篇一律的 AI 前端模板；不得滥用渐变、套娃卡片、超大标题、装饰性面板和无意义动画。
- 实现后必须检查桌面端与移动端实际页面，并处理层级、间距、字体、颜色、溢出、空状态、错误状态、交互反馈、响应式和可访问性问题。
- 交付前执行与任务匹配的 `$impeccable critique`、`$impeccable audit` 或 `$impeccable polish` 流程，并保留必要的验证证据。

## 5. 开发进度同步

- 可说明的工作提交后，运行 `npm run progress:sync -- ... --apply`，按真实证据使用 `code_complete`、`testing` 或 `done`。
- 仅同步 Git 元数据；目录匹配不唯一就停止，同步失败不得阻断 Git 与生产发布。

## 6. 建议先读的文档

- `README.md`
- `.private\gongxiangp2-完整敏感接管清单-2026-08-13.md`