openapi-spec-generation – skill Lập trình cho agent AI
Tạo và duy trì đặc tả OpenAPI 3.1 từ mã nguồn, đặc tả thiết kế trước (design-first) và các mẫu kiểm tra hợp lệ. Dùng khi tạo tài liệu API, sinh SDK hoặc đảm bảo API tuân thủ hợp đồng.
Cài skill openapi-spec-generation bằng một lệnh
Chọn công cụ bạn đang dùng, copy lệnh và dán vào terminal. Skill sẽ nằm trong thư mục skills của công cụ đó và sẵn sàng dùng ở phiên làm việc tiếp theo.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/openapi-spec-generation-90934.tgz | tar xz -C ~/.claude/skills
Gọi trong Claude Code: /openapi-spec-generation – rồi mô tả công việc bạn muốn làm.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/openapi-spec-generation-90934.tgz | tar xz -C ~/.codex/skills
Gọi trong Codex: $openapi-spec-generation – rồi mô tả công việc bạn muốn làm.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/openapi-spec-generation-90934.tgz | tar xz -C ~/.hermes/skills
Gọi trong Hermes Agent: /openapi-spec-generation – rồi mô tả công việc bạn muốn làm.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/openapi-spec-generation-90934.tgz | tar xz -C ~/.deepcode/skills
Gọi trong DeepSeek: /openapi-spec-generation – rồi mô tả công việc bạn muốn làm.
Nội dung SKILL.md
Nội dung SKILL.md gốc bằng tiếng Anh.
OpenAPI Spec Generation
Comprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs.
Use this skill when
- Creating API documentation from scratch
- Generating OpenAPI specs from existing code
- Designing API contracts (design-first approach)
- Validating API implementations against specs
- Generating client SDKs from specs
- Setting up API documentation portals
Do not use this skill when
- The task is unrelated to openapi spec generation
- You need a different domain or tool outside this scope
Instructions
- Clarify goals, constraints, and required inputs.
- Apply relevant best practices and validate outcomes.
- Provide actionable steps and verification.
- If detailed examples are required, open
resources/implementation-playbook.md.
Resources
resources/implementation-playbook.mdfor detailed patterns and examples.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Skill liên quan
- openapi-spec-generator – Tạo đặc tả OpenAPI 3.x và Swagger 2.0 hoàn chỉnh, sẵn sàng cho production từ mô tả bằng…
- openclaw-github-repo-commander – Quy trình siêu cấp 7 bước để kiểm toán, dọn dẹp, review PR và phân tích đối thủ cho repo…
- opencode-delegate – Giao tác vụ lập trình cho OpenCode CLI chỉ khi người dùng yêu cầu rõ ràng, trong khi bộ…
- orchestrate-batch-refactor – Lập kế hoạch và thực hiện các đợt refactor lớn với các gói công việc có tính đến phụ…
- papers-skill – Kỹ năng cho quy trình nghiên cứu học thuật: tìm kiếm trên Semantic Scholar (hơn 200…
- parcel-coupon – Gọi API phiếu giảm giá bưu kiện/chuyển phát để lấy phiếu dịch vụ logistics trọn gói, bao…
- penetration-testing – Thực hiện kiểm thử xâm nhập cơ bản và đánh giá bảo mật.
- performance-engineer – Chẩn đoán nút thắt hiệu năng bằng profiling, trace, kiểm thử tải và observability; xác…