executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
, 块级 `$公式$`\n- 代码块使用准确语言高亮\n- 多系统操作用 Tabbed Content\n\n详见: [assets/mkdocs-standards.md](assets/mkdocs-standards.md)\n\n---\n\n## 教程分类体系\n\n所有教程采用三层分类: **领域 → 方向 → 主题**\n\n| 领域 | 方向 | 示例 |\n|------|------|------|\n| 基础技能 | 开发工具/文档写作/环境配置 | Git/Markdown/Linux |\n| 编程语言 | 通用语言/专业语言/标记语言 | Python/R/HTML |\n| 技术领域 | AI/数据工程/前端/运维 | LLM/爬虫/Web |\n| 工程实践 | 软件工程/团队协作/质量保障 | 设计模式/CI/CD |\n\n详见: [assets/classification.md](assets/classification.md)\n\n---\n\n## 发布同步要求\n\n教程生成后必须同步 3 个文件:\n1. `README.md` — 在对应分类添加教程词条\n2. `docs/index.md` — 在对应分类添加教程卡片\n3. `mkdocs.yml` — 在 `nav` 列表添加导航项\n\n---\n\n## 使用示例\n\n```\n用户: \"帮我生成一个 Linux 新手入门教程,4-5小时,零基础\"\n → Phase 1: 确认从零开始\n → Phase 2: technology/beginner/daily_life\n → Phase 3: 6章大纲, 比喻链: 遥控器→租房→语音遥控器→钥匙锁→智能管家\n → Phase 4: 逐章生成(每章配实操+验证)\n → Phase 5: 质量评分 92/100\n → Phase 6: 导出完整 MkDocs 项目\n```\n\n---\n\n## 文件导航\n\n```\ndog-tutor/\n├── SKILL.md # 本文件 — 流程总控、触发条件、验收标准\n├── ATTRIBUTIONS.md # 原始作者归属声明\n├── references/\n│ ├── workflow.md # 6阶段详细说明(输入/输出/步骤/对话模板)\n│ ├── handoff-format.md # 阶段间交接的结构化格式\n│ └── qa-checklist.md # 质量验收清单(5维度20+项)\n└── assets/\n ├── audience-model.md # 四级受众模型详解\n ├── analogy-styles.md # 四种比喻风格配置\n ├── domain-configs.md # 五大领域配置(YAML)\n ├── classification.md # 三层分类体系+归类流程图\n ├── mkdocs-standards.md # MkDocs Material排版强制规范\n └── output-formats.md # 固定输出格式模板\n```\n\n---\n\n## 原始出处\n\n本技能基于 **SmartTutor Generator v1.1** (莫弈, 2026-05-04) 整合封装。\n完整归属声明: [ATTRIBUTIONS.md](ATTRIBUTIONS.md)\n\n---\n\n*Dog-Tutor v1.0.0 — MIT License*\n","licenseDocuments":[]}}
dog-tutor智能教程编制系统(Dog-Tutor)。通过6阶段对话引导,将任意主题的学习资料转化为高质量MkDocs Material格式教程。 支持技术/商业/学术/生活/艺术全领域,四级受众自适应,四种比喻风格,主题无关的通用教程生成引擎。 适用于技术文档编写、课程开发、知识整理、培训材料制作、入门指南撰写等场景。 Trigger keywords: 生成教程, 创建教程, 编制学习材料, 设计课程大纲, 写入门指南, 做教程, tutorial, course, 教程, 课件, 培训材料, 编写文档, Dog-Tutor, smarttutor.
Independent GitHub snapshot · Automated classification · Original documentation governs
name: dog-tutor description: > 智能教程编制系统(Dog-Tutor)。通过6阶段对话引导,将任意主题的学习资料转化为高质量MkDocs Material格式教程。 支持技术/商业/学术/生活/艺术全领域,四级受众自适应,四种比喻风格,主题无关的通用教程生成引擎。 适用于技术文档编写、课程开发、知识整理、培训材料制作、入门指南撰写等场景。 Trigger keywords: 生成教程, 创建教程, 编制学习材料, 设计课程大纲, 写入门指南, 做教程, tutorial, course, 教程, 课件, 培训材料, 编写文档, Dog-Tutor, smarttutor. allowed-tools:
将任意主题的学习资料转化为高质量 MkDocs Material 格式教程的元技能。 通过 6 阶段结构化对话,从资料摄入到发布,全流程可控。
核心理念: 主题无关、受众自适应、风格可选、分阶段交互、标准输出、结果可复用。
| 字段 | 说明 |
|---|---|
| 教程标题 | 明确的学习主题 |
| 预计时长 | 学习所需时间 |
| 前置要求 | 学习者需具备的基础 |
| 学习目标 | 至少1项可衡量的学习成果 |
Phase 1: 资料摄入 Phase 2: 领域分析 Phase 3: 大纲生成
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 收集原始资料 │ │ 识别领域+受众 │ │ 生成章节大纲 │
│ │ → │ │ → │ │
│ 结构化分块 │ Gate1 │ 匹配比喻风格 │ Gate2 │ 比喻链+知识点 │ Gate3
│ 输出: 内容块 │ │ 输出: 分析报告 │ │ 输出: 大纲JSON │
└──────────────┘ └──────────────┘ └──────────────┘
│
▼
Phase 6: 发布 Phase 5: 质量评估 Phase 4: 内容生成
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ MkDocs项目 │ │ 5维度评分 │ │ 逐章撰写 │
│ │ ← │ │ ← │ │
│ 打包导出 │ Gate5 │ 改进建议 │ Gate4 │ MkDocs规范 │ Gate3
│ 输出: 完整站点 │ │ 输出: QA报告 │ │ 输出: 章节MD │
└──────────────┘ └──────────────┘ └──────────────┘
| 门 | 检查内容 | 不通过时的处理 |
|---|---|---|
| Gate 1 | 资料已收集,内容块已结构化 | 追问补充资料或确认从零开始 |
| Gate 2 | 领域/受众/风格已确认 | 调整分析参数 |
| Gate 3 | 大纲已审阅,比喻链完整 | 修改章节/调整比喻/重新生成 |
| Gate 4 | 每章内容符合 MkDocs 规范,受众适配 | 修改/扩充/精简 |
| Gate 5 | 质量评分 ≥ 60/100 | 针对性修改后重新评估 |
| 级别 | 比喻密度 | 步骤粒度 | 触发特征 |
|---|---|---|---|
| absolute_beginner | high | micro | "零基础""新手""入门" |
| beginner | medium | standard | 默认级别 |
| intermediate | low | condensed | "进阶""实战""精通" |
| expert | minimal | overview | "架构""原理""源码" |
| 风格 | 特点 | 适合场景 |
|---|---|---|
| daily_life | 生活化类比 | 零基础、概念抽象 |
| professional | 行业类比 | 有行业背景、B2B |
| humorous | 幽默轻松 | 娱乐内容、年轻受众 |
| rigorous | 严谨学术 | 学术内容、考试导向 |
| 领域 | 默认受众 | 默认风格 | 子领域 |
|---|---|---|---|
| technology | beginner | daily_life | 编程/运维/AI/数据库/前后端/DevOps |
| business | intermediate | professional | 营销/管理/财务/战略/运营 |
| academic | beginner | rigorous | 数学/物理/化学/生物/人文 |
| life | absolute_beginner | daily_life | 摄影/烘焙/瑜伽/理财/旅行 |
| art | beginner | humorous | 绘画/音乐/设计/写作 |
| 维度 | 权重 | 关键检查 |
|---|---|---|
| 格式规范 | 15% | MkDocs兼容性、空行隔离、粗体空格隔离 |
| 内容完整性 | 25% | 知识点覆盖、示例充分、实践任务完整 |
| 教学逻辑 | 25% | 难度递进、概念衔接、认知负荷 |
| 实用价值 | 20% | 可操作性、场景真实、有明确产出 |
| 比喻质量 | 15% | 贴切程度、风格一致、记忆辅助 |
**粗体** 标记前后缺少空格-/1.)首行之前强制插入空行```)、引用块(>)、Admonition(!!!)前后各一个空行** 标记前后必须各有一个空格** 时也需空格[^\s]\*\*[^\s\*]$公式$, 块级 $公式$详见: assets/mkdocs-standards.md
所有教程采用三层分类: 领域 → 方向 → 主题
| 领域 | 方向 | 示例 |
|---|---|---|
| 基础技能 | 开发工具/文档写作/环境配置 | Git/Markdown/Linux |
| 编程语言 | 通用语言/专业语言/标记语言 | Python/R/HTML |
| 技术领域 | AI/数据工程/前端/运维 | LLM/爬虫/Web |
| 工程实践 | 软件工程/团队协作/质量保障 | 设计模式/CI/CD |
教程生成后必须同步 3 个文件:
README.md — 在对应分类添加教程词条docs/index.md — 在对应分类添加教程卡片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