# Section AI Tools

> 生成 AI 工具介绍类页面的超详细教程内容，强调工具对比、配置技巧与实战场景；当需要撰写 AI 工具介绍、配置指南、使用技巧类教程时使用

- Skill: `majiayu000/section-ai-tools` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/section-ai-tools`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/section-ai-tools/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/section-ai-tools

---

## 我做什么

- 为"AI 工具介绍"类页面生成不含代码的长篇实用教程
- 强调工具的使用场景、功能对比、配置方法、操作技巧与效果优化
- 以实际场景为导向，展示工具如何解决具体问题
- 输出可直接用于 `.rmd/.qmd` 的完整页面内容

## 核心原则

**必须查阅官方文档**：在撰写任何 AI 工具教程前，必须先获取并阅读该工具的官方文档。若无法找到官方文档，必须向用户询问文档来源或链接。

**不写代码**：本分类教程以文字说明、截图、配置示例、操作步骤为主，不涉及 R/Python 等编程代码。

## 输出结构要求

1. **工具简介与定位**

   - 工具是什么、解决什么问题
   - 官方网站、文档链接、版本信息
   - 与同类工具的核心差异
2. **适用场景分析**

   - 列出 3-5 个典型使用场景
   - 每个场景说明：问题背景、为何选择此工具、预期效果
   - 明确工具的适用边界（什么情况下不适合）
3. **工具对比**

   - 与同类工具的功能对比表
   - 优缺点分析
   - 选择建议（什么情况用什么工具）
4. **安装与配置**

   - 安装步骤（分平台说明）
   - 核心配置项解释
   - 推荐配置方案
   - 常见配置问题与排查
5. **功能详解与操作指南**

   - 核心功能逐一介绍
   - 每个功能配合操作步骤说明
   - 关键设置项的作用与调优建议
6. **场景实战**

   - 选择 2-3 个具体场景
   - 详细展示：问题描述 → 操作步骤 → 效果展示 → 优化技巧
   - 强调"如何做得更好"的进阶技巧
7. **效果优化与最佳实践**

   - 提升效率的技巧
   - 避免常见错误的建议
   - 高级用法与隐藏功能
8. **常见问题与解答**

   - 收集典型问题
   - 提供解决方案
9. **扩展资源**

   - 官方文档链接
   - 社区资源、教程推荐
   - 相关工具推荐

## 写作规范

- **内容标准**:
  - **详细度**: 内容必须详尽，起到深入教程的作用。
  - **篇幅**: 不少于 300 行 (Not less than 300 lines)。
  - **比例**: 文字说明约占 70%，配置/示例代码约占 30% (70% text, 30% config/examples)。
  - **结构**: 必须提前构建全面的内容框架，然后根据框架填充详细内容。
- 标题不要手动编号（如 `### 1. xxx`），项目已配置自动编号。
- 使用清晰的标题层级，章节结构完整。
- 文字为主，可适当使用表格、列表辅助说明。
- 配置示例使用 YAML/JSON/TOML 等格式的代码块展示，但不写编程代码。
- 操作步骤要具体、可执行，避免模糊描述。
- 场景实战部分要足够详细，读者能按步骤复现。
- 语言风格客观、实用、结构清楚，以段落叙述为主。
- 若文内没有图片，必须生成 SVG 封面并在 YAML 的 `image` 字段引用。

## 文档获取流程

1. **首先尝试获取官方文档**：使用 librarian agent 或 webfetch 工具查找官方文档。
2. **若找不到文档**：立即向用户询问，例如："我找不到 [工具名] 的官方文档，请问您能提供文档链接吗？"
3. **文档确认后再动笔**：确保对工具功能有准确理解后才开始撰写。

## 完成后操作

- 自动更新 `doc/_quarto.yml` 的侧边栏入口，在"机器学习与AI"分类下添加"AI 工具"子分类。
- 必须完成 3 项 render 验证且全部成功：
  - `quarto render doc/<当前文章>`
  - `quarto render doc/index.qmd`
  - `quarto render doc/sections/<对应分类>.qmd`
- 三项 render 全部通过后再执行其它操作`，确认无报错。
- **更新 `doc/0001-guide.rmd`**：在对应分类表格中添加新教程条目，保持与现有格式一致。
- **同步更新 `README.md`**：在对应分类的折叠块中添加新教程条目，保持与 guide 内容一致。README 中的教程链接使用 `.html` 后缀。
- 渲染完成后询问是否提交；用户确认后执行 commit，并push。

示例主题：OpenCode、Cursor、GitHub Copilot、Claude、ChatGPT 使用技巧等。
如果未指定具体工具或使用场景，请先提出澄清问题。