教程结构研究
本页记录同类工具教程的课程结构和教学方法。目标是提取方法，不复制文章和标题，也不在项目中收录第三方教程链接。
样本教程怎样组织内容
该教程由 53 篇组成，分成七个阶段：基础入门、上手与项目、核心交互、功能扩展、系统配置、实战参考、收尾查阅。
它采用一条清楚的教学链：
值得保留的五种方法
1. 第一篇只负责建立地图
第一篇解释产品是什么、在哪里运行、能做什么、不能做什么，并与相邻工具对比。它没有把安装、配置和高级能力塞进开篇。
Hermes 教程应采用同样的认知顺序，但对比对象需要换成普通聊天机器人、代码助手和自动化脚本。
2. 安装篇把验证写进步骤
样本教程没有停在安装命令。它要求读者检查版本、运行诊断命令，并给出常见错误的处理顺序。
Hermes 安装篇需要把 hermes --version、hermes doctor、模型选择和一次真实对话放在同一条成功链中。
3. 第一个任务使用玩具项目
首个案例避开正式项目。读者能看清输入、修改和结果，也能理解权限确认。
Hermes 的首个任务不应局限于代码。建议使用一个临时文件夹，让 Hermes 读取三份短文本、整理摘要并写入新文件。这个任务能覆盖读取、推理、写入和验证。安装篇为 Desktop 与 CLI 分流，但两条路径应汇合到同一个练习目录和验收结果。
4. 容易混淆的功能用决策树
样本教程用“需求是什么”选择上下文文件、Skill、Hook、MCP 和 Subagent。读者不需要背定义，只需回答问题。
Hermes 教程需要一篇选择指南，区分：
- 稳定个人偏好 → memory
- 可复用做事方法 → skill
- 外部服务能力 → MCP 或 plugin
- 固定时间运行 → cron
- 隔离或并行研究 → delegation
- 独立身份和配置 → profile
5. 每篇包含学习成果和动手环节
单页常见结构为：系列位置、读者困惑、学习成果、分步说明、阶段总结、动手练习、小结和下一篇。
这种结构适合新手，但不应让口语引子占据过多篇幅。Hermes 教程采用自然叙述，每段服务于理解或行动。
不应照搬的部分
篇数不能成为目标
53 篇覆盖面广，但新手会在完成首个任务前面对账号、模型、IDE、桌面端和云端选择。Hermes 首版应控制在 18 篇，把参考手册交给官方文档。
产品结构不同
Claude Code 教程围绕软件开发。Hermes 覆盖终端、消息平台、定时任务、长期记忆和多代理。课程主线应从“AI 编程工具”改成“可执行任务的个人 Agent”。
教程与参考手册需要分层
CLI 参数、环境变量、平台列表和配置字段会变化。教程只保留完成任务所需的参数，并链接官方参考页。这样能降低维护成本。
Hermes 教程的课程主线
这条主线对应 Hermes 的产品差异，也让每个阶段都有可见成果。消息平台部分以飞书为完整主案例，钉钉、企业微信和微信进入参考中心。