comet: Instructions file for Codex

回复语言

必须采用中文回答用户

表达与文档风格

适用于回复、Skill、开发文档、CLI 帮助、错误提示和代码注释。

• 使用自然、具体的表达，先说明结果或动作，再说明必要的原因和条件。Skill 指令写清何时执行、执行什么、完成条件是什么。
• 用事实、行为和例子解释问题；删去空泛评价、宣传口吻、机械排比、重复总结，以及没有实际区别的“不是 X，而是 Y”句式。标题、加粗和列表只用于帮助阅读。
• 用准确的常用词表达概念，避免堆砌抽象名词、自造口号或生硬直译。技术术语确有必要时保留，并在首次出现且读者可能不熟悉时简要解释。
• 网站中文内容中，表示 Docker 容器所在机器时保留“宿主机”；其他语境禁用“宿主”一词，根据实际对象使用“Agent 平台”“Agent”“执行器”或“本机”等准确名称。
• 精简重复表述，保留需求范围、触发条件、例外、失败处理、确认要求和验收标准。必要内容移到参考文件时，写明读取条件与位置；不能以减少字数代替完整说明。

Skill 触发表述规范

修改 skill 时，新增或调整依赖 skill 的触发方式必须和既有写法保持一致：

• 中文统一使用：**立即执行：** 使用 Skill 工具加载 <skill-name> 技能。禁止跳过此步骤。
• 英文统一使用：**Immediately execute:** Use the Skill tool to load the <skill-name> skill. Skipping this step is prohibited.
• 后续输入、上下文或执行要求写在“技能加载后 / After the skill loads”段落，不要把 ARGUMENTS、fast-forward 等另一套调用术语混入触发句。

代码与 CLI 术语

• 新增或修改命令、参数、函数、类型、模块和协议字段时，先查仓库中同一概念的既有名称，再参考相关 Agent 工具、依赖库或开源项目的公开接口与文档。优先采用含义一致、已有使用惯例的名称。
• Agent 概念和架构术语应与实际职责对应，例如 tool、agent、session、handoff、checkpoint、router、adapter、state machine；不能仅为显得专业而套用术语或引入对应抽象。不确定是否通用时先核对来源，不凭印象声称是行业标准。
• 同一概念在代码、CLI、JSON、帮助和文档中保持一致；不同职责保留区别，不为统一名称而混淆状态或角色。CLI 动作使用明确的动词，参数说明操作对象或选项含义，遵循仓库已有命令结构。
• 没有合适通用词时，使用能直接说明职责的领域名称，并简要定义。现有公开名称的调整须评估兼容性和迁移影响；本规则不要求批量重命名已有接口或重构架构。

项目配置决策

新增 .comet/config.yaml 字段前，先核对当前解析、生成和更新逻辑，以及 Git 历史中已移除的同类字段；Issue 的建议不能单独作为恢复配置的依据。Native v4 已停止在项目配置中维护 native.snapshot 的文件数、字节数等预算，因此生成输入检查也不得换名新增同类项目级限额。检查应流式读取并绑定实际输入；读取失败或不稳定时报告快照不完整，禁止复用旧检查。确需恢复公开预算配置时，先明确用户需求并评估兼容性与迁移影响。

开发工作区保护

开始修改前检查当前分支、比较基线、未提交文件和子模块状态。保留所有无关修改，不得通过 reset、clean、删除或格式化无关文件来换取检查通过。提交时只显式暂存本任务文件。

website 是独立 Git 子模块；只有任务明确涉及网站时才能修改其内容或引用状态。

.agents/skills/comet*、.claude/skills/comet*、平台安装目录和测试生成目录是本地安装或 dogfood 副本，不是产品源码。产品行为应修改 app/、domains/、platform/、assets/ 或对应构建脚本。

分层开发规则

修改目标文件前，读取从仓库根到该文件目录沿途的 AGENTS.md；路径更深的文件补充或覆盖上层规则。.claude/rules/*.md 是 Claude Code 的对应路径规则，.codex/rules/*.rules 只用于 Codex 命令执行策略，不承载开发行为说明。

规则文件的数字前缀只用于分组和稳定排序，不表示优先级。发生冲突时按平台自身的作用域规则处理，不根据编号判断覆盖关系。

问题证据与验证结论

Issue、Review 意见、Project Knowledge、Memory 和历史记录只提供调查线索。可能变化的事实必须在当前分支重新核对；行为缺陷应先在最小临时项目、对应发布包或真实 Runtime 中复现。