# Write Tutorial > 编写新的教程文章。适用于用户要求创作新教程时。目标风格：读起来像一个真正懂行的人在跟你讲话，不装、不绕弯，但逻辑清晰、重点突出。 - Skill: `lingxiaobc/write-tutorial` (Agent Skill) - Install (CLI): `npx skillmds@latest add lingxiaobc/write-tutorial` - Raw SKILL.md: https://api.skillmd.com/api/skills/lingxiaobc/write-tutorial/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: lingxiaobc (https://skillmd.com/u/lingxiaobc) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/lingxiaobc/write-tutorial --- # 编写新教程技能 ## 技能定位 本技能用于**创作新教程文章**，不是优化已有文章。 典型使用场景： - 用户说"写一篇关于 XXX 的教程" - 用户说"帮我创作一个新教程" - 用户说"我想写一个介绍 XXX 的文章" --- ## 编写流程 ### 第 0 步：确定教程序号与位置 在开始写作之前，先了解用户想写什么主题。 然后分析现有教程结构，根据以下原则确定合适的序号和位置： - **序号从小到大递进**：新教程的序号 = 已有教程数量 + 1 - **由浅入深排列**：根据主题难度，确定插入到序列中的哪个位置 - 序号格式：`N-`（N 为数字） 例如：现有 3 篇教程（序号 1-3），新主题难度介于 1 和 2 之间，则新教程序号为 2，原 2、3 顺延。 **如果当前是第 1 篇**：跳过此步骤，直接进入下一步。 --- ### 第 1 步：调用子代理读取一篇 确定序号后，调用 `prev-article-reader` 子代理，传入当前教程序号 N，自动定位并读取序号 N-1 的上一教程。 **调用方式**：通过 Agent 工具，指定 `subagent_type: prev-article-reader`，传入当前教程序号 N。 子代理定义路径：`.claude/agents/prev-article-reader.md` 子代理会返回： - 上一教程的核心主题与结论 - 上一教程已引入的概念与比喻（本篇无需重复解释） - 上一教程结尾的内容预告（本篇开头应与之呼应） - 衔接建议 --- ### 第 2 步：提供大纲 结合连贯性信息，分析当前教程的内容范围，列出完整的文章结构大纲，标明各板块和子板块。 将大纲提交给用户审查，**不要开始写正文**。 --- ### 第 3 步：等待用户确认大纲 停下来，等待用户对大纲的反馈。根据反馈调整大纲，直到用户确认。 --- ### 第 4 步：逐板块填写内容 大纲确认后，**一次只写一个板块**。每个板块完成后停下，提交给用户审查。 --- ### 第 5 步：用户审查循环 等待用户确认当前板块。根据反馈修改，确认无误后才继续下一板块。 --- ### 第 6 步：重复直到全文完成 重复步骤 4-5，直到所有板块写完。 --- ### 第 7 步：深度审查 全文完成后，调用 `review-depth` 子代理对全文进行深度审查。 **调用方式**：通过 Agent 工具，指定 `subagent_type: review-depth`，传入目标文章的路径和审查任务描述。 子代理定义路径：`.claude/agents/review-depth.md` 子代理会返回： - 第一原则评估（换掉工具后价值剩余） - 三个维度的评分（知识可迁移性、底层原理深度、小白可读性） - 问题清单（含标记类型、位置、描述、修改建议） - 优先修改项 根据审查报告逐一修改，再提交用户做最终确认。 --- ## 排版规范 遵循 `CLAUDE.md` 中的强制排版规范。 --- ## 语言风格规范 所有语言风格规范（口头禅、通俗易懂要求、比喻使用、结论强调等）详见： **→ `.claude/reference/style-guide.md`** --- ## 内容准确性规范 ### 参考官方文档 官方文档位于：`reference/claude_code帮助文档/` 目录 创作教程文章时，必须： - 读取官方文档中对应主题的内容 - 确保教程中的技术描述与官方文档一致 - 如果官方文档表述过于技术化，需要用通俗语言重新解释，但核心含义不能变 --- ## 使用方法 用户可以通过以下方式调用此技能： - `/write-tutorial` 命令 - 说"写一篇关于 XXX 的教程" - 说"帮我创作一个新教程" 技能会自动： 1. 分析现有教程结构，确定新教程序号 2. 调用 `prev-article-reader` 子代理（如果是教程系列），获取上一教程的摘要 3. 检查连贯性：根据摘要判断如何自然衔接 4. 提供大纲给用户审查 5. 逐板块撰写内容，每板块等待用户确认 6. 调用 `review-depth` 子代理进行深度审查 7. 根据审查报告修改后，提交用户最终确认