必须用含“constants”或“design”的明确文件名统一管理常量，如sharedconstants.swift；codex仅通过扫描此类文件、agents.md声明、zcf注入或-c参数显式指定才能识别，否则无法获取准确值。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在多个文件中重复定义颜色、字体、间距等常量，会导致修改时漏改、风格不一致、AI生成代码偏离团队规范。Codex 本身不会自动识别这些分散的值，必须通过结构化方式让它“看见”唯一真相。
用共享常量枚举统一管理
第一步：在项目根目录创建 SharedConstants.swift（Swift）或 Constants.java（Java），文件名必须明确体现“共享”和“常量”语义。
第二步：定义一个顶层 enum，所有常量按语义分组嵌套。例如 Swift 中：
enum Design {
enum Color {
static let primary = Color(hex: "#007AFF")
static let background = Color(.systemBackground)
}
enum Spacing {
static let small = 4.0
static let medium = 12.0
}
}
第三步：确保该文件被所有目标模块 import 或引用。SwiftUI 项目中，视图直接写 Design.Color.primary；Java 项目中，类顶部加 import com.example.Constants; 后使用 Constants.SPACING_MEDIUM。
这一步最关键：Codex 在分析上下文时，会扫描项目中所有命名含 “Constant”、“Design”、“Config” 的源文件。如果它找不到这个文件，或文件名是 MyAppStyle.swift 这类模糊名称，就会忽略——【文件名必须含 Constants 或 Design】。
让 Codex 每次都读到这份常量
方法一：在仓库根目录放置 AGENTS.md，并在其中明确声明常量位置：
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
## 设计系统
- 所有视觉常量定义在 `SharedConstants.swift` 文件中
- 字体、颜色、间距、圆角均从此文件导出，禁止硬编码
方法二：使用 ZCF 工具链自动注入上下文。运行：zcf codex inject --file SharedConstants.swift，该命令会将文件内容作为高优先级上下文注入每次 Codex 调用。
方法三：CLI 模式下手动附加上下文。执行：codex exec "添加深色模式适配" -c SharedConstants.swift，【-c 参数必须指向常量文件路径，不能是相对路径如 ./src/...】。
验证 Codex 是否已掌握常量
① 在 Codex CLI 中输入：codex chat "当前项目里主色调的十六进制值是多少？"
② 观察回复是否精确返回 #007AFF，而非泛泛回答“蓝色”或“参考设计稿”。
③ 若返回错误或模糊答案，说明 AGENTS.md 路径写错、常量文件未被识别，或文件中存在语法错误导致解析失败。
这一步操作起来很简单，直接把文件拖进去就行。但要注意：如果常量定义用了计算属性或依赖未导入的模块，Codex 会静默跳过整份文件——它只解析能静态推断的值。
