本目录包含 Codex (OpenAI/ChatGPT) 在 FIT Framework 项目中的配置。

• preferences.yaml - Codex 的偏好配置

在开始工作前，Codex 应该：

1. 读取 AGENTS.md（项目根目录）了解项目基本信息
2. 读取 .agents/README.md 了解协作流程
3. 读取 .agents/workflows/ 了解工作流定义

当人类切换到 Codex 时：

请根据 .ai-workspace/active/TASK-{id}/task.md 继续工作

Codex 应该：

1. 读取任务文件
2. 读取相关的上下文文件（.ai-workspace/active/{task-id}/）
3. 理解当前进度和下一步要做什么
4. 开始执行任务

Codex 擅长的任务：

• 根据设计方案编写代码
• 编写单元测试
• 重构代码
• 修复Bug

示例提示词:

请根据 .ai-workspace/active/TASK-{id}/plan.md 中的方案实现代码。
需要包括：
1. 功能实现
2. 单元测试
3. 必要的注释
4. 更新相关文档

示例提示词:

请分析并修复 TASK-{id} 中描述的Bug。
步骤：
1. 复现问题
2. 定位根因
3. 修复代码
4. 添加回归测试

完成任务后，Codex 应该：

1. 创建输出文件到 .ai-workspace/active/{task-id}/
2. 更新任务状态
3. 说明完成情况和需要注意的事项

输出模板:

任务完成，已完成以下工作：

## 完成的文件
- src/main/java/... - 实现了...功能
- src/test/java/... - 添加了...测试

## 测试结果
- [x] 所有单元测试通过
- [x] 本地验证通过

## 需要注意
- ...

## 下一步建议
建议切换到 ClaudeCode 进行代码审查

在 FIT Framework 项目中，Codex (OpenAI/ChatGPT) 擅长：

1. 快速代码实现

   • 根据设计方案快速编写代码
   • 遵循现有代码风格
   • 代码生成效率高

2. 单元测试编写

   • 生成全面的测试用例
   • 覆盖边界情况
   • 测试代码质量好

3. 代码重构

   • 小范围的代码优化
   • 提取方法、简化逻辑
   • 快速迭代

4. Bug修复

   • 快速定位和修复问题
   • 添加回归测试
   • 高效排错

5. 文档编写

   • API 文档
   • 使用示例
   • README 更新

典型流程：

1. ClaudeCode 分析需求，设计方案
2. Codex 实现代码和测试
3. ClaudeCode 审查代码
4. Codex 修复问题（如果有）
5. ClaudeCode 最终确认和提交

Codex 和 GeminiCli 可以互为替代或协作：

• 根据任务特点选择更合适的 AI
• 都擅长代码实现和测试编写
• Codex 更适合快速迭代，GeminiCli 更适合大规模分析

从 ClaudeCode 接手时：

• 仔细阅读 plan.md 理解设计意图
• 严格按照方案实现，不要擅自改动设计
• 有疑问及时询问

交接给 ClaudeCode 时：

• 说明实现细节和关键决策
• 列出需要重点审查的地方
• 标注已知问题或待优化项

参考 AGENTS.md 中的规范：

• Java 格式化：使用 CodeFormatterFromIdea.xml
• 注释要求：公共API需要Javadoc
• 类头信息：@author 和 @since
• 分支命名：模块前缀 + 意图
• 版权年份更新：修改任意带版权头的文件时，必须先通过系统命令 date +%Y 获取当前年份，然后更新版权头（例如 2024-2025 → 2024-<当前年份>）。绝对不要硬编码年份

• 单元测试使用 JUnit
• 测试类命名：*Test.java
• 每个公共方法都应有测试
• 测试要覆盖正常和异常情况

• 提交信息遵循 Conventional Commits：<type>(<scope>): <subject>
• subject 使用中文且约 20 字以内，scope 为模块名（可省略）
• 不要自动提交，等待人工确认

优先选择 Codex：

• 快速迭代和原型开发
• 单一功能的实现
• 需要快速生成大量代码
• 小到中等规模的修改

优先选择 GeminiCli：

• 大规模代码库分析
• 需要全局重构
• 超大上下文场景（2M tokens）
• 跨多个模块的复杂改动

A: 查看 .ai-workspace/active/ 下的任务目录

A: 检查 .ai-workspace/active/{task-id}/ 目录

A: 查看 .agents/workflows/{workflow}.yaml 了解完整流程

A: 根据任务类型和 workflow 中的推荐，但最终由人类决定

A: Codex 擅长快速代码生成，GeminiCli 擅长大规模分析（超大上下文窗口）

• 主配置：AGENTS.md
• 协作指南：.agents/README.md
• 工作流定义：.agents/workflows/
• 任务模板：.agents/templates/
• 快速开始：.agents/QUICKSTART.md

配置版本: 2.0.0 AI 名称: Codex (OpenAI/ChatGPT) 定位: 执行型专家 - 快速代码实现和测试编写