SuperAPI AI 工具集

tutorial-design

写作与研究

查看项目

更新于 10-16 09:34

技能介绍

用途:把复杂技术概念转化为循序渐进的动手学习内容,适用于为库、API 或工具写入门教程,制作团队培训或会议工作坊材料,构建多部分学习系列,设计带自评检查点的编码练习,将现有文档改写为引导式学习内容,或编写快速上手指南。

主要能力:提供五阶段流程——定义学习目标与前置条件、将概念分解为最小步骤、设计练习与检查点、撰写含可运行示例的正文、端到端验证教程路径。支持多种练习类型(填空、调试、扩展、从零构建、重构)、检查点模式与每节故障排查段落;提供设计模式参考文件 references/design-patterns.md,用于教程结构规划与练习设计。

使用方式:按目标→分解→设计→撰写→验证推进。开篇写明“你将学到什么”、前置条件、时间估算与最终成果;每节聚焦单一概念,先给可运行的最小示例再解释,每 2-3 分钟让读者运行验证;每节附 2-3 个常见错误排查。教程格式包括快速上手(约 5 分钟)、深度解析(30-60 分钟)、工作坊系列、食谱式、交互式实验(15-45 分钟)。

限制与注意事项:资料未提供该技能的安装命令、运行环境、收费或价格信息。正文强调避免在需要前引入概念、避免不可独立运行的代码片段、避免假设未列出的前置知识、避免无代码打断的大段文字、避免无答案的练习,并须在发布前从干净环境完整走查、核对所有示例输出并实测故障场景。