Dog-Tutor — 智能教程编制系统

将任意主题的学习资料转化为高质量 MkDocs Material 格式教程的元技能。 通过 6 阶段结构化对话,从资料摄入到发布,全流程可控。

核心理念: 主题无关、受众自适应、风格可选、分阶段交互、标准输出、结果可复用。

触发条件

明确触发词

• "帮我生成教程" / "创建一个教程" / "编制学习材料"
• "设计课程大纲" / "写入门指南" / "做一份XX教程"
• "用Dog-Tutor做教程"

必需输入

可选输入

• 原始学习资料(文件/链接/文本)
• 特定受众描述
• 风格偏好(生活化/专业/幽默/严谨)
• 章节数量要求

流程总控

Phase 1: 资料摄入       Phase 2: 领域分析       Phase 3: 大纲生成
┌──────────────┐       ┌──────────────┐       ┌──────────────┐
│ 收集原始资料  │       │ 识别领域+受众 │       │ 生成章节大纲  │
│              │  →   │              │  →   │              │
│ 结构化分块    │ Gate1 │ 匹配比喻风格  │ Gate2 │ 比喻链+知识点 │ Gate3
│ 输出: 内容块  │       │ 输出: 分析报告 │       │ 输出: 大纲JSON │
└──────────────┘       └──────────────┘       └──────────────┘
                                                       │
                                                       ▼
Phase 6: 发布          Phase 5: 质量评估       Phase 4: 内容生成
┌──────────────┐       ┌──────────────┐       ┌──────────────┐
│ MkDocs项目    │       │ 5维度评分     │       │ 逐章撰写      │
│              │  ←   │              │  ←   │              │
│ 打包导出      │ Gate5 │ 改进建议      │ Gate4 │ MkDocs规范    │ Gate3
│ 输出: 完整站点 │       │ 输出: QA报告   │       │ 输出: 章节MD   │
└──────────────┘       └──────────────┘       └──────────────┘

阶段门控

核心系统

四级受众模型

详见: assets/audience-model.md

四种比喻风格

详见: assets/analogy-styles.md

五大领域配置

详见: assets/domain-configs.md

验收标准

质量评分 (5维度)

质量等级

• 90-100: 优秀,强烈推荐
• 75-89: 良好,可以使用
• 60-74: 可接受,有条件使用
• <60: 需改进,不建议发布 — 触发重新修订

阻断性缺陷 (一票否决)

• 列表符号粘连正文(最高级别格式错误)
• **粗体** 标记前后缺少空格
• 代码块/Admonition 前后缺少空行
• 章节内容与大纲不符
• 输出未包含验证步骤

MkDocs 排版强制规范

空行隔离原则

• 任何列表(-/1.)首行之前强制插入空行
• 代码块(```)、引用块(>)、Admonition(!!!)前后各一个空行
• 严禁列表紧跟在正文末尾

粗体空格隔离

• ** 标记前后必须各有一个空格
• 中文标点(。，：；！？)紧邻 ** 时也需空格
• 表格内、列表项内同样适用
• 验证正则: [^\s]\*\*[^\s\*]

其他规范

• 数学公式: 行内 $公式$, 块级 $$公式$$
• 代码块使用准确语言高亮
• 多系统操作用 Tabbed Content

详见: assets/mkdocs-standards.md

教程分类体系

所有教程采用三层分类: 领域 → 方向 → 主题

详见: assets/classification.md

发布同步要求

教程生成后必须同步 3 个文件:

1. README.md — 在对应分类添加教程词条
2. docs/index.md — 在对应分类添加教程卡片
3. mkdocs.yml — 在 nav 列表添加导航项

使用示例

用户: "帮我生成一个 Linux 新手入门教程,4-5小时,零基础"
  → Phase 1: 确认从零开始
  → Phase 2: technology/beginner/daily_life
  → Phase 3: 6章大纲, 比喻链: 遥控器→租房→语音遥控器→钥匙锁→智能管家
  → Phase 4: 逐章生成(每章配实操+验证)
  → Phase 5: 质量评分 92/100
  → Phase 6: 导出完整 MkDocs 项目

文件导航

dog-tutor/
├── SKILL.md                     # 本文件 — 流程总控、触发条件、验收标准
├── ATTRIBUTIONS.md              # 原始作者归属声明
├── references/
│   ├── workflow.md              # 6阶段详细说明(输入/输出/步骤/对话模板)
│   ├── handoff-format.md        # 阶段间交接的结构化格式
│   └── qa-checklist.md          # 质量验收清单(5维度20+项)
└── assets/
    ├── audience-model.md        # 四级受众模型详解
    ├── analogy-styles.md        # 四种比喻风格配置
    ├── domain-configs.md        # 五大领域配置(YAML)
    ├── classification.md        # 三层分类体系+归类流程图
    ├── mkdocs-standards.md      # MkDocs Material排版强制规范
    └── output-formats.md        # 固定输出格式模板

原始出处

本技能基于 SmartTutor Generator v1.1 (莫弈, 2026-05-04) 整合封装。 完整归属声明: ATTRIBUTIONS.md

Dog-Tutor v1.0.0 — MIT License