SuperAPI AI 工具集

init-textbook

通用与其它

查看项目

更新于 10-15 21:10

技能介绍

用途:在空或近乎空的项目目录中一次性生成完整的智能教科书脚手架,使项目与近期教科书(网络安全、网络、信息系统、古代史、统计学、量子计算等)采用同一基线。

主要能力:创建 .gitignore、VS Code 工作区文件、mkdocs.yml、plugins/social_override.py 钩子,以及 docs/ 下的 index.md、about.md、course-description.md、contact.md、license.md、chapters/、learning-graph/、sims/、css/extra.css、img/cover.png 与 license.png。默认启用搜索、代码复制、admonitions、arithmatex、侧边导航、CC BY-NC-SA 许可、intelligent-textbook URI scheme 与封面社交覆盖钩子;吉祥物、幻灯片、学习图查看器、自定义 404、社交卡片、图片缩放、分析、评论等留待后续用 book-installer 增量添加。

使用方式:触发词包括 init textbook、create a new textbook、scaffold a new book 等。先运行 ls -la 检查是否已存在 mkdocs.yml、docs/index.md、docs/license.md,存在则拒绝覆盖并建议改用 book-installer。随后推断 git config user.name、git remote、目录名与年份,并一次性询问 SITE_NAME、SITE_DESCRIPTION、配色等,确认替换表后创建目录并替换 {{VAR}} 占位符。完成后建议运行 pip install mkdocs mkdocs-material 与 mkdocs build --strict,并用 grep -E '(og|twitter):image' site/index.html 验证封面钩子生效。

适用场景与限制:仅用于项目初始创建,不用于已有 mkdocs.yml 和 docs/ 的项目,也不回答已有教科书的使用问题。默认不含社交插件、吉祥物 logo、深色模式与章节内容;MicroSim 状态指示器使用 scaffold/built/approved 三值,需在 extra.css 中定义,不要添加 theme.icon.status。缺失信息暂未提供。