cobol-java-v3/CLAUDE.md

COBOL Test Data Generator — 项目指令

代码审查（自动触发）

本项目集成了 code-review skill（位于 .claude/skills/code-review/）。

触发规则

• 自动触发：AI 生成或修改 .py / .cbl / .cpy / .lark 文件后，自动执行 code-review
• 手动触发：说 "审查代码"、"review"、"验收"、"检查代码"

review 流程

1. Layer 1：链分解（Interface / Business / Data / Utility / Error / Security / Performance）
2. Layer 2：量化指标（需求覆盖、异常分支、SQL风险等）
3. Layer 3：优化标准 + 输出 HTML 报告

严重级别

级别	含义	处理
🔴 Blocker	必须立即修复	❌ FAIL，不可合并
🟡 Major	合并前应修复	⚠️ 建议修复
🔵 Minor	可后续优化	—

配置

参见 .code-review.yaml 调整 review 严苛程度（fast / standard / strict）。

AI 使用日志（自动执行）

每次创建或修改代码文件后，必须在项目根目录的 _AI_USAGE_LOG.md 中追加一条记录。

触发规则

• 自动触发：AI 生成或修改 .py / .cbl / .cpy / .lark / .md 等文件后
• 每次操作只记录一次：同一批修改合并为一条记录

记录格式

### YYYY-MM-DD HH:MM:SS - 阶段名称
- **范式步骤：** 阶段描述（如：功能开发、测试、修复、文档、配置管理）
- **修改摘要：** 简要说明做了什么
- **涉及文件：** 列出主要修改的文件路径
- **使用模型：** deepseek

阶段分类

阶段	说明
功能开发	新增功能、模块、API
测试	单元测试、集成测试、E2E 测试
修复	Bug 修复、代码审查问题修复
文档	README、设计文档、注释
配置管理	.gitignore、配置文件、工具集成

示例

### 2026-08-22 16:30:00 - 功能开发
- **范式步骤：** 新增用户登录接口
- **修改摘要：** 添加 login.py 和相关测试
- **涉及文件：** `cobol_testgen/login.py`, `tests/test_login.py`
- **使用模型：** deepseek

项目结构

cobol_testgen/         # 核心代码
test-data/             # 测试套件
benchmark-programs/    # 测试基准（58 电信程序）
.claude/skills/        # 项目级 skills
.code-review.yaml      # code-review 配置
_AI_USAGE_LOG.md       # AI 使用日志（自动维护）