ai-engineering-init 1.7.0 → 1.10.0

package/src/skills/code-patterns/SKILL.md

@@ -1,280 +1,163 @@
 ---
 name: code-patterns
 description: |
-  后端代码禁令和编码规范速查。本项目是纯后端项目，前端代码在分离的项目中开发。
-
-  触发场景：
-  - 查看项目禁止事项（后端代码）
-  - 命名规范速查
-  - Git 提交规范
-  - 代码风格检查
-  - 避免过度工程
-
-  触发词：规范、禁止、命名、Git提交、代码风格、不能用、不允许、包名、架构
-
-  注意：后端 CRUD 开发规范请激活 crud-development，API 开发规范请激活 api-development，数据库设计规范请激活 database-ops。
+  通用编码规范指南。涵盖 RESTful API 设计、命名规范、Git 提交规范、代码风格等。
+  触发场景：代码审查、规范检查、命名讨论、API 设计。
+  触发词：编码规范、代码风格、命名规范、RESTful、Git 提交。
+  注意：如果项目有专属技能（如 `leniu-code-patterns`），优先使用专属版本。
 ---
 
-# 代码规范速查
-
-## 后端禁令速查表
-
-| # | 禁止项 | 错误写法 | 正确写法 |
-|---|--------|---------|---------|
-| 1 | 包名 | `com.ruoyi.*` / `plus.ruoyi.*` | `org.dromara.*` |
-| 2 | 完整引用 | `org.dromara.xxx.Xxx` 内联 | `import` + 短类名 |
-| 3 | 数据返回 | `Map<String, Object>` | 创建 VO 类 |
-| 4 | Service设计 | `extends ServiceImpl<>` | `implements IXxxService` |
-| 5 | 查询构建 | Controller 层 | **Service 层** `buildQueryWrapper()` |
-| 6 | 接口路径 | `/pageXxxs`, `/getXxx/{id}` | `/list`, `/{id}`, `/` |
-| 7 | 对象转换 | `BeanUtil.copyProperties()` | `MapstructUtils.convert()` |
-| 8 | 主键 | `AUTO_INCREMENT` | 雪花ID（不指定type） |
-| 9 | R.ok(string) | `R.ok(token)` | `R.ok(null, token)` |
-| 10 | Entity基类 | 无基类 | `extends TenantEntity` / `BaseEntity` |
-| 11 | @Cacheable | 返回 `List.of()`/`Set.of()` | `new ArrayList<>(List.of())` |
-| 12 | Mapper注解 | 单目标用 `@AutoMappers` | 单目标用 `@AutoMapper` |
-| 13 | 注释语言 | 英文注释 | **中文注释** |
-| 14 | SQL COMMENT | `COMMENT 'user name'` | `COMMENT '用户名'` |
-
----
-
-## 禁令详解
-
-### 1-2. 包名与引用
-
-```java
-// ✅
-package org.dromara.system.service;
-import org.dromara.common.core.domain.R;
-public R<XxxVo> getXxx(Long id) { ... }
-
-// ❌
-package com.ruoyi.system.service;
-public org.dromara.common.core.domain.R<XxxVo> getXxx(Long id) { ... }
-```
-
-### 3. 禁止 Map 传业务数据
+# 编码规范指南
 
-```java
-// ✅ 创建 VO 类
-public XxxVo getXxx(Long id) {
-    return MapstructUtils.convert(entity, XxxVo.class);
-}
+> 通用模板。如果项目有专属技能（如 `leniu-code-patterns`），优先使用。
 
-// ❌
-public Map<String, Object> getXxx(Long id) { ... }
-```
+## 核心规范
 
-### 4-5. Service 架构
+### RESTful API 设计
 
-```java
-// ✅ 三层架构：不继承 ServiceImpl，直接注入 Mapper
-@Service
-public class XxxServiceImpl implements IXxxService {
-    private final XxxMapper baseMapper;
-
-    private LambdaQueryWrapper<Xxx> buildQueryWrapper(XxxBo bo) {
-        LambdaQueryWrapper<Xxx> lqw = Wrappers.lambdaQuery();
-        lqw.eq(bo.getStatus() != null, Xxx::getStatus, bo.getStatus());
-        lqw.like(StringUtils.isNotBlank(bo.getName()), Xxx::getName, bo.getName());
-        return lqw;
-    }
-}
+| 操作 | HTTP 方法 | URL 示例 | 说明 |
+|------|----------|---------|------|
+| 创建 | POST | `/api/v1/orders` | 请求体传参 |
+| 查询列表 | GET | `/api/v1/orders` | Query 参数分页 |
+| 查询详情 | GET | `/api/v1/orders/{id}` | 路径参数 |
+| 全量更新 | PUT | `/api/v1/orders/{id}` | 请求体传参 |
+| 部分更新 | PATCH | `/api/v1/orders/{id}` | 请求体传参 |
+| 删除 | DELETE | `/api/v1/orders/{id}` | 路径参数 |
 
-// ❌
-public class XxxServiceImpl extends ServiceImpl<XxxMapper, Xxx> { }
-```
+**URL 规范**：
+- 使用名词复数：`/orders` 而非 `/order`
+- 使用小写连字符：`/order-items` 而非 `/orderItems`
+- 版本号放 URL 前缀：`/api/v1/`
+- 嵌套资源不超过两层：`/orders/{id}/items`
 
-### 6. RESTful 路径
+### 命名规范
 
-```java
-// ✅
-@GetMapping("/list")     @GetMapping("/{id}")
-@PostMapping             @PutMapping
-@DeleteMapping("/{ids}") @PostMapping("/export")
-
-// ❌
-@GetMapping("/pageAds")  @GetMapping("/getAd/{id}")
-@PostMapping("/addAd")   @PutMapping("/updateAd")
-```
-
-### 7. 对象转换
-
-```java
-// ✅ MapstructUtils
-XxxVo vo = MapstructUtils.convert(entity, XxxVo.class);
-List<XxxVo> voList = MapstructUtils.convert(entityList, XxxVo.class);
-
-// ❌ BeanUtil
-BeanUtil.copyProperties(entity, vo);
-```
+| 类型 | 风格 | 示例 |
+|------|------|------|
+| 类名 | UpperCamelCase | `OrderService`, `UserController` |
+| 方法名 | lowerCamelCase | `createOrder()`, `getUserById()` |
+| 变量名 | lowerCamelCase | `orderNo`, `userName` |
+| 常量 | UPPER_SNAKE_CASE | `MAX_RETRY_COUNT`, `DEFAULT_PAGE_SIZE` |
+| 包名 | 全小写 | `com.example.order` |
+| 数据库表/字段 | lower_snake_case | `t_order`, `order_no` |
 
-### 8. 主键策略
+**类命名约定**：
 
-```sql
--- ✅ 雪花ID
-id BIGINT(20) NOT NULL COMMENT '主键ID'
+| 后缀 | 用途 | 示例 |
+|------|------|------|
+| `Controller` | 控制器 | `OrderController` |
+| `Service` / `ServiceImpl` | 服务层 | `OrderServiceImpl` |
+| `Mapper` / `Repository` | 数据访问 | `OrderMapper` |
+| `DTO` | 请求参数 | `OrderCreateDTO` |
+| `VO` | 响应对象 | `OrderVO` |
+| `Enum` | 枚举 | `OrderStatusEnum` |
+| `Config` | 配置类 | `RedisConfig` |
+| `Handler` | 处理器 | `GlobalExceptionHandler` |
+| `Interceptor` | 拦截器 | `AuthInterceptor` |
+| `Utils` / `Helper` | 工具类 | `DateUtils` |
+
+### 方法命名约定
+
+| 前缀 | 含义 | 示例 |
+|------|------|------|
+| `create` / `add` | 创建 | `createOrder()` |
+| `update` / `modify` | 更新 | `updateStatus()` |
+| `delete` / `remove` | 删除 | `deleteById()` |
+| `get` / `find` / `query` | 查询 | `getById()`, `findByName()` |
+| `list` | 查询列表 | `listByStatus()` |
+| `page` | 分页查询 | `pageQuery()` |
+| `count` | 计数 | `countByStatus()` |
+| `is` / `has` / `can` | 布尔判断 | `isValid()`, `hasPermission()` |
+| `check` / `validate` | 校验 | `checkDuplicate()` |
+| `convert` / `to` | 转换 | `convertToVO()`, `toDTO()` |
+
+### Git 提交规范（Conventional Commits）
 
--- ❌
-id BIGINT(20) AUTO_INCREMENT
 ```
+<type>(<scope>): <subject>
 
-### 9. R.ok() 返回 String 陷阱
-
-```java
-// ❌ 匹配 R.ok(String msg)，字符串进入 msg 而非 data
-return R.ok(token);  // {code:200, msg:"xxx", data:null}
+<body>
 
-// ✅ 明确指定
-return R.ok(null, token);        // data=token, msg=null
-return R.ok("获取成功", token);  // 都有值
+<footer>
 ```
 
-### 10. Entity 基类
-
-```java
-// ✅ 业务表（需多租户隔离）
-public class Xxx extends TenantEntity {
-    @TableId(value = "id")
-    private Long id;
-}
-
-// ✅ 系统表（不需多租户）
-public class SysClient extends BaseEntity { }
-
-// ❌ 不继承基类
-public class Xxx { }
+| type | 说明 |
+|------|------|
+| `feat` | 新功能 |
+| `fix` | 修复 Bug |
+| `docs` | 文档变更 |
+| `style` | 代码格式（不影响逻辑） |
+| `refactor` | 重构（非新功能、非修复） |
+| `perf` | 性能优化 |
+| `test` | 测试相关 |
+| `chore` | 构建/工具变更 |
+
+**示例**：
 ```
+feat(order): 新增订单导出功能
 
-### 11. @Cacheable 不可变集合
+支持按时间范围导出订单数据为 Excel 格式。
 
-```java
-// ❌ Redis 反序列化失败
-@Cacheable(value = "xxx")
-public List<String> listXxx() { return List.of("1", "2"); }
-
-// ✅ 可变集合包装
-@Cacheable(value = "xxx")
-public List<String> listXxx() { return new ArrayList<>(List.of("1", "2")); }
+Closes #123
 ```
 
-> **原因**：Jackson DefaultTyping.NON_FINAL 会为 `ImmutableCollections$List12` 添加类型信息，反序列化时导致 `ClassNotFoundException`。
+## 代码示例
 
-### 12. BO 映射注解
+### 统一响应格式
 
 ```java
-// ✅ 单目标：@AutoMapper
-@AutoMapper(target = Xxx.class, reverseConvertGenerate = false)
-public class XxxBo { }
-
-// ✅ 多目标：@AutoMappers
-@AutoMappers({
-    @AutoMapper(target = SysOperLog.class, reverseConvertGenerate = false),
-    @AutoMapper(target = OperLogEvent.class)
-})
-public class SysOperLogBo { }
-```
-
-### 13-14. 中文注释与 SQL COMMENT
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class Result<T> {
+    private int code;
+    private String message;
+    private T data;
+
+    public static <T> Result<T> ok(T data) {
+        return new Result<>(200, "success", data);
+    }
 
-```java
-// ✅ 中文注释
-/** 根据 ID 查询用户信息 */
-public SysUserVo queryById(Long id) {
-    // 查询用户基本信息
-    return baseMapper.selectVoById(id);
+    public static <T> Result<T> fail(int code, String message) {
+        return new Result<>(code, message, null);
+    }
 }
-
-// ❌ 英文注释
-/** Query user info by ID */
-```
-
-```sql
--- ✅
-`user_name` VARCHAR(50) NOT NULL COMMENT '用户名',
-) ENGINE=InnoDB COMMENT='用户信息表';
-
--- ❌
-`user_name` VARCHAR(50) NOT NULL COMMENT 'user name',
 ```
 
----
-
-## 命名后缀规范
-
-| 类型 | 后缀 | 示例 |
-|------|------|------|
-| 实体类 | 无/Sys前缀 | `SysUser`, `TestDemo` |
-| 业务对象 | Bo | `SysUserBo` |
-| 视图对象 | Vo | `SysUserVo` |
-| 服务接口 | IXxxService | `ISysUserService` |
-| 服务实现 | XxxServiceImpl | `SysUserServiceImpl` |
-| 控制器 | XxxController | `SysUserController` |
-| Mapper | XxxMapper | `SysUserMapper` |
-
-> 本项目是三层架构，没有 DAO 层。Service 直接注入 Mapper。
-
-## 方法命名
-
-| 操作 | Service 方法 | Controller URL |
-|------|-------------|----------------|
-| 分页查询 | `queryPageList(bo, pageQuery)` | `GET /list` |
-| 查询单个 | `queryById(id)` | `GET /{id}` |
-| 新增 | `insertByBo(bo)` | `POST /` |
-| 修改 | `updateByBo(bo)` | `PUT /` |
-| 删除 | `deleteWithValidByIds(ids)` | `DELETE /{ids}` |
-| 导出 | `queryList(bo)` + ExcelUtil | `POST /export` |
-
----
-
-## Git 提交规范
-
-```
-<type>(<scope>): <description>
-```
-
-| type | 说明 | 示例 |
-|------|------|------|
-| `feat` | 新功能 | `feat(system): 新增用户反馈功能` |
-| `fix` | 修复 | `fix(demo): 修复订单状态显示错误` |
-| `refactor` | 重构 | `refactor(common): 重构分页查询工具类` |
-| `perf` | 性能 | `perf(system): 优化用户列表查询性能` |
-| `docs` | 文档 | `docs(readme): 更新安装说明` |
-| `style` | 格式 | `chore` 构建/工具 | `test` 测试 |
-
----
-
-## 多项目适配
-
-| 特征 | RuoYi-Vue-Plus | leniu-tengyun-core |
-|------|----------------|-------------------|
-| 包名 | `org.dromara.*` | `net.xnzn.core.*` |
-| JDK | 17 | 21 |
-| 对象转换 | `MapstructUtils.convert()` | `BeanUtil.copyProperties()` |
-| 分页 | `TableDataInfo<T>` | `Page<T>` |
-| 异常 | `ServiceException` | `LeException` |
-| 工具库 | 自定义工具类 | Hutool |
-
-### leniu-tengyun-core 专用
+### 枚举定义规范
 
 ```java
-// 国际化
-throw new LeException(I18n.getMessage("user.not.exists"));
-
-// 租户上下文
-Long tenantId = TenantContextHolder.getTenantId();
-
-// 分页
-PageMethod.startPage(param.getPage().getPageNum(), param.getPage().getPageSize());
+@Getter
+@AllArgsConstructor
+public enum OrderStatusEnum {
+
+    PENDING(0, "待处理"),
+    COMPLETED(1, "已完成"),
+    CANCELLED(2, "已取消");
+
+    private final int code;
+    private final String desc;
+
+    public static OrderStatusEnum of(int code) {
+        for (OrderStatusEnum status : values()) {
+            if (status.code == code) {
+                return status;
+            }
+        }
+        throw new IllegalArgumentException("未知状态码: " + code);
+    }
+}
 ```
 
----
-
-## 相关 Skill
-
-| 需要了解 | 激活 Skill |
-|---------|-----------|
-| 后端 CRUD 开发 | `crud-development` |
-| API 开发 | `api-development` |
-| 数据库设计 | `database-ops` |
-| 系统架构 | `architecture-design` |
+## 常见错误
+
+| 错误 | 正确做法 |
+|------|---------|
+| URL 用动词：`/getOrder` | 用名词 + HTTP 方法：`GET /orders/{id}` |
+| 方法名含义不清：`process()` | 明确动作：`calculateTotalAmount()` |
+| 魔法数字：`if (status == 1)` | 用枚举或常量 |
+| 一个方法超过 80 行 | 拆分为多个私有方法 |
+| 注释描述"做了什么" | 注释描述"为什么这样做" |
+| Git 提交信息写"fix bug" | 写清楚修了什么：`fix(order): 修复金额计算精度丢失` |
+| Boolean 变量名：`flag` | 有意义的名字：`isActive`, `hasPermission` |
+| 缩写命名：`usr`, `mgr` | 完整命名：`user`, `manager` |

package/src/skills/collaborating-with-codex/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: collaborating-with-codex
 description: |
-  与 OpenAI Codex CLI 协同开发。将编码任务委托给 Codex 进行原型开发、调试分析和代码审查。
+  与 OpenAI Codex CLI 协同开发。支持 MCP 原生集成和桥接脚本两种模式。
+  默认模型：gpt-5.3-codex
 
   触发场景：
   - 需要算法实现或复杂逻辑分析
@@ -14,161 +15,143 @@ description: |
 
   前置要求：
   - 已安装 Codex CLI (npm install -g @openai/codex)
-  - 已配置 OpenAI API Key
+  - 已配置 OpenAI API Key (codex auth login)
 ---
 
 # 与 Codex CLI 协同开发
 
-> 通过 Python 桥接脚本调用 Codex CLI，获取算法实现和代码审查建议。
+> 两种调用方式：**MCP 原生集成**（推荐）和桥接脚本。默认模型 `gpt-5.3-codex`。
 
-## 快速开始
+---
 
-```bash
-# 相对路径（推荐，在项目根目录执行）
-python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py --cd . --PROMPT "Your task"
+## 方式一：MCP 原生集成（推荐）
+
+已通过 `codex-mcp-server` 注册为 Claude Code 的 MCP 工具，可直接在对话中使用。
+
+### MCP 工具列表
+
+| 工具 | 用途 | 示例指令 |
+|------|------|---------|
+| `codex` | AI 编码助手，支持会话、模型选择 | "用 codex 分析这个函数" |
+| `review` | 代码审查（未提交代码、分支、提交） | "用 codex review 检查 main 分支差异" |
+| `listSessions` | 查看活跃会话 | "列出 codex 会话" |
+| `ping` | 测试连接 | "ping codex" |
+
+### MCP 使用示例
+
+**基础调用**：直接在 Claude Code 对话中说：
+- "用 codex 工具分析 OrderInfoService 的业务逻辑"
+- "用 codex review 检查当前未提交的代码变更"
+- "用 codex 生成这个方法的单元测试，模型用 gpt-5.3-codex"
+
+**多轮会话**：codex 工具支持 `sessionId` 参数，自动维持上下文。
+
+**模型指定**：调用时传入 `model: "gpt-5.3-codex"` 参数（已配置为默认）。
+
+### MCP 配置位置
+
+```
+~/.claude.json → projects → mcpServers → codex-cli
+~/.codex/config.toml → profiles（review/analyze/prototype）
 ```
 
-**输出**: JSON 格式，包含 `success`、`SESSION_ID`、`agent_messages` 和可选的 `error`。
+---
+
+## 方式二：桥接脚本
+
+适用于需要精细控制参数或后台批量执行的场景。
+
+### 快速开始
+
+```bash
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd . --model gpt-5.3-codex --PROMPT "Your task"
+```
 
-## 参数说明
+### 参数说明
 
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 |------|------|------|--------|------|
 | `--PROMPT` | str | ✅ | - | 发送给 Codex 的任务指令（使用英语） |
 | `--cd` | Path | ✅ | - | 工作目录根路径 |
-| `--sandbox` | Literal | ❌ | `read-only` | 沙箱策略：`read-only`/`workspace-write`/`danger-full-access` |
+| `--model` | str | ❌ | `gpt-5.3-codex` | 指定模型 |
+| `--sandbox` | Literal | ❌ | `read-only` | 沙箱策略 |
 | `--SESSION_ID` | UUID | ❌ | `None` | 会话 ID（继续之前的对话） |
-| `--skip-git-repo-check` | bool | ❌ | `True` | 允许在非 Git 仓库运行 |
+| `--profile` | str | ❌ | `None` | Codex profile（review/analyze/prototype） |
 | `--return-all-messages` | bool | ❌ | `False` | 返回完整推理信息 |
-| `--image` | List[Path] | ❌ | `None` | 附加图片文件到提示词 |
-| `--model` | str | ❌ | `None` | 指定模型（仅用户明确要求时使用） |
-| `--yolo` | bool | ❌ | `False` | 跳过所有审批与沙箱限制（危险） |
+| `--image` | List[Path] | ❌ | `None` | 附加图片 |
+| `--yolo` | bool | ❌ | `False` | 跳过审批（危险） |
 
-## 使用模式
-
-### 1. 基础调用（只读模式）
+### 使用示例
 
 ```bash
+# 代码分析（只读）
 python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
-  --cd . \
-  --PROMPT "Analyze the authentication flow in the login module"
-```
-
-### 2. 多轮会话
+  --cd . --model gpt-5.3-codex --profile analyze \
+  --PROMPT "Analyze the four-layer architecture in OrderInfoWebController"
 
-**始终保存 SESSION_ID** 用于后续对话：
-
-```bash
-# 第一轮：分析代码
+# 代码审查
 python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
-  --cd "/project" \
-  --PROMPT "Analyze the AdServiceImpl class"
+  --cd . --model gpt-5.3-codex --profile review \
+  --PROMPT "Review OrderWebBusiness.java for bugs. OUTPUT: Review with line numbers."
 
-# 后续轮次：使用 SESSION_ID 继续
+# 生成 Diff 补丁
 python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
-  --cd "/project" \
-  --SESSION_ID "uuid-from-previous-response" \
-  --PROMPT "Now write unit tests for the add method"
-```
+  --cd . --model gpt-5.3-codex \
+  --PROMPT "Generate unified diff to add logging. OUTPUT: Unified Diff Patch ONLY."
 
-### 3. 获取 Unified Diff 补丁
-
-```bash
+# 多轮会话
 python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
-  --cd "/project" \
-  --PROMPT "Generate a unified diff to add logging to AdServiceImpl. OUTPUT: Unified Diff Patch ONLY."
+  --cd . --model gpt-5.3-codex \
+  --SESSION_ID "uuid-from-previous" \
+  --PROMPT "Now write unit tests for the method we discussed"
 ```
 
-### 4. 调试模式（返回完整信息）
+---
 
-```bash
-python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
-  --cd "/project" \
-  --PROMPT "Debug this error: NullPointerException in line 42" \
-  --return-all-messages
-```
+## Codex Profile 配置
 
-## 返回值结构
+已在 `~/.codex/config.toml` 中预设 3 个 profile：
 
-**成功时：**
-```json
-{
-  "success": true,
-  "SESSION_ID": "550e8400-e29b-41d4-a716-446655440000",
-  "agent_messages": "模型回复内容..."
-}
-```
+| Profile | 模型 | 沙箱 | 推理强度 | 适用场景 |
+|---------|------|------|---------|---------|
+| `review` | gpt-5.3-codex | read-only | medium | 快速代码审查 |
+| `analyze` | gpt-5.3-codex | read-only | high | 深度逻辑分析 |
+| `prototype` | gpt-5.3-codex | workspace-write | high | 原型生成 |
 
-**失败时：**
-```json
-{
-  "success": false,
-  "error": "错误信息描述"
-}
-```
-
-## 协作工作流
+---
 
-### 推荐场景
+## 协作分工原则
 
-| 场景 | 说明 |
-|------|------|
-| **后端逻辑分析** | Codex 擅长复杂算法和后端逻辑 |
-| **代码审查** | 获取代码质量和潜在问题的反馈 |
-| **Debug 分析** | 利用其强大的调试能力定位问题 |
-| **原型设计** | 快速获取实现思路（返回 Diff 而非直接修改） |
+| 角色 | Claude Code 负责 | Codex 负责 |
+|------|-----------------|-----------|
+| **架构** | 设计、决策、审校 | 分析现有代码 |
+| **开发** | 规范重构、最终代码 | 原型生成（Diff） |
+| **审查** | 规范检查、最终判定 | 逐文件审查、安全扫描 |
+| **调试** | 日志分析、定位 | 深度代码分析、补丁 |
 
 ### 重要约束
 
-1. **只读模式**: 始终使用 `--sandbox read-only`，禁止 Codex 直接修改文件
-2. **英语交互**: 与 Codex 交互时使用英语，获得更好效果
-3. **中文输出强制**: Codex 倾向于输出英文，必须在每次 PROMPT 末尾追加以下约束：
+1. **只读优先**: 默认 `read-only`，仅原型生成用 `workspace-write`
+2. **英语 Prompt**: 与 Codex 交互用英语
+3. **中文强制**: 每次 PROMPT 末尾追加：
    ```
    IMPORTANT LANGUAGE RULES:
-   - All SQL COMMENT values MUST be in Chinese (e.g., COMMENT '用户名' NOT COMMENT 'username')
-   - All Java/code comments (Javadoc, inline //, block /* */) MUST be in Chinese
-   - All field descriptions, table descriptions MUST be in Chinese
-   - Variable names and class names remain in English (camelCase/PascalCase)
+   - All SQL COMMENT values MUST be in Chinese
+   - All Java/code comments MUST be in Chinese
+   - Variable names and class names remain in English
    ```
-4. **Diff 输出**: 在 PROMPT 中明确要求 `OUTPUT: Unified Diff Patch ONLY`
-5. **重构代码**: 将 Codex 的输出视为"脏原型"，由 Claude 重构为生产代码（**特别检查注释和 COMMENT 是否为中文，不是则修正**）
-6. **后台运行**: 对于长时间任务，使用 `Run in the background`
-
-## 与本项目的集成
-
-### 典型用例：后端模块分析
-
-```bash
-# 分析 Service 层实现
-python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
-  --cd . \
-  --PROMPT "Analyze the three-layer architecture (Controller -> Service -> Mapper) in ruoyi-modules/ruoyi-system. Focus on how buildQueryWrapper is implemented in Service layer."
-```
-
-### 典型用例：代码审查
+4. **脏原型思维**: Codex 输出视为草稿，Claude 按项目规范重构
+5. **后台运行**: 长时间任务用 subagent `run_in_background`
 
-```bash
-# 审查新增的业务模块
-python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
-  --cd "/project" \
-  --PROMPT "Review the XxxServiceImpl.java for potential bugs, security issues, and adherence to the project's three-layer architecture pattern (Controller -> Service -> Mapper, NO DAO layer). OUTPUT: Review comments with specific line numbers."
-```
-
-## 安装前置
-
-```bash
-# 安装 Codex CLI
-npm install -g @openai/codex
-
-# 配置 API Key（可选，如果未设置环境变量）
-codex auth login
-```
+---
 
 ## 故障排除
 
 | 问题 | 解决方案 |
 |------|---------|
-| `codex: command not found` | 确保已安装并添加到 PATH |
-| `SESSION_ID` 获取失败 | 检查网络连接和 API Key |
-| 输出被截断 | 使用 `--return-all-messages` 获取完整信息 |
-| Windows 路径问题 | 使用正斜杠 `/` 或双反斜杠 `\\` |
+| MCP 工具未出现 | 重启 Claude Code 会话，检查 `~/.claude.json` |
+| `codex: command not found` | `npm i -g @openai/codex` 并确认 PATH |
+| 模型不对 | 调用时显式传 `model: "gpt-5.3-codex"` |
+| MCP 连接超时 | `npx -y codex-mcp-server` 手动测试 |
+| 桥接脚本 SESSION_ID 失败 | 检查网络和 API Key |