document-generation

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:

1. workspace_list_files to map project structure
2. Read key configuration files to identify components
3. Identify communication patterns (REST, WebSocket, MCP)
4. 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: