Textbook Weaver — Git skill for Claude Code

textbook-weaver —— 多源教材合编与校验

把若干部同主题教材（不同版本、不同侧重）合编为一部 LaTeX 新教材，并配一份与教材印刷题号逐一对应的习题解答。 要求：可追溯（每处内容能指回源书与页码）、可复核（关键数值可独立重算）、可检查（机械门禁 + 换人复核）、可付印 （版面、字体、书签、空白页）。

用户的常规操作只有两步：把资料放进一个目录、在会话里提出需求。安装、页码偏移实测、配置写入、门禁执行与 错误修复均由助手完成。本文档中的命令是助手与 CI 的等价入口。

版本状态（0.1.0，2026-09-22）

已验证：

• 四家 harness 的接入与功能验收：Claude Code 2.1.270、Codex 0.154.0-alpha.6.2、DeepSeek Harness 0.1.0-rc.6、Pi 0.87.0。
• DeepSeek Harness 上的目标驱动无人值守：两节解答自主完成，覆盖率门禁退出码 0，使用子代理。
• 读图（扫描件页码确认、逐页读图提纲要）：需要模型支持图像输入（多模态），四家均实测通过； 换成支持图像的模型即可，换法见验收报告。

未验证或需注意：

• MCP 工具服务与 Pi 扩展包默认不挂载（可选路径，见手册 §4）。
• 无人值守的范围由目标的判据决定：判据为「覆盖率门禁通过」时，不含编译、机械审计、付印终检与抽查。
• 成本量级：接入一本书约 1–2 次短会话；每节解答约 2 次模型调用（撰写 + 复核）。

完整验收记录、四维审查与残留风险见 [`docs/ACCEPTANCE-REPORT.md`](docs/ACCEPTANCE-REPORT.md)。

快速开始

git clone https://github.com/LazyCharles07/textbook-weaver.git
cd textbook-weaver

python install.py --yes                          # 1) 全局安装（不带 --yes 为预览）
python init.py --book <你的 LaTeX 书稿目录> --yes  # 2) 生成配置、习题清单与解答骨架
python core/tools/check_installs.py              # 3) 接入自检（0 缺口即就绪）

之后在任何项目中调用：`/textbook-weaver <需求>`。四家命令名相同，但提供方式不同——Claude Code 与 DeepSeek Harness 由技能提供，Codex 与 Pi 由提示词模板提供（对照表见 [`QUICKSTART.md`](QUICKSTART.md) §1）。不用助手时，等价命令为 `python core/tools/run_pipeline.py --config config.toml --stage gates`。

• 接入与常用口令：`QUICKSTART.md`
• 九类现实难题的处理方式：`docs/SCENARIOS.md`
• 配置字段、排错、工具速查、FAQ：`docs/REFERENCE-MANUAL.md`

仓库结构

层	内容	面向
内容层 core/	方法论 11 篇、角色提示词 14 份、体例与流程模板 5 份、LaTeX 模板 7 份、Python 工具 21 个、自撰演示工程	任何 harness、任何操作系统；也可纯手工使用
扩展层 extensions/	三个 TypeScript 包：MCP 工具服务、DeepSeek Harness 插件、Pi 扩展	需要「工具进原生列表 + 自动门禁」的生态

本仓库只含方法与工具，不含任何教材内容。使用者需自备合法素材；合编产物属演绎作品，公开发布前请阅读 [`core/references/copyright-boundary.md`](core/references/copyright-boundary.md)。

core/                          内容真源（内容改动只在此处）
├── SKILL.md                   技能入口：任务路由表、八环节、三条硬规则
├── references/ (11)  prompts/ (14)  specs/ (