installer

用途

Installer 是一个元技能，专门处理智能教科书项目的安装与配置任务。它把三个安装类技能整合为一个统一入口，并根据用户请求按需加载对应的安装指南。

主要能力

该技能可路由到四类安装指南：

MkDocs 模板（references/mkdocs-template.md）：从零引导创建完整的 MkDocs Material 智能教科书项目，包括创建名为 'mkdocs' 的 Conda 虚拟环境、完整的 MkDocs Material 项目结构、用于品牌定制的自定义 CSS、社交媒体卡片插件，以及 GitHub Pages 部署配置。
学习图谱查看器（references/learning-graph-viewer.md）：为已有教科书添加交互式学习图谱探索功能，创建基于 vis-network 的交互式图谱查看器，支持搜索、过滤和统计功能，并与已有的 learning-graph.json 集成。
技能追踪器（references/skill-tracker.md）：设置 Claude Code 技能使用追踪，创建用于追踪技能调用的钩子脚本、活动日志目录结构，以及用于使用情况分析的报告脚本。
首页模板（references/home-page-template.md）：创建带封面图和社交媒体优化的专业首页，生成包含正确 frontmatter 元数据的 docs/index.md、带蒙太奇背景的封面 AI 图像生成提示词，以及 Open Graph 和 Twitter Card 配置。

使用方式

技能通过关键词匹配将用户请求路由到对应指南：

触发词“new project、mkdocs、textbook、bootstrap、setup、template、new book” → mkdocs-template.md
触发词“graph viewer、learning graph、visualization、interactive graph、concept viewer” → learning-graph-viewer.md
触发词“track skills、skill usage、activity tracking、hooks、usage analytics” → skill-tracker.md
触发词“cover image、home page、social media、og:image、montage、book cover、index page” → home-page-template.md

匹配后，技能会读取 references/ 下对应的指南文件，并按照其中的安装工作流执行。每个指南包含前置条件与要求、分步安装命令、配置选项、验证步骤和故障排除提示。

适用场景

设置新的 MkDocs Material 项目
从零创建新的智能教科书
安装学习图谱查看器
通过钩子设置技能使用追踪
引导项目基础设施
创建封面图或设置带社交元数据的首页

常见工作流

完整的新项目通常按以下顺序执行安装：

mkdocs-template.md — 创建项目结构
home-page-template.md — 创建封面图并配置首页
learning-graph-viewer.md — 添加图谱可视化（在学习图谱存在后）
skill-tracker.md — 启用使用分析（可选）

前置条件

不同指南有不同前置条件：

MkDocs 模板：需安装 Conda、Git，并已创建 GitHub 仓库
学习图谱查看器：需已有 MkDocs 项目，且存在 learning-graph.json 文件
技能追踪器：需已安装 Claude Code，且存在 ~/.claude 目录
首页模板：需已有 MkDocs 项目，并可访问 AI 图像生成器（如 DALL-E、Midjourney 等）

验证方式

安装后可使用以下命令验证：

# For MkDocs projects
mkdocs serve
# Visit http://127.0.0.1:8000/[project-name]/

# For skill tracker
cat ~/.claude/activity-logs/skill-usage.jsonl | tail -5

限制

资料未提供该技能的具体收费、价格、平台支持范围或效果保证等信息。