---
name: zh-docgen
description: 中文文档生成器 - 从代码库自动生成中文技术文档
---

# 中文文档生成器

## 触发条件
当用户要求生成文档、写技术文档、生成 API 文档、项目说明时激活此技能。

## 工作流程

1. **扫描项目结构** — 识别项目类型（Web 应用/CLI 工具/库/服务）
2. **分析代码** — 提取模块、函数、类、接口的签名和注释
3. **生成文档** — 输出以下文档：

### 生成内容
- **项目概述** — 中文简介、技术栈、架构图（Mermaid）
- **快速开始** — 安装、配置、运行步骤
- **API 参考** — 自动生成的接口文档
- **使用示例** — 常见场景的代码示例
- **常见问题** — FAQ 部分

## 输出格式
生成一个或多个 Markdown 文件，中文为主，技术术语保留英文。

## 技巧
- 优先读取已有 README、package.json、pyproject.toml 获取项目元信息
- 分析 import/require 语句推断依赖关系
- 从 docstring/JSDoc 提取已有文档