课程目标达成情况分析表生成工具 v5.3

> 🎯 设计模式: Generator + Reviewer + Pipeline

> 📁 代码文件: achievement_generator.py

> 🔍 审查脚本: scripts/review_document.py

> 📖 公式参考: references/grading-formula.md

🚀 快速开始

Pipeline 一键执行（推荐）

# 生成 + 审查（自动执行）
python3 achievement_generator.py --pipeline "C#程序设计-23级软工.xls"

# 或分步执行
python3 achievement_generator.py "C#程序设计-23级软工.xls"
python3 scripts/review_document.py "C#程序设计-23级软工-课程目标达成情况分析表.docx"

单独使用

# 生成文档
python3 achievement_generator.py <Excel文件>

# 审查文档
python3 scripts/review_document.py <输出文件.docx>

📁 目录结构

achievement-qztc/
├── SKILL.md                      # 本文件
├── achievement_generator.py       # 主生成器（Generator模式）
├── scripts/
│   └── review_document.py        # 质量审查（Reviewer模式）v2.0
└── references/
    └── grading-formula.md        # 评分公式（Tool Wrapper）

🔄 Pipeline 工作流

┌─────────────────────────────────────────────────────────────┐
│  STEP 1: 生成 (Generator)                                  │
│  python3 achievement_generator.py <Excel>                    │
│       ↓                                                    │
│  ✅ CHECKPOINT 1: 文件生成成功？                             │
│       ↓                                                    │
│  STEP 2: 审查 (Reviewer)                                   │
│  python3 scripts/review_document.py <输出.docx>             │
│       ↓                                                    │
│  ✅ CHECKPOINT 2: 所有检查项通过？                          │
│       ↓                                                     │
│  STEP 3: 交付                                              │
└─────────────────────────────────────────────────────────────┘

📊 表格与图表

🔧 审查检查项（Reviewer模式）

📐 评分公式

# 权重和目标配置均从模板表7动态读取（不再硬编码）
# read_weights_and_config_from_template(doc) →
#   weights: 表7 Row 2 的 col3/col4/col5
#   target_config: 表7 各目标理论满分行 (Row 4/7/10/13) 的 col3/col4/col5
#   total = col3×权重.col3 + col4×权重.col4 + col5×权重.col5

# 达成度 = 目标得分 / 理论满分（total）

⚠️ 重要笔记

表8平均行结构

序号 | 学号 | 姓名 | 目标1得分 | 目标1达成值 | 目标2得分 | 目标2达成值 | ...
平均 | 平均 | 平均 | 得分平均  | 达成度平均  | 得分平均  | 达成度平均  | ...

图表数据

• Chart1-4: 每学生达成度（0-1范围）
• Chart5: 各目标平均达成度百分比（0-100范围）

📦 依赖

import pandas as pd
from docx import Document
import zipfile
from lxml import etree

🔄 更新日志

v5.2 - 2026-04-09 - 权重和目标配置从模板表7动态读取

v5.0 - 2026-03-28 - Generator + Reviewer + Pipeline