# Homework Solver Skill
<div align="center">
## 作业.SKILL
---
"你以为你累得像条狗，你错了，狗并没有你这么累。
——鲁迅"
<img src="assets/homework-skill-readme.jpg" alt="作业，我有四不写" width="220" />
[](LICENSE)
[](https://claude.ai/code)
[](https://agentskills.io)
[](#中文)
[中文](#中文) | [English](#english)
</div>
---
## 中文
当代大学生的作业困局，大抵是复制粘贴问AI，深度思考等答案，彻底沦为的“AI搬运工”，在无意义的循环里自我内耗，徒留一身疲惫与空洞。
作业.SKILL 横空出世✨ 予你一支 AI 专家天团，将写作业的繁琐流程尽数自动化：轻传一份作业 PDF，低语一句“帮我完成这份作业”，余下所有，皆有它从容代劳。
平行子 Agent 各司其职、分工解题，每题皆有独立 Agent 严谨验算，终有组装 Agent 凝智成篇，直接给你 PDF 格式答案，全程丝滑流畅、精准无误，恰如写作业本就该有的模样。
以科技破局“古法写作业”的困境，作业.SKILL 愿你不被琐事裹挟，往后作业无忧，步履皆欢。
作者亲力亲为，在完成 114514 份作业的疲惫征程中幡然醒悟，耗尽心力打磨出这份大学生懒人福音——作业.SKILL。
当他人仍在案前埋首，与作业苦苦纠缠、步履维艰时，你早已弹指间秒完任务，煮一壶清茶，赴一场悠闲下午茶之约，尽显降维打击的从容。
### 安装
复制粘贴给 OpenCode / Claude Code / 其他 LLM agent：
```text
Fetch and follow instructions from:
https://raw.githubusercontent.com/Li-Baichuan-James/homework-skill/main/INSTALL.md
```
### 快速开始
别再古法复制粘贴/截图问网页版AI，现在一句话就能让CLI Agent帮你完成作业：
1. 严格按 `INSTALL.md` 完成安装与验证 （让Agent自己配置）：
```text
https://raw.githubusercontent.com/Li-Baichuan-James/homework-skill/main/INSTALL.md
```
2. 在会话里直接说你要完成作业即可（不必显式提到这个 skill 名称）。比如：
```text
帮我完成这份作业。
```
3. 若你只做部分题，也直接自然描述需求即可。例如：
```text
只帮我做第 2 题和第 4 题，并生成答案文件。
```
4. 可以指定答案的语言/详略风格 （默认为英语+详细风格）。例如：
```text
使用中文/英文/中英双语作答。 使用考场式简练风格/讲解式详细风格。
```
### 用户侧流程（你会看到什么）
1. 主 Agent 先读 PDF，不会直接“闷头开算”
2. 若题面不清楚，会先问，不会硬猜
3. 每题先解再验，没通过验算的题不会进入最终文档
4. 最后输出文件并报告验证结果
### 核心特性
优雅摆烂：
- **题级核验**：每个题组都必须经过 solver phase 和 verifier phase
- **严格顺序**：读题 -> 分题 -> 解题 -> 验题 -> 组装 -> 构建 -> 最终验收
- **可移植**：不强依赖其他自定义 skills；没有 subagent 也能顺序执行
- **防“假完成”**：二次核验，独立验收
### 安装与兼容性说明
完整的安装、验证、`pdf` companion 要求、以及 LaTeX 环境检查都以 `INSTALL.md` 为准：
```text
https://raw.githubusercontent.com/Li-Baichuan-James/homework-skill/main/INSTALL.md
```
### 与 `pdf` skill 的配合
- `homework-solver` 默认把 `pdf` 视为唯一配合使用的 companion skill。
- `pdf` skill 负责 PDF 读取、提取、OCR、页面内容确认等输入侧工作。
- `homework-solver` 负责题目拆分、解题、画图、逐题验算、组装答案文档、构建 `.tex/.pdf`、以及最终交付验证。
- 换句话说：`pdf` 先把题读清楚，`homework-solver` 再把整份作业做完。
---
## English
`homework-solver` is a workflow-driven skill for engineering and mathematics homework PDFs.
It enforces a strict controller workflow: parse the assignment, solve one question group, verify that same group with a fresh verifier, pass the question gate, then assemble and validate deliverables.
### Installation
Tell your LLM agent:
```text
Fetch and follow instructions from:
https://raw.githubusercontent.com/Li-Baichuan-James/homework-skill/main/INSTALL.md
```
### Intended Use
- Solve a full homework PDF
- Solve selected questions only (for example, Q2 and Q4)
- Produce submission-ready solution artifacts (typically `.tex` and `.pdf`)
- Include required figures, pseudocode, and structured tables when requested
### Design Principles
- **Question-level gates**: each included question group must pass both solver and verifier phases
- **Per-group sequencing**: do not solve all questions first and verify later in a batch
- **Deterministic workflow**: read -> decompose -> solve -> verify -> gate -> normalize -> assemble -> build -> final verification
- **Strict skill boundary**: only `pdf` may be used alongside this skill
- **Verification discipline**: successful compilation is not treated as proof correctness
### Quick Start
1. Install and validate strictly via `INSTALL.md`:
```text
https://raw.githubusercontent.com/Li-Baichuan-James/homework-skill/main/INSTALL.md
```
2. In your session, simply ask for the homework to be completed. You do not need to mention the skill name explicitly. For example:
```text
Help me finish this homework.
```
For partial scope, describe the subset naturally. For example:
```text
Please solve only Q2 and Q4 and generate the solution files.
```
### What Users Should Expect
1. The agent reads and extracts the PDF before solving.
2. Unreadable or ambiguous prompt content is escalated instead of guessed.
3. Each question group is solved and then independently verified by a fresh verifier before assembly.
4. If you ask to complete the homework and do not opt out, the default deliverable is a written answer document with `.tex` and compiled `.pdf` artifacts.
5. Final output includes artifacts plus explicit verification status.
### Portability Notes
For setup, validation, `pdf` companion requirements, and LaTeX environment checks, use `INSTALL.md` as the source of truth:
```text
https://raw.githubusercontent.com/Li-Baichuan-James/homework-skill/main/INSTALL.md
```
### How It Cooperates With `pdf`
- `pdf` handles PDF-side work such as extraction, OCR, and recovering readable question text.
- `homework-solver` then handles decomposition, solving, required figures, verification, answer-sheet assembly, and artifact validation.
- In short: `pdf` helps the agent read the assignment correctly, and `homework-solver` governs how the solved deliverable is produced.
### Repository Contents
- `SKILL.md`: canonical skill specification and workflow gates
- `README.md`: publication-facing overview and usage guide
### License
MIT License