gongxiangp2/AGENTS.md

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