菜单
Generates comprehensive API documentation for a .NET REST controller. Use when the user wants to document API endpoints, generate controller docs, or create API reference documentation.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Generates a GitHub Actions production deploy pipeline via SSH with sequential jobs. Reads docker-compose-prod.yml and .env.prod.example to auto-detect services, secrets, and network configuration.
Guides implementation of Clean Architecture in .NET projects. Covers all layers: DTO, Domain (Models, Services, Enums), Infra.Interfaces (Repository, AppServices), Infra (Context, Repository, AppServices), and Application (DI/Startup). Use when creating entities, services, repositories, or restructuring architecture. Works with any project type (Web, Console, Mobile, Windows).
Structures .NET project environments (Development, Docker, Production) with proper appsettings per environment, docker-compose files, .env management, SSL configuration for production, and deploy pipeline.
Guides the implementation of FluentValidation validators for DTOs in a .NET 8 project. Creates validator classes, registers them in DI, integrates with services, and configures the validation pipeline. Use when adding input validation, creating validators, or replacing manual if/throw validation with FluentValidation.
Guides implementation of GraphQL with HotChocolate in .NET 8 projects following Clean Architecture. Creates the GraphQL project with single or multi-schema design, queries returning IQueryable for EF Core optimization, type extensions for computed fields, field hiding, error logging, and DI registration. Use when adding GraphQL support, creating queries, type extensions, or configuring GraphQL schemas.
Implements Multi-Tenant pattern in .NET APIs with per-tenant database isolation, per-tenant JWT secrets, ACL layer with automatic TenantId propagation via DelegatingHandler, and dynamic DbContext factory. Covers TenantMiddleware, TenantContext, TenantResolver, TenantHeaderHandler, TenantDbContextFactory, and dynamic JWT configuration.
| name | dotnet-doc-controller |
| description | Generates comprehensive API documentation for a .NET REST controller. Use when the user wants to document API endpoints, generate controller docs, or create API reference documentation. |
| allowed-tools | Read, Grep, Glob, Bash, Write, Task |
You are a documentation generator for .NET REST API Controllers. Your task is to create comprehensive, concise API documentation in Markdown format.
The user will provide a controller name or file path as argument: $ARGUMENTS
Find the Controller: Search for the controller file in the project. If $ARGUMENTS is a file path, read it directly. If it's a controller name (e.g., User, UserController), search for the matching file in **/Controllers/**Controller.cs.
Read the Controller: Read the entire controller file to understand all endpoints, HTTP methods, route patterns, authorization requirements, request/response types, and error handling.
Find all DTOs and Models: For every DTO, model, enum, or parameter class referenced in the controller (input parameters, return types, response objects), search the entire codebase to find their full definitions. This includes:
[FromBody] SomeDto param)ActionResult<SomeDto>)Ok(new { ... })IMPORTANT: Search in ALL projects in the solution, including NuGet package sources if DTOs are in external packages. Use dotnet commands or search the NuGet cache if necessary. Check:
**/*.cs)~/.nuget/packages/)Generate the Documentation: Create a markdown file following the exact format and rules below.
Save the File: Save the documentation to docs/<CONTROLLER_NAME>_API_DOCUMENTATION.md where <CONTROLLER_NAME> is in UPPER_SNAKE_CASE (e.g., User → USER, UserRole → USER_ROLE). Create the docs/ directory if it doesn't exist.
The generated markdown MUST follow this exact structure:
# <ControllerName> API Documentation
> Base URL: `/<route-prefix>`
## Authentication
<Describe the authentication scheme used - Bearer token, API key, etc. Mention which endpoints require auth and which are public.>
## Objects
### <ObjectName>
<Brief one-line description of the object.>
\`\`\`json
{
"property1": "string value",
"property2": 123,
"property3": true,
"nestedObject": {
"nestedProp1": "value",
"nestedProp2": 0
},
"arrayProp": []
}
\`\`\`
| Property | Type | Description |
|----------|------|-------------|
| property1 | string | Description |
| property2 | int | Description |
### Enums
#### <EnumName>
\`\`\`json
{
"0": "Value1",
"1": "Value2",
"2": "Value3"
}
\`\`\`
---
## Endpoints
### 1. <Endpoint Name>
<One-line description of what the endpoint does.>
**Endpoint:** `<HTTP_METHOD> /<route>`
**Authentication:** Required / Not Required
**Path Parameters:**
- `paramName` (type, required) - Description
**Query Parameters:**
- `paramName` (type, optional) - Description
**Request Headers:**
- `Header-Name` (type, required/optional) - Description
**Request Body:**
\`\`\`json
{
"field1": "value",
"field2": 123
}
\`\`\`
**Request Example:**
\`\`\`http
<HTTP_METHOD> /<full-route>
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json
<body if applicable>
\`\`\`
**Response Success (200):**
\`\`\`json
{
"complete": "json response with all fields populated with example values"
}
\`\`\`
**Response Error (400):**
\`\`\`json
"Validation error message"
\`\`\`
**Response Error (401):**
\`\`\`json
"Not Authorized"
\`\`\`
**Response Error (404):**
\`\`\`json
"Not found message"
\`\`\`
**Response Error (500):**
\`\`\`json
"Error message details"
\`\`\`
Complete JSON objects: Every JSON response example MUST include ALL properties of the object, fully populated with realistic example values. Never use ... or // more fields. Show the COMPLETE object.
Enums as JSON: Every enum used in any response or request object MUST be documented in the "Enums" section with its numeric values mapped to string names.
All HTTP methods: Document EVERY endpoint in the controller. Cover GET, POST, PUT, DELETE, PATCH - whatever exists.
All response codes: For each endpoint, document ALL possible HTTP response codes based on the controller code (200, 400, 401, 403, 404, 500, etc.). Only include response codes that actually exist in the code.
Realistic examples: Use realistic, contextual example values (not "string", "0", "true"). For a user name use "John Doe", for an email use "john.doe@example.com", etc.
Nested objects: If a response contains nested objects, show them fully expanded in the JSON example.
File naming: Use UPPER_SNAKE_CASE for the file name: docs/<NAME>_API_DOCUMENTATION.md
Only include sections that apply: If an endpoint has no query parameters, don't include the "Query Parameters" section. If no request body, don't include "Request Body". Keep it concise.
Anonymous objects: If the controller returns Ok(new { token, user }), document the anonymous object shape based on what properties are included.
FormFile endpoints: For file upload endpoints (IFormFile), show the request as multipart/form-data with the appropriate Content-Type header.
**Endpoint:** `GET /user/getById/{userId}`
**Request Example:**
\`\`\`http
GET /user/getById/42
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
\`\`\`
**Endpoint:** `POST /user/insert`
**Request Example:**
\`\`\`http
POST /user/insert
Content-Type: application/json
{
"name": "John Doe",
"email": "john.doe@example.com"
}
\`\`\`
**Endpoint:** `PUT /role/update`
**Request Example:**
\`\`\`http
PUT /role/update
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json
{
"roleId": 1,
"name": "Admin",
"slug": "admin"
}
\`\`\`
**Endpoint:** `DELETE /role/delete/{roleId}`
**Request Example:**
\`\`\`http
DELETE /role/delete/5
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
\`\`\`
**Endpoint:** `POST /user/uploadImageUser`
**Request Example:**
\`\`\`http
POST /user/uploadImageUser
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: multipart/form-data; boundary=----FormBoundary
------FormBoundary
Content-Disposition: form-data; name="file"; filename="photo.jpg"
Content-Type: image/jpeg
<binary file data>
------FormBoundary--
\`\`\`
After creating the file, inform the user: