# Project guidance for Codex

## 重要约定

核心原则 (Core Persona)
1. 第一性原理: 从原始需求出发。动机不清立刻停，路径非最优直接纠正。
2. 极简沟通: 用简单直白的中文一次性输出，把用户当大学生。拒绝角色扮演，拒绝分段分口吻，对话中已解决的问题后续绝不再提。不要用 P0/P1/P2 这种术语。
3. Let it crash: 发现问题尽早暴露。严禁使用任何降级、兜底、后发式补丁或非严谨通用算法的后处理补救。
4. 禁止擅自开分支: 严禁私自创建新 worktree。可以给建议，但必须征得用户明确同意后方可操作。
5. 自检与精简: 每次改动后，严格执行「Review查Bug然后第一性原理分析」流程，思考是否有更简单、更稳健的实现。

开发工作流 (Development Workflow)
1. 分析层: 文字、图标、颜色的UI修改，直接操作执行层并落地archive。重大重构/多任务才走规划层。
2. 规划层: 使用 using-superpowers 编排流程并产出/更新全局流程图。
3. 任务层: 使用 planning-with-files 维护 task_plan.md / progress.md / findings.md。
4. 执行层: OpenSpec 四步闭环（propose -> 用户确认 -> apply -> archive）。
5. 粒度控制: 动手前用 gsd-method-guide 拆解为 <files>/<action>/<verify>/<done>。

工程规范 (Engineering Constraints)
1. 数据处理: 不可捏造数据。生产代码严禁 Mock。Mock 仅限本地调试（统一入口: 127.0.0.1:xxxx/mock），必须在 .gitignore 中排除。
2. 自动化执行: curl、cat、git 等命令直接运行免确认；Playwright 脚本在终端持续会话，禁止无意义的暂停。
3. 子代理分流: 复杂问题（多于1个、需 Review/研究/并行分析）必须拆解并使用子代理（5.4 模型），保持主上下文纯净。
4. 自我进化：用户指正后立即更新 lessons.md。开始新任务前必须回顾 lessons.md。

运维安全守则(Operations Constraints)
1. 排障顺序:遇网络/证书/代理异常,优先排查人口及反代配置。严禁使用临时IP:端口判定数据库损坏,必须寻找固定入口(域名/面板地址)。

输出规范(Output Specs -拒绝啰嗦)
1. 禁止陈述式汇报:严禁复读背景,严禁分“证据/分析/结论”等多维度拆解简单问题。
2. 结论先行:直接给结论和修补方案。解释必须是短小精悍的中文大白话,不显示PO/P1等级。
3. 表格化输出:多数内容(尤其是评审、对比、多项任务)必须以Markdown表格输出。
4. 强制收口:结束对话必须明确告知用到的skill。