docgen
[UDS] 從專案原始檔產生使用文件（速查表、參考手冊、使用指南）。 Use when: 從 CLI 與 Skill 定義產出速查表或功能參考手冊、指令變更後重新產生文件、確認產生的文件是否為最新。 Not for: 決定專案需要哪些文件或手寫敘述性內容——請用 /documentation-guide；變更日誌條目——請用 /changelog。 Keywords: docgen, usage docs, cheatsheet, feature reference, generated documentation, 使用文件, 速查表, 文件產生, 參考手冊.
来源信息
- 仓库
- AsiaOstrich/universal-dev-standards
- 最近来源活动
- 2026年8月20日 06:47
- 检测到的 SKILL.md 语言
- 中文
- 星标
- 75
- 分支
- 13
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
2 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- docgen
- source
- ../../../../skills/docs-generator/SKILL.md
- source_version
- 1.0.0
- translation_version
- 1.1.0
- last_synced
- 2026-08-17T00:00:00.000Z
- status
- current
- description
- [UDS] 從專案原始檔產生使用文件（速查表、參考手冊、使用指南）。 Use when: 從 CLI 與 Skill 定義產出速查表或功能參考手冊、指令變更後重新產生文件、確認產生的文件是否為最新。 Not for: 決定專案需要哪些文件或手寫敘述性內容——請用 /documentation-guide；變更日誌條目——請用 /changelog。 Keywords: docgen, usage docs, cheatsheet, feature reference, generated documentation, 使用文件, 速查表, 文件產生, 參考手冊.
- allowed-tools
- Read, Write, Grep, Glob, Bash(*)
- scope
- universal
- argument-hint
- [config file | 設定檔]
# 文件產生器
> **語言**: [English](../../../../skills/docs-generator/SKILL.md) | 繁體中文
從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）。
## 工作流程
1. **讀取設定** - 載入 `.usage-docs.yaml`（或指定的設定檔）
2. **掃描來源** - 讀取原始碼檔案、命令和技能定義
3. **提取內容** - 從原始碼解析描述、選項、範例
4. **產生文件** - 以設定的格式產生輸出
5. **寫入輸出** - 將產生的檔案儲存到設定的輸出目錄
## 設定檔格式
```yaml
# .usage-docs.yaml
output_dir: docs/generated/
formats:
- cheatsheet
- reference
sources:
- path: skills/commands/
type: commands
- path: cli/src/commands/
type: cli
language: [en, zh-TW]
```
## 輸出類型
| 類型 | 說明 |
|------|------|
| **cheatsheet** | 速查表，包含命令和快捷鍵 |
| **reference** | 完整功能參考手冊，包含所有選項 |
| **usage-guide** | 新手入門使用指南 |
## 使用方式
- `/docgen` - 使用預設的 `.usage-docs.yaml` 產生文件
- `/docgen .usage-docs.yaml` - 從指定的設定檔產生文件
- `/docgen --format cheatsheet` - 僅產生速查表
## 檢查模式
驗證產生的文件是否與原始檔案保持同步。
**使用方式：**
```bash
# 檢查產生的文件是否同步
./scripts/check-usage-docs-sync.sh
# 自動修復不同步的文件
./scripts/check-usage-docs-sync.sh --fix
```
- **檢查模式**（預設）：報告原始檔與產生文件之間的差異。若不同步則以非零狀態退出。
- **修復模式**（`--fix`）：自動重新產生過期的文件。
> **注意**：此檢查已整合至 `pre-release-check.sh` 的步驟 8（使用文件同步檢查）。
## 下一步引導
`/docgen` 完成後，AI 助手應建議：
> **文件已產生。建議下一步：**
> - 審查產生的文件內容是否完整
> - 執行 `/commit` 提交文件變更
> - 執行 `/code-review` 審查文件品質
## 參考
- 詳細指南：[guide.md](./guide.md)
在 GitHub 查看