code-tutorial-engineerlisted

--- name: code-tutorial-engineer title: 代码教程与教学内容编写 description: 当需要把代码、特性或库改写成循序渐进、动手实操的教程或教学内容时使用；做学习目标拆解、概念分层、带预期输出的练习与排错，产出 Markdown 教程（含 Try It Yourself、可折叠答案、Troubleshooting）；不适用于纯 API 参考、长篇架构叙事或营销文案。触发词：写教程、上手指南、onboarding 教学、动手实验、循序渐进、教学内容 domain: 文书/misc triggers: [把代码或特性写成教程, 编写循序渐进的上手指南, 做新人 onboarding 教学材料, 设计带练习和答案的动手实验, 为博客/课程/工作坊写教学��容, 把复杂概念拆成可学的步骤] tags: [技术教程, 教学设计, onboarding, 动手实验, 技术写作, 文档工程] level: 进阶 status: stable agents: [claude-code, codex, cursor, gemini-cli] tools: [Read, Glob, Grep, Write] requires: [] related: [docs-architect, technical-reference-builder, readme-doc-writer] combines_with: [] license: MIT source: sickn33/antigravity-awesome-skills source_license: MIT --- ## 何时使用 当需要把一段代码、一个特性或一个库，转化成**循序渐进、可动手跑通**的学习材料时使用。产物是教学型 Markdown：读者跟着做能从零到「会用」，而不仅是「看懂」。典型场景： - 把复杂概念拆成可消化的顺序步骤，让初学者不卡壳。 - 为新人 onboarding、博客、课程、工作坊产出教学内容。 - 写「教人」而非「查阅」的文档��每个概念配即时练习与预期输出。 **不该用边界：** - 任务与教程/教学无关，或属其他领域/工具范畴。 - 需要 API 参考手册（字段级速查）—— 改用 `technical-reference-builder`。 - 需要长篇架构叙事 / 设计决策记录 —— 改用 `docs-architect`。 - 写营销或推广文案。 - 缺必需输入（主题/代码、目标受众、格式、约束、发布渠道）时先停下澄清，不要臆造。 ## 步骤 教程开发三步法： 1. **定学习目标**：补全「学完后你将能够 ____」。用 Bloom 动词（build / debug / optimize，不用「understand」），写可衡量的成果，明确前置知识。 2. **拆概念**：把复杂主题切成原子概念，按「简单→复��、具体→抽象」排序，标出依赖。**铁律：任何概念都不得依赖后文才介绍的知识（No Forward References）。** 3. **设练习**：动手编码练习按脚手架（scaffolding）由易到难，每个练习都要有明确成功判据，并埋入自检 checkpoint。节奏遵循 **I do（示范）→ We do（带做）→ You do（挑战）**。 **渐进章节节奏**（每节固定韵律）：概念引入（配类比）→ 最小可跑示例 → 带预期输出的逐步带做 → 可选变体 → 难度递增的挑战 → Troublesh