前言¶

职教教材编写最常见的麻烦不是写不出字，而是结构先散掉：理论体系与实训环节脱节、学时分配对不上、岗位能力和证书考点没有落点。等到正文写完再返工，成本很高。下面介绍的这个 Skill 把顺序固定下来——先通读材料、再定章节结构、用户确认后逐章写正文，避免一上来就堆文字。

这是什么¶

@user_38c70a3d/ai4textbook-writer，名称为「教材编写（项目化、理实一体化）」，由 user_38c70a3d 发布，当前版本 1.0.1，来源 community，分类 education，基于通用 SKILL.md 格式。

定位是职业教育国家规划教材编写智能体。输入是教学大纲、PPT、课程标准、人才培养方案、实训指导书等既有材料，输出是按项目化结构组织、带配图的规范 Word 文档（.docx）。

SkillHub 页面显示评分 100000，下载 1918 次，安装 0 次，标签 requires_api_key=false，即不需要额外配置 API Key。

什么时候触发¶

当用户提供上述材料，并要求编写、撰写、生成或修订教材时使用。触发词覆盖得比较细，包括：教材、编写教材、写教材、教材撰写、国家规划教材、规划教材、项目化教材、任务驱动教材、活页教材、工作手册式教材、教材章节、教材大纲、教材配图、职教教材、textbook。

除了整本教材，只给到章节大纲或教材配图的需求同样会命中。

工作流¶

工作流分五步，顺序不能颠倒。

1、通读全部材料。把教学大纲、课程标准、人才培养方案、实训指导书等先读完，再动手。这一步决定了后面的结构和内容有没有依据。

2、设计章节结构。结构要符合国家职业教育规划教材体系，采用「项目—任务—子任务」三级，同时兼顾四件事：理论体系的完整性、学时分配、岗位能力映射、证书考点映射。

3、提交用户确认。结构先给出来，用户确认后再写正文。结构确认环节是避免返工的关键。

4、逐章撰写正文。按确认后的结构分章写，不是一次性吐一整本。

5、每章配置图表，最后输出 .docx。

图表与素材的合规要求¶

这是该 Skill 约束最明确的部分。图表优先采用可溯源的合规网络图片，来源限定为公有领域、CC 协议或明确授权，且必须标注作者、来源与许可。

三种情况下不做图片引用，一律改用代码绘制：有侵权嫌疑、来源不明、无法确权。代码绘制的备选手段写得很具体，是 SVG、Python matplotlib、Pillow、Mermaid。

另外有一条硬性禁令：严禁编造数据、案例、文献、企业名称。这意味着正文里出现的每个事实都应能对应到用户提供的材料，材料里没有的就不写。

安装与启用¶

已抓取资料中没有给出该 Skill 的安装命令或配置字段，因此这里不提供未经核实的命令。可以确认的事实是：坐标 @user_38c70a3d/ai4textbook-writer，版本 1.0.1，requires_api_key=false，不需要准备 API Key。安装方式以 SkillHub 官方页面为准。

启用方式就是直接在对话里提出需求，触发词命中后它会读取用户提供的材料开始工作。因为不需要 API Key，配置环节基本可以忽略，主要成本在提供完整的输入材料。

典型用法¶

用法按输入材料组织，下面是可复现的几种。

输入整本教材的编写需求：

根据这套人才培养方案和实训指导书，编写一门项目化教材，
输出 .docx，先给章节结构给我确认。

输入已有 PPT 或教学大纲，要求改写为任务驱动式教材：

把这份 PPT 整理成任务驱动式教材，按项目—任务—子任务组织，
标注每部分学时和对应的证书考点。

只要求章节大纲或配图时：

给出《XXX》第三章的教材大纲，并为该章配图，
图片来源不确定的一律用代码绘制。

三种方式都需要先把材料贴出来或放到可读取的位置，否则第一步「通读全部材料」无法执行。

适用场景与限制¶

适合的场景：职业教育阶段需要产出规划教材、项目化教材、活页式或工作手册式教材的教研团队，手里已经有课程标准、人才培养方案、实训指导书等材料，缺的是结构梳理和逐章成稿的执行人手。

需要注意的限制：

• 它不会凭空生成内容。材料不全时，理论深度和细节会受限，需要补材料而不是靠它编。
• 结构确认是必经环节，只想一次拿到全文会在这里被打断一次。
• 配图受合规约束很严，能直接引用的网络图片有限，相当一部分图会走代码绘制，风格取决于具体使用的绘图工具。
• 严禁编造这条规则意味着材料里没有的企业名称、数据和文献不会出现在正文里，引用时需要自行核对。

小结¶

这个 Skill 的价值不在「自动写教材」这个笼统的说法，而在三件具体的事：把「项目—任务—子任务」结构作为前置确认项、给每章配图时执行可溯源的合规判断、输出规范的 Word 文档。适合材料已经准备好、需要把编写流程跑通的职教教材项目。

官方地址：https://api.skillhub.cn/user_38c70a3d/ai4textbook-writer
SkillHub 页面：https://www.skillhub.cn/skills/user_38c70a3d/ai4textbook-writer