📋 Assignment Helper

一个 .docx 进去，一份结构化要点清单出来。

老师发 5000 字 Word → 你花 30 秒扫一眼 → 直接喂给 AI 生成作业

---

---

✨ 核心亮点

🚀 一条命令	🤖 多 Agent 并行	📸 读懂图片	🎯 7 区块全覆盖
/assignment-helper	3 个 Agent 同时分析	提取文档嵌入图片	格式→内容→提交→评分

场景： 临近期末，老师发了一份 8 页的课程设计文档。字体、行距、章节、截止日期、提交格式、查重规则、评分标准全混在一起。你要一条条翻着找，还要手动整理成 prompt 喂给 AI——现在不用了。

---

🎬 快速开始

1. 安装依赖

pip install python-docx Pillow

2. 在 Claude Code 中解析作业

/assignment-helper 老师发的作业.docx

3. 查看输出

cat output/老师发的作业_结构化.md

4. 复制末尾 AI 提示词 → 喂给 ChatGPT / Claude → 收工 🎉

---

📖 输出示例

解析完成后，你会得到这样一份结构化工整的 Markdown 文件：

# 📋 专业综合设计 — 结构化要点

## 📌 任务概述
设计并实现一个基于 Spring Boot 的图书管理系统，包含借阅、归还、查询等功能。

## 📐 格式与字体要求
| 项目 | 要求 |
|------|------|
| 字体 | 正文宋体小四，标题黑体三号 |
| 行距 | 1.5 倍行距 |
| 页边距 | 上 2.5cm 下 2.0cm 左 3.0cm 右 2.0cm |
| 标题格式 | 一级黑体三号加粗，二级黑体四号 |

## 📝 内容要求
### 必须包含的章节
1. **需求分析** — 用例图 + 功能描述
2. **系统设计** — 架构图 + 数据库 ER 图
3. **详细设计** — 核心模块流程图
4. **测试报告** — 单元测试 + 集成测试

### 字数限制
正文不少于 8000 字（不含代码和图表）。

## 📊 图表、代码与其他附加要求
- 用例图、类图、ER 图共 ≥ 5 张
- 核心代码片段需加注释说明
- 参考文献 ≥ 10 篇，格式 GB/T 7714

## 📦 最终提交要求
| 项目 | 说明 |
|------|------|
| 截止日期 | 2026-06-30 23:59 |
| 提交方式 | 教学平台 + 邮箱一份 |
| 文件命名 | 学号_姓名_课程设计.zip |
| 打包格式 | .zip，含论文 PDF + 源码 |

## ⚠️ 评分标准
| 评分项 | 分值 | 说明 |
|--------|------|------|
| 论文质量 | 50 分 | 结构完整、逻辑清晰 |
| 程序实现 | 30 分 | 功能完整、可运行 |
| 答辩表现 | 20 分 | 表达清晰、回答问题准确 |

## 🤖 AI 提示词
（可直接复制喂给 ChatGPT / Claude）

---

🏗️ 原理

三层流水线，各司其职：

  📄 .docx 文件
       │
       ▼
┌─────────────────────────────────────────────┐
│  ① 解析层                                    │
│  extract_docx.py                            │
│  提取文本 + 表格 + 嵌入图片 → JSON           │
└─────────────────────────────────────────────┘
       │ 文本 JSON + 图片
       ▼
┌─────────────────────────────────────────────┐
│  ② 分析层（3 Agent 并行）                   │
│  🔍 格式猎手    📝 内容拆解    📦 提交评分  │
│  字体/行距等     章节/功能/       截止/命名/  │
│                  图表要求         评分标准    │
│  每个 Agent 同时读文本 + 看图片              │
└─────────────────────────────────────────────┘
       │ 3 份分析 JSON
       ▼
┌─────────────────────────────────────────────┐
│  ③ 合成层                                    │
│  去重 → 互补 → 按 7 区块模板输出            │
└─────────────────────────────────────────────┘
       │
       ▼
  📋 output/xxx_结构化.md

---

📁 项目结构

.
├── README.md               # 本文件
├── CLAUDE.md               # 项目规范
├── .claude/
│   └── skills/
│       └── assignment-helper/SKILL.md   # Skill 定义
├── src/
│   └── extract_docx.py     # Word 解析：文本 + 图片提取
├── output/                 # 生成的结构化文档（不提交）
├── temp/                   # 临时图片缓存（用完即删）
└── tests/                  # 测试用样本 docx

---

🛠️ 依赖

依赖	用途
Python 3.10+	运行环境
python-docx	解析 .docx 文件
Pillow	提取嵌入图片
Claude Code	Skill 宿主，多 Agent 调度

pip install python-docx Pillow

---

📝 License

MIT — 随便用，提个 Issue 就更好了。

---

⚡ 省下的时间去打游戏，别翻作业文档了。