Textbook init

Skill cabbage2000-lab/textbook-writer-skills/skills/textbook-init

Use when starting a textbook project and the author wants to plan and scaffold the working directory before writing — 规划单本教材项目目录或多教材工作区，可选 git 版本管理与 README 工作说明 — e.g. "初始化教材项目"、"创建教材工作目录"、"规划教材工作区"、"建一个写教材的目录". Only creates the directory scaffold and hands off to textbook; never creates pipeline files (.progress.json、00-教材设计.md、术语表.md). Not for writing textbook content (use textbook — 不经 init 它也会自建默认目录), not for resuming an existing project (directly use textbook).From its SKILL.md

Install

npx -y skills add cabbage2000-lab/textbook-writer-skills --skill textbook-init

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

5.6 KB, ~1.8k tokens by cl100k_base, as published. Nobody here has run it

textbook-init

动笔前的工作目录规划师：一轮提问弄清作者要写一本还是多本、放在哪里、要不要版本管理，呈现目录方案等确认后创建目录骨架（可含 git 仓库与 README 工作说明），最后把作者交给 textbook 主流程开写。教材项目内部的文件构成以 ../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 一轮收集四项（触发语已说明的项不再问）：

教材名：如《线性代数入门》——将成为项目目录名；
规划范围：a) 只写这一本 b) 未来还会写多本（追加：工作区名，默认"教材工作区"）；
位置：项目/工作区建在哪个目录下，默认当前目录 ./；
git 版本管理：默认要（教材写作周期以周计，版本保护值回票价）；作者明确不要则跳过。

若当前环境没有 AskUserQuestion 工具，降级为编号提问并等待文本回复：

请回答以下问题（回复格式如 "1 线性代数入门 2b 教材工作区 3 ./ 4 要"）：
1. 教材名？
2. 规划范围？ a) 只写这一本  b) 未来还会写多本（请给工作区名，默认"教材工作区"）
3. 建在哪个目录下？（默认当前目录 ./）
4. 要 git 版本管理吗？（默认要）

按语义宽松解析回复，只就有歧义的一项追问。

第 2 步：方案呈现与确认

按 references/workspace-layout.md 第 1、2 节的布局规则组装方案，完整呈现后停下：

目录树预览：含流水线随后会生成的文件，逐项注明"由 textbook 流水线创建"——让作者看到最终形态，同时不误以为本 skill 会建它们；
关键选择及理由：单本还是工作区分层、git 建在哪一层、.gitignore 为什么不忽略 .progress.json；
停点格式沿用契约文档第 5 节：

⏸ 等待确认：工作目录方案（回复"确认"开始创建，或直接提出修改）

作者提出修改 → 更新方案后重新完整呈现再等确认，循环直到明确确认；"确认，但把位置改一下"这类混合答复按修改分支处理（修改优先于确认，判定语义同契约文档第 5 节）。确认前不创建任何东西。

第 3 步：创建与交接

建目录：按确认的方案 mkdir -p；
git 判重：在目标位置检查是否已处于某个 git 仓库内（方法见 references/workspace-layout.md 第 3 节）——已在，则跳过 git init 并向作者说明原因；
git 初始化（作者要 git 且未命中判重）：git init + 写 .gitignore + 首次提交，层级与内容规范见 references/workspace-layout.md 第 3、4 节；
README 工作说明：按 references/workspace-layout.md 第 5 节模板实例化——所有字段填当前项目的真实值，写完通读确认没有残留尖括号或待填空白；
打印成果与下一步指引：

✅ 工作目录就绪：<实际路径>
接下来对我说：写教材《<教材名>》，落盘目录用 <项目目录路径>
（textbook 会在该目录里创建 .progress.json 并从教学定位开始五阶段流程）

安全边界

目标目录已存在且非空：呈现现有内容清单，绝不覆盖、移动或删除任何既有文件；其中若发现 .progress.json，说明这是进行中的教材项目，提示作者直接对 textbook 说续写，本 skill 就此打住；
README / .gitignore 已存在：保留原文件不动，仅提示作者自行核对是否需要补充；
本 skill 的全部动作只增不删：创建目录、创建新文件、git init 与提交——不含任何删除、移动、覆盖操作。

What ships with it: 1 file

5.4 KB alongside SKILL.md

references/

workspace-layout.md5.4 KB