# Document Compiler

> 将多个章节和练习题汇编成完整教材，添加封面、目录、排版优化

- Skill: `ghostricke9/document-compiler` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add ghostricke9/document-compiler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ghostricke9/document-compiler/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Ghostricke9 (https://skillmd.com/u/ghostricke9)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ghostricke9/document-compiler

---


## 技能：汇编最终教材

### 何时使用
当你已经完成所有章节的编撰和练习题的生成，需要将它们组装成一本完整、排版精良的教学教材时，调用此技能。

### 子资源文件

本技能目录下附带辅助资源，可按需使用：

| 文件 | 用途 | 何时使用 |
|------|------|----------|
| `templates/cover.md` | 教材封面模板 | 组装教材时引用，生成统一的封面页 |
| `templates/style_guide.md` | 排版风格指南 | 统稿时参考，确保全书风格一致 |
| `scripts/word_counter.py` | 字数统计脚本 | 执行 `python {skill_dir}/scripts/word_counter.py <file>` 检查篇幅 |

### 汇编步骤

1. **统稿**：阅读所有已生成的章节，检查术语一致性
   - 同一概念在不同章节是否用了相同叫法
   - 示例代码的变量命名风格是否一致
   - 参考 `templates/style_guide.md` 中的规范

2. **生成封面**：为教材添加标准封面
   - 使用 `templates/cover.md` 中的模板
   - 填入主题名称、章节数、生成日期

3. **组装目录**：为整本教材生成目录
   - 列出所有章节标题和对应页码（可用 Markdown 锚点替代）

4. **编排顺序**：按以下顺序组装最终教材：
   ```
   封面 → 目录 → 学习路线图（如有）→ 第1章 → 练习题1
   → 第2章 → 练习题2 → ... → 附录/参考资料
   ```

5. **控制篇幅**：统稿后如果某章过长或过短，可以用 `scripts/word_counter.py` 检查并调整

### 输出格式

最终教材使用以下 Markdown 结构：

```markdown
# [教材名称]

> **编著**: StudyHelper Agent
> **日期**: YYYY-MM-DD
> **章节**: N章 | **配套练习**: N套

---

## 目录

1. [第1章: 标题](#第1章)
   - 练习题
2. [第2章: 标题](#第2章)
   - 练习题
...

---

## 第1章: [标题]

[正文内容]

---

## 练习题: [第1章名称]

[练习题内容]

---

## 第2章: [标题]

...
```

### 完成动作
汇编完成后，使用 `save_document` 将完整教材保存为 Markdown 文件。