教材写作·项目初始化

SKILL开发
开发 未标注权限 许可证不明确
安装这个技能

动笔写教材前要先规划并创建工作目录时用它:规划单本教材项目目录或多教材工作区,可选 git 版本管理与 README 工作说明,建好后把产出交接给 textbook。触发语如"初始化教材项目"、"创建教材工作目录"、"规划教材工作区"、"建一个写教材的目录"。只搭目录骨架,不创建流水线文件(.progress.json、00-教材设计.md、术语表.md)。写正文用 textbook(不经 init 它也会自建默认目录),续写已有项目直接用 textbook。需与 textbook 系列其余 skill 装在同一 skills 目录下。

一句话选型结论

按资料字段整理

教材写作·项目初始化是开发类的 Agent Skill,安装方式未标注,权限级别未标注,许可证不明确,有可直接复制的安装命令。技能本质是给模型读的说明书,效果取决于模型与客户端;装完先用一个小任务验证,再放进正式流程。

分类开发 安装方式未标注 权限级别未标注权限 许可证许可证不明确
累计安装 未标注 本周 未标注
GitHub 星标 未标注 仓库 未标注
下载量 未标注 技能市场下载数
权限级别 未标注权限 安装前请确认风险范围
许可证 许可证不明确 未说明

安装

未标注
在支持 Skills 的客户端里执行,装完问一句「你有哪些技能」验证
skillhub install user_6733bad6/textbook-init
  1. 1
    确认客户端支持

    确认你的客户端支持 Skills(Claude、Codex、Cursor 等),并升级到较新的版本。

  2. 2
    拿到技能文件

    执行上面的命令安装;也可以把仓库里的 SKILL.md 手动放进客户端的 skills 目录。

  3. 3
    刷新技能列表

    重新打开客户端,或刷新技能列表,让新放进来的技能被加载。

  4. 4
    验证是否生效

    问一句「你有哪些技能」,确认列表里出现它,再拿一个小任务试跑。

技能档案

开发
字段来自技能仓库与公开索引,中文说明由本站标注
作者 / 维护方user_6733bad6仓库 未标注 · 版本 未标注
宿主客户端未标注技能可被这些客户端加载
安装方式未标注安装包 community
权限级别未标注权限安装前请确认风险范围
许可证未说明许可证不明确,商用前请自行确认条款
仓库可用性available技能仓库当前是否可访问
最近核验2026-11-06上游最后核验时间 · 数据更新 2026-11-06
正文体量6.0 KBSKILL.md 原文大小,越大说明说明书写得越细

典型使用场景

3 类
按分类整理的常见用法,具体以 SKILL.md 为准
写代码与改 bug

按需求补代码、定位并修掉报错。

读仓库与生成改动

让模型读懂项目结构,再给出可落地的改动。

跑测试与排查故障

按现象排查问题,补测试用例并复跑。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有标注权限级别,实际能做什么要装好后确认。
  • 许可证不明确,商用或二次分发前先到仓库确认条款。
  • 没有做站内核验,内容以作者仓库为准。
  • 技能只是说明书,实际效果取决于模型与客户端,装完先用小任务试一遍。

更适合

  • 需要在开发场景里给模型补一套做法的人。
  • 愿意先读一遍 SKILL.md、确认它会让模型做什么的人。

不太适合

  • 对许可证要求很严、必须明确可商用的人。
  • 只想装完就自动变强、不打算看说明书的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
技能权限级别安装方式累计安装宿主客户端安装命令
教材写作·项目初始化当前 未标注权限 未标注 未标注 未标注 有
技能审查员 浏览器控制 ClawHub 市场 877.9 万 OpenClaw 有
Vercel React 最佳实践 浏览器控制 GitHub 仓库 849.1 万 Codex、Claude、Cursor 有
GitHub 代码协作 联网访问 ClawHub 市场 763.3 万 OpenClaw 有
网页设计指南 联网访问 GitHub 仓库 668.6 万 Codex、Claude、Cursor 有
本体论 只读 ClawHub 市场 663.7 万 OpenClaw 有

SKILL.md 全文

6.0 KB
模型实际读到的说明书原文,来自技能仓库

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(阶段 5 派生生成)、00-教材设计.md(textbook-outline 写入)、NN-<章标题>.md(逐章生成)、98-参考答案.md(逐章追加)、99-表现性任务.md(阶段 5 派生生成)、术语表.md(主 skill 追加维护)。动机:主 skill 的重入判定靠"这些文件存不存在、内容有没有"定位续点(契约文档第 4 节),预建空文件会让它把全新项目误判成半成品;空壳文件混进交付物也违背"交付即可用"的底线。本 skill 创建的只有目录本身、.gitignore 和 README 工作说明——均在契约之外。

工作流

第 1 步:一轮提问

用 AskUserQuestion 一轮收集四项(触发语已说明的项不再问):

  1. 教材名:如《线性代数入门》——将成为项目目录名;
  2. 规划范围:a) 只写这一本 b) 未来还会写多本(追加:工作区名,默认"教材工作区");
  3. 位置:项目/工作区建在哪个目录下,默认当前目录 ./;
  4. 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 步:创建与交接

  1. 建目录:按确认的方案 mkdir -p;
  2. git 判重:在目标位置检查是否已处于某个 git 仓库内(方法见 references/workspace-layout.md 第 3 节)——已在,则跳过 git init 并向作者说明原因;
  3. git 初始化(作者要 git 且未命中判重):git init + 写 .gitignore + 首次提交,层级与内容规范见 references/workspace-layout.md 第 3、4 节;
  4. README 工作说明:按 references/workspace-layout.md 第 5 节模板实例化——所有字段填当前项目的真实值,写完通读确认没有残留尖括号或待填空白;
  5. 打印成果与下一步指引:
✅ 工作目录就绪:<实际路径>
接下来对我说:写教材《<教材名>》,落盘目录用 <项目目录路径>
(textbook 会在该目录里创建 .progress.json 并从教学定位开始五阶段流程)

安全边界

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

常见问题

5 问
答案由本站依据条目字段整理
教材写作·项目初始化怎么安装?

在支持 Skills 的客户端里执行:skillhub install user_6733bad6/textbook-init。安装方式为未标注。装完刷新技能列表或重开客户端。

教材写作·项目初始化支持哪些客户端?

资料没有标注宿主客户端,但只要客户端支持 Skills(Claude、Codex、Cursor 等),一般都能加载。

教材写作·项目初始化权限高吗,安全吗?

权限级别为未标注权限。安装前先看它会读取或写入哪些内容。

教材写作·项目初始化收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于技能本身和所用的模型或客户端,正式使用前按作者说明确认。

教材写作·项目初始化用什么许可证?

许可证标注为 未说明(许可证不明确)。商用或二次分发前请到仓库确认条款原文。

热门专题

按场景挑技能
全部专题 →

技能内容以作者仓库为准;分类、权限级别与许可证状态的中文说明为中文整理,最近核验 2026-11-06。