| name | document-generation |
| description | Generates structured documents including architecture diagrams (Mermaid), usage manuals, progress reports, and API documentation from code analysis. |
| tags | ["document","generate","diagram","manual","report","api-doc","mermaid","architecture"] |
| stage | evaluation |
| type | delivery-skill |
| category | DELIVERY |
| scope | PLATFORM |
| version | 1.0 |
| author | forge-team |
Document Generation Skill
Purpose
Generates various types of project documentation by analyzing the codebase, knowledge base, and project artifacts. Supports architecture diagrams (Mermaid), usage manuals, progress reports, and API documentation.
When to Use
- "生成架构图" / "generate architecture diagram"
- "生成使用手册" / "create usage manual"
- "把进展写成报告" / "generate progress report"
- "生成 API 文档" / "create API documentation"
- "写周报" / "create weekly summary"
Document Types
1. Architecture Diagram (Mermaid)
Analyze the project structure and generate Mermaid diagrams:
graph TB
subgraph "Frontend"
UI[Next.js App]
end
subgraph "Backend"
API[Spring Boot API]
WS[WebSocket Handler]
end
subgraph "Services"
Agent[Claude Agent]
MCP[MCP Proxy]
end
UI --> API
UI --> WS
API --> Agent
WS --> Agent
Agent --> MCP
Process:
workspace_list_files to map project structure- Read key configuration files to identify components
- Identify communication patterns (REST, WebSocket, MCP)
- Generate appropriate diagram type:
- C4 Context: System boundaries and external actors
- C4 Container: Internal services and data stores
- Sequence: Request/response flows
- Class: Domain model relationships
- ER: Database schema
2. Usage Manual
Template:
# [Project Name] Usage Manual
## Quick Start
[Minimal steps to get running]
## Prerequisites
[Required software, accounts, configs]
## Installation
[Step-by-step installation]
## Configuration
[Environment variables, config files]
## Features
### [Feature 1]
[Description + screenshots/examples]
### [Feature 2]
[Description + screenshots/examples]
## Troubleshooting
| Problem | Solution |
|---------|----------|
| ... | ... |
## FAQ
[Common questions and answers]
Process:
