minipower-backend-swashbuckle-dotnet
Thiết lập Jarvis.Swashbuckle — Swagger/OpenAPI đa phiên bản, BaseResponse schema, security JWT/API Key. Dùng khi tích hợp Swagger .NET với Jarvis API response wrapper.
- License 许可
- MIT
- 最近更新
- 2026-11-09
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- minipower-backend-swashbuckle-dotnet
- metadata
- { "workflow": "github" }
- description
- Thiết lập Jarvis.Swashbuckle — Swagger/OpenAPI đa phiên bản, BaseResponse schema, security JWT/API Key. Dùng khi tích hợp Swagger .NET với Jarvis API response wrapper.
02 资源文件 5
- 参考文档README.md1.3 KB
- 参考文档templates/appsettings-swagger.json200 B
- 其他templates/program-setup.cs559 B
- 参考文档workflows/add.md988 B
- 参考文档workflows/init.md1.4 KB
03 SKILL.md 正文
Jarvis.Swashbuckle — Orchestrator
Skill điều phối Jarvis.Swashbuckle trên ASP.NET Core. Hướng dẫn: README.md.
Khi nào dùng workflow nào
| Tình huống | Workflow |
|---|---|
| Project chưa có Swagger Jarvis | workflows/init.md |
| Thêm version / security scheme | workflows/add.md |
Quy tắc cốt lõi
builder.AddCoreSwagger()sauAddCoreWebApi/ API versioning.app.UseCoreSwagger()trướcMapControllers(theo pipeline Host Jarvis).- Section
Swaggertrong appsettings —Enable,Versions,SecuritySchemes. - API versioning: host đăng ký
AddApiVersioning+AddApiExplorer(không nằm trong package Swashbuckle). - XML examples:
IExamplesProvider<>+<GenerateDocumentationFile>true</GenerateDocumentationFile>.
Package
| PackageId | Version* |
|---|---|
Jarvis.Swashbuckle |
1.0.1 |
Phụ thuộc Jarvis.DDD.Domain.Shared, Swashbuckle, Asp.Versioning (host).
Providers (atomic)
| Provider | Path |
|---|---|
| JWT security | providers/jwt-security/SKILL.md |
| API Key security | providers/api-key-security/SKILL.md |
Templates
Output bắt buộc
AddCoreSwagger/UseCoreSwaggerappsettingssectionSwagger- Swagger UI mở được; schema
BaseResponsecho path/api - Code C# theo minipower-backend-convention-dotnet —
dotnet format --verify-no-changessạch trên file đã chạm - File đặt đúng layer + hướng phụ thuộc theo minipower-backend-architecture-dotnet —
dotnet test -c Debugxanh, kể cả{Product}.ArchitectureTests
04 同仓库更多 Skills
minipower-vcs-gitlab
Tra GitLab (search, issue, pipeline, MR), soạn MR/comment, tạo MR và commit/push sau L2. Dùng khi merge request, GitLab MCP, code_provider gitlab — không scaffold .NET, không force-push.
minipower-toolbox-skill-author
Viết và soát skill lá-rời Minipower (minipower-{module}-{capability}) — chọn module bằng 3 câu hỏi ADR-022, dựng cây SKILL.md/README.md/workflows/providers, đặt description kích hoạt được, cập nhật hub và test canh. Hỏi người xác nhận trước mọi quyết định, không tự chốt. Dùng khi tạo skill mới, thêm provider/pattern/workflow, mở module mới, hoặc soát skill có sẵn lệch chuẩn.
minipower-tasks-lark
Đọc, lọc, tìm, soạn nháp và ghi task Lark (tasklist / task) theo L1–L3. Dùng khi việc trên Lark, sprint, tasklist, "tìm task", "tạo task", tasks_provider lark — không dùng cho tin nhắn nhóm hay wiki.
minipower-support-registry
Rà registry DOC theo project_mode, nhắc owner thiếu ID hoặc chỗ lưu sai. Dùng khi doc-registry, thiếu DOC, rà soát tiêu chuẩn — không tự sửa FR, không init.
minipower-support-publish
暂无简介
minipower-router
Phân loại intent Minipower rồi gợi ý đúng một pack nghề hoặc kênh. Dùng khi làm gì tiếp, chọn skill, dispatcher, không biết mở pack nào — không tự gọi MCP L3, không spawn agent.