AI木工大师

SKILL.md

---
name: woodworking-master
description: >-
  AI木工制作指南。覆盖榫卯结构(燕尾榫/指接榫/粽角榫等25+种)、手工具(刨/锯/凿/量具/夹具)、木工机械(台锯/压刨/平刨/带锯/雕刻机/台钻)、木材知识(硬木/软木/红木/人造板)、安全规范(PPE/机械安全/粉尘控制)、表面处理(打磨/涂装/大漆)、项目案例(入门→高级)7大模块。
  提供交互式HTML可视化报告，含制作步骤、工具清单、精度要求、安全须知、选购建议和技巧提示。
  触发词：木工,榫卯,木工制作,木工工具,木工机械,家具制作,木工教程,木工入门,woodworking,选木材,木工涂装,燕尾榫,指接榫,粽角榫,手刨,手锯,凿子,台锯,木工安全,木工项目
agent_created: true
---

# 木工大师 (Woodworking Master)

AI木工制作指南 — 从零基础到高级木工的全流程知识助手。

## 触发条件

当用户询问以下任意话题时激活本技能：
- 榫卯结构：燕尾榫、指接榫、粽角榫、方材丁字接合、格肩榫、插肩榫等
- 手工具：刨子、锯子、凿子、量具、夹具的使用/选购/维护
- 木工机械：台锯、压刨、平刨、带锯、修边机、台钻等
- 木材知识：硬木/软木/红木/人造板/选材指南
- 安全规范：PPE、机械安全、粉尘控制
- 表面处理：打磨、木蜡油、清漆、虫胶、大漆
- 项目案例：入门项目/进阶项目/高级项目的制作指导
- 木工学习路径、工具推荐、木材选购等一般性问题

## 工作流程

### 1. 理解用户意图

识别用户询问属于哪个知识模块：
- **榫卯类** — 查询具体榫卯结构的制作方法
- **工具类** — 查询手工具或机械的使用/选购
- **木材类** — 查询木材特性或选材建议
- **安全类** — 查询安全规范
- **涂装类** — 查询表面处理方法
- **项目类** — 查询具体制作项目或入门路径
- **综合类** — 用户说"木工入门""学木工""推荐工具"等宽泛问题

### 2. 查询知识库

加载 `references/woodworking_knowledge.md` 获取完整木工知识数据。该文件包含：
- 25+ 榫卯结构详解（分类/难度/工具/步骤/技巧）
- 手工具全解析（刨/锯/凿/量具/夹具 + 入门推荐清单）
- 木工机械指南（8类设备 + 选购优先级 + 安全操作）
- 20+ 常见木材特性表（硬木/软木/红木/人造板）
- 安全规范（PPE/黄金法则/粉尘控制/应急）
- 表面处理（打磨递进/6种涂装方式对比/标准流程）
- 项目案例库（入门/进阶/高级 + 通用制作流程）
- 术语速查表 + 学习资源推荐

### 3. 生成报告

使用 `scripts/generate_report.py` 生成交互式 HTML 报告。

命令格式：

```bash
python scripts/generate_report.py --topics    # 列出所有可用主题
python scripts/generate_report.py --index     # 生成知识索引页
python scripts/generate_report.py --detail <主题名>   # 生成详细报告
python scripts/generate_report.py --general <主题名>  # 生成综合主题报告
```

**详细报告主题** (--detail)：燕尾榫, 指接榫, 粽角榫, 方材丁字接合, 手刨, 手锯, 凿子, 台锯

**综合报告主题** (--general)：木材, 安全, 涂装, 入门, 项目, 机械

执行步骤：
1. 在技能目录下运行 Python 脚本生成 HTML 内容
2. 将 HTML 写入当前工作目录的 `woodworking_report.html`
3. 使用 present_files 展示报告给用户

### 4. 回复用户

在展示报告后，根据用户的问题提供文字总结，包括：
- 核心要点概述
- 关键数字/参数提醒
- 下一步学习建议
- 相关主题推荐

## 交互示例

**用户问**：「燕尾榫怎么做？」
→ 加载知识库燕尾榫部分 → 运行 `--detail 燕尾榫` → 展示报告 + 总结要点

**用户问**：「我想学木工，零基础怎么入门？」
→ 加载知识库入门部分 → 运行 `--general 入门` → 展示报告 + 工具清单 + 第一个项目推荐

**用户问**：「台锯怎么选？预算3000」
→ 加载知识库台锯部分 → 运行 `--detail 台锯` → 展示报告 + 选购建议 + 安全提醒

**用户问**：「帮我对比一下木蜡油和清漆」
→ 加载知识库涂装部分 → 运行 `--general 涂装` → 展示报告 + 对比分析

## 注意事项

- 始终强调安全 — 任何时候涉及电动工具都附带安全提醒
- 难度标注透明 — 明确告知每个技术的难度等级
- 精度要求量化 — 给出具体的公差数字(mm/角度)
- 实用优先 — 推荐适合中国市场的工具品牌和购买渠道
- 传统文化尊重 — 中式榫卯(粽角榫等)作为文化遗产给予特别尊重