79 lines
2.4 KiB
Markdown
79 lines
2.4 KiB
Markdown
# 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` 等文件后
|
||
- **每次操作只记录一次**：同一批修改合并为一条记录
|
||
|
||
### 记录格式
|
||
|
||
```markdown
|
||
### YYYY-MM-DD HH:MM:SS - 阶段名称
|
||
- **范式步骤：** 阶段描述（如：功能开发、测试、修复、文档、配置管理）
|
||
- **修改摘要：** 简要说明做了什么
|
||
- **涉及文件：** 列出主要修改的文件路径
|
||
- **使用模型：** deepseek
|
||
```
|
||
|
||
### 阶段分类
|
||
|
||
| 阶段 | 说明 |
|
||
|------|------|
|
||
| 功能开发 | 新增功能、模块、API |
|
||
| 测试 | 单元测试、集成测试、E2E 测试 |
|
||
| 修复 | Bug 修复、代码审查问题修复 |
|
||
| 文档 | README、设计文档、注释 |
|
||
| 配置管理 | .gitignore、配置文件、工具集成 |
|
||
|
||
### 示例
|
||
|
||
```markdown
|
||
### 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 使用日志（自动维护）
|
||
```
|