textbook-initlisted
Install: claude install-skill cabbage2000-lab/textbook-writer-skills
# textbook-init
动笔前的工作目录规划师:一轮提问弄清作者要写一本还是多本、放在哪里、要不要版本管理,呈现目录方案等确认后创建目录骨架(可含 git 仓库与 README 工作说明),最后把作者交给 textbook 主流程开写。教材项目内部的文件构成以 [../textbook/references/handoff-contract.md](../textbook/references/handoff-contract.md)(下称"契约文档")第 3 节为唯一权威定义,本 skill 只引用不重复定义。
## 何时不触发
- 已有教材项目要续写(目录里有 `.progress.json`)——直接用 textbook,它会按状态文件定位续点;
- 作者直接开写、不关心目录规划——textbook 启动时自会询问一次并默认 `./<教材名>/`,无需先走本 skill;
- 整理与教材写作无关的目录——本 skill 只服务教材项目的开局。
## 与流水线的关系
本 skill 只独立触发:不被 textbook 调度,不进五阶段契约链,产出是"就绪的空工作目录 + 启动指引"。
**流水线文件一律不建不改**:`.progress.json`(主 skill 是唯一写者,这是项目红线)、`00-教材设计.md`(textbook-outline 写入)、`NN-<章标题>.md`(逐章生成)、`术语表.md`(主 skill 追加维护)。动机:主 skill 的重入判定靠"这些文件存不存在、内容有没有"定位续点(契约文档第 4 节),预建空文件会让它把全新项目误判成半成品;空壳文件混进交付物也违背"交付即可用"的底线。本 skill 创建的只有目录本身、`.gitignore` 和 README 工作说明——均在契约之外。
## 工作流
### 第 1 步:一轮提问
用 AskUserQuestion **一轮**收集四项(触发语已说明的项不再问):
1. **教材名**:如《线性代数入门》——将成为项目目录名;
2. **规划范围**:a) 只写这一本 b) 未来还会写多本(追加:工作区名,默认"教材工作区");
3. **位置**:项目/工作区建在哪个目录下,默认当前目录 `./`;
4. **git 版本管理**:默认要(教材写作周期以周计,版本保护值回票价);作者明确不要则跳过。
若当前环境没有 AskUserQuestion 工具,降级为编号提问并等待文本回复:
```text
请回答以下问题(回复格式如 "1 线性代数入门 2b 教材工作区 3 ./ 4 要"):
1. 教材名?
2. 规划范围? a) 只写这一本 b) 未来还会写多本(请给工作区名,默认"教材工作区")
3. 建在哪个目录下?(默认当前目录 ./)
4. 要 git 版本管理吗?(默认要)
```
按语义宽松解析回复,只就有歧义的一项追问。
### 第 2 步:方案呈现与确认
按 [references/workspace-layout.md](references/workspace-layout.md) 第 1、2 节的布局规则组装方案,完整呈现后停下:
- **目录树预览**:含流水线随后会生成的文件,逐项注明"由 textbook 流水线创建"——让作者看到最终形态,同时不误以为本 skill 会建它们;
- **关键选择及理由**:单本还是工作区分层、git 建在哪一层、`.gitignore` 为什么