---
name: tutorial-writing
description: |
图文教程创作技能：读取代码仓库/项目目录，为玄清产出高质量、像人写的图文教程（含配图与VHS演示）。
支持两种教程类型：操作类教程（帮读者完成一项具体任务）和项目复盘类教程（讲清一个项目怎么做出来的）。
包含三阶段11步创作流程、四道硬门（HARD GATE）+机检脚本、环境自适应降级、三遍审校（降AI味）、
视角审与读者盲测、个人风格资产库、配图工作流、VHS演示录制、小红书转换。
信息不够时明确告知缺什么，不编造。
除了写新教程，审稿、局部修改、补配图、发布前检查也走本 skill（见任务类型判断）。
触发词：
- "写教程"、"图文教程"、"教程创作"、"写个教程"
- "操作指南"、"使用指南"、"安装教程"、"配置教程"
- "项目复盘"、"复盘教程"、"写项目总结教程"、"开发记录复盘"
- "/tutorial-writing"、"/写教程"
注意：如果用户需要的是公众号文章（非教程）、小说、剧本杀，请使用对应的专项skill；
只要口头总结项目（不成文教程）也不要使用本skill。
---
# 图文教程创作技能 v2.4
为玄清的图文教程内容提供创作辅助。
目标：清晰、可操作、零门槛，让读者看完能立刻上手，且有启发。
工作方式三句话：先把素材拆干净（阶段一），再把语气调成人话（阶段二、三），
图和演示直接配好而不是只写指南。信息不够时直接告诉用户缺什么，不编造。
## 速查索引
| 我需要... | 去哪找 |
|-----------|--------|
| 判断走完整流程还是轻量流程 | § 执行前环境检测 |
| 小教程怎么减负 | § 执行前环境检测 > 轻装规则 |
| 判断这次是写/审/改/补图 | § 任务类型判断 |
| 哪些步骤没产物不能往下走 | § HARD GATE |
| 审校/硬门的机检命令 | § 机检脚本 |
| 审稿人/Persona 派发词 | references/reviewer-prompts.md |
| 判断教程类型 | § 教程类型判断 |
| 视角审 / 读者盲测怎么做 | Step 8 |
| 个人素材与身份事实红线 | § 个人风格资产库 + references/author-facts.md |
| 操作类语言规范 | Step 5 > 操作类语言 |
| 开头怎么写不像 AI | Step 5 > 开头写法 + style-examples § 2 |
| 段落/句子长度规则 | Step 5 格式密度 + Step 7 第三遍 |
| 图片生成与降级 | Step 9 + § 降级告知协议 |
| 内容/风格审校清单 | references/review-checklists.md |
| 中断后从哪继续 | § 进度存档 |
| 最终交付检查 | § 最终检查清单 |
## 执行前环境检测（接到需求后第一件事）
11 步流程中的代码阅读、实操验证、配图、VHS 生成，都以真实环境为前提。
先探测，再选路，不要走到一半才发现环境不存在。
**检测项**：
- [ ] 项目目录可访问？（ls / Glob）
- [ ] Python 环境可运行脚本？
- [ ] VHS/GIF 录制工具可用？（`which vhs`）
- [ ] 生图 / 图床 API Key 已配置？
**路径选择**：
安装后查看完整内容 ↓