← 返回 Skills 市场
Swagger2 To Openapi3
作者
wangteng85859
· GitHub ↗
· v1.0.0
· MIT-0
124
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install swagger2-to-openapi3
功能描述
Use when migrating Java Spring Boot projects from Swagger 2 (Springfox) to OpenAPI 3.0 (SpringDoc), including annotation replacements, import updates, and ja...
安全使用建议
This skill appears to do what it says: run the included Python scripts to migrate Swagger 2 annotations/imports to OpenAPI 3. Before running: 1) Ensure your project is committed to version control or backed up (the scripts overwrite files). 2) Always run with --dry-run first and review the diffs. 3) Be aware the tools use regular expressions (not an AST parser) and may produce false positives/negatives or alter comments/strings in edge cases — manually inspect complex cases (responses, ApiImplicitParam, custom annotations). 4) Confirm you have Python 3 available and run tests/compile after migration. If you need stronger guarantees, consider using a parser-based migration or adding automatic backups.
功能分析
Type: OpenClaw Skill
Name: swagger2-to-openapi3
Version: 1.0.0
The skill bundle is a legitimate utility designed to automate the migration of Java Spring Boot projects from Swagger 2 (Springfox) to OpenAPI 3.0 (SpringDoc). It consists of a shell wrapper (migrate.sh) and Python scripts (migrate_annotations.py, migrate_imports.py, migrate_swagger_to_openapi.py) that perform regex-based text replacements on .java files to update annotations and import statements (including javax to jakarta migration). The code logic is transparent, lacks any network activity or data exfiltration, and includes safety features like a dry-run mode and directory exclusion (e.g., .git, target).
能力评估
Purpose & Capability
The name/description, SKILL.md, README, examples, shell wrapper, and three Python scripts all implement Java migration (annotation and import replacements and javax→jakarta changes). Required resources (none) and files included are appropriate for that purpose.
Instruction Scope
Runtime instructions explicitly tell the agent/user to run the included Python scripts against a provided project path. The scripts walk the given project tree, read .java files, and (unless --dry-run) overwrite them. They do not read environment variables, contact remote endpoints, or access files outside the provided project path, but they will modify arbitrary files under the supplied directory — use backups or VCS.
Install Mechanism
No install spec; this is instruction-only with included local scripts. Scripts run with the host Python interpreter; nothing is downloaded or installed from external URLs.
Credentials
The skill declares no environment variables or credentials. The scripts only require filesystem access to the project path provided at runtime, which is proportional to the declared functionality.
Persistence & Privilege
always is false and the skill does not request persistent or system-wide configuration. It does not modify other skills or agent settings. Note: default autonomous invocation is allowed by platform but not a problem here given the lack of excessive privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install swagger2-to-openapi3 - 安装完成后,直接呼叫该 Skill 的名称或使用
/swagger2-to-openapi3触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release — comprehensive migration guide for upgrading from Swagger 2 (Springfox) to OpenAPI 3.0 (SpringDoc) in Java Spring Boot projects.
- Provides annotation replacement tables and code examples for all major API documentation annotations.
- Details package import changes (swagger.annotations → swagger.v3.oas.annotations, javax.* → jakarta.*).
- Includes automated migration script instructions for batch processing of annotations and packages.
- Covers common migration issues and solutions, including Swagger UI path changes and jakarta migration tips.
- Offers practical step-by-step and manual review guidance for complex migration scenarios.
元数据
常见问题
Swagger2 To Openapi3 是什么?
Use when migrating Java Spring Boot projects from Swagger 2 (Springfox) to OpenAPI 3.0 (SpringDoc), including annotation replacements, import updates, and ja... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 124 次。
如何安装 Swagger2 To Openapi3?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install swagger2-to-openapi3」即可一键安装,无需额外配置。
Swagger2 To Openapi3 是免费的吗?
是的,Swagger2 To Openapi3 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Swagger2 To Openapi3 支持哪些平台?
Swagger2 To Openapi3 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Swagger2 To Openapi3?
由 wangteng85859(@wangteng85859)开发并维护,当前版本 v1.0.0。
推荐 Skills