← 返回 Skills 市场
106
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install magic-plus
功能描述
面向 magic-api 开发、排障、二开与升版审查的本地源码技能。基于 magic-api、magic-api-plugin、magic-script、magic-api-example 四个仓库整理，强调按问题类型快速定位源码、样例与升级审查资料。
使用说明 (SKILL.md)
magic 开发增强技能
这是一份面向 magic-api 实战开发 的本地技能入口。
它不重复展开完整教程，而是把 4 个本地仓库和 references/ 下的资料组织成一条更适合 Claude 使用的检索路径：先判断问题类型，再去最合适的样例、源码或审查文档。
这份 skill 适合处理什么问题
优先用于这些场景：
- 写
.ms接口、CRUD、分页、事务、文件响应 - 理解
db/request/response/http等模块怎么工作 - 做自定义模块、函数、扩展方法、provider、interceptor、starter
- 对照 example 和源码排查“不生效 / 报错 / 行为不一致”
- 分析 magic 版本升级影响，输出审查结论和改造方案
四个仓库怎么分工
先记住最短检索顺序：
magic-api：框架主实现，先看自动配置、资源加载、内置模块、扩展注册magic-script：脚本语言与运行时，先看编译、执行、import、exit、上下文变量magic-api-example：现成.ms样例、扩展模板、Spring Boot 示例配置magic-api-plugin：插件 / starter 做法，适合对照自动配置和配置元数据
常用入口：
- 自动配置入口：
magic-api/magic-api-spring-boot-starter/src/main/java/org/ssssssss/magicapi/spring/boot/starter/MagicAPIAutoConfiguration.java - 配置定义：
magic-api/magic-api/src/main/java/org/ssssssss/magicapi/core/config/MagicAPIProperties.java - 脚本运行时：
magic-script/src/main/java/org/ssssssss/script/MagicScript.java - 上下文变量：
magic-script/src/main/java/org/ssssssss/script/MagicScriptContext.java - 示例配置与扩展入口：
magic-api-example/src/main/resources/application.yml、magic-api-example/src/main/java/org/ssssssss/example/configuration/MagicAPIConfiguration.java
按目录找入口时，先看 仓库目录导航。
Claude 使用这份 skill 的回答策略
默认按下面顺序回答：
- 先判断问题类型：现成写法 / 原理 / 排障 / 二开 / 插件 / 升版
- 先给最短结论：先回答“怎么做”或“先查哪里”
- 能给样例就先给样例：优先
.ms样例和 example 扩展类 - 再补源码依据：需要解释原理时再回到
magic-api/magic-script - 排障先给排查顺序：先说配置、资源、模块、运行时各查什么
- 二开先判断扩展点类型：模块 / 函数 / 扩展方法 / provider / interceptor / starter
- 升版先识别版本与使用面：先看当前版本、目标版本、脚本/扩展/插件使用范围，再给建议
如果要展开具体回答结构，先看 回答组织手册。
什么时候先看哪组资料
1. 入门与现成示例
先看这组：当你要 马上给脚本、配置或业务示例。
2. 源码与扩展
先看这组：当你要 解释原理、定位实现、判断扩展点。
3. 检索与回答
先看这组：当你要 快速决定先读哪份源码、先怎么排查、怎么组织答案。
4. 升版审查
先看这组：当你要 分析用户项目升级影响并输出审查结论。
推荐顺序：quick-prompt -> checklist -> template -> example，必要时再补 upgrade-migration-guide。
使用原则
- 要现成方案：先找
magic-api-example和基础 references - 要解释机制：先看
architecture.md、script-runtime.md、extensions.md - 要做插件 / starter：先看
magic-api-plugin和examples-and-plugins.md - 要定位目录：先看
repo-map.md - 要排障：先看
troubleshooting.md - 要做升级审查：按升版专题资料的顺序走，不要一上来就给改法
这份 skill 的目标不是“把 magic-api 讲全”，而是让 Claude 在回答时 先给正确路径，再给正确内容，再给源码依据。
安全使用建议
This skill is an instruction-only guide for navigating local magic-api source and example repos. It does not install software or request credentials, but it assumes the agent can read your local repository tree and the references/ files mentioned in SKILL.md. Before enabling: confirm where your magic-api, magic-script, magic-api-example, and magic-api-plugin repos live (or ensure you only enable the skill in an environment where you want the agent to access those files). The only minor inconsistency is that the metadata does not declare required config paths even though the instructions reference specific local paths — that’s not dangerous, but you should verify the expected repo layout so the skill behaves as intended.
功能分析
Type: OpenClaw Skill
Name: magic-plus
Version: 1.0.2
The skill bundle is a documentation and navigation guide designed to help an AI agent assist with the development, troubleshooting, and upgrade review of the 'magic-api' framework. The instructions in SKILL.md focus on organizing local source code repositories and reference materials to provide structured technical support. No evidence of malicious intent, data exfiltration, or harmful execution was found.
能力评估
Purpose & Capability
Name/description (magic-api development, troubleshooting, examples, upgrade review) match the SKILL.md content. The skill is instruction-only and does not request unrelated binaries, credentials, or network installs — this is proportionate for a local code-navigation helper.
Instruction Scope
The SKILL.md explicitly instructs the agent to consult local repositories and files (e.g., magic-api/..., magic-script/..., references/*.md). This is expected for a local-source dev skill, but the registry metadata declares no required config paths: there is a mild mismatch. The agent will need read access to the user's local repo tree for the skill to be useful, so users should be aware the skill expects and will rely on those local files.
Install Mechanism
No install spec and no code files are present; this is low-risk and appropriate for an instruction-only local helper.
Credentials
The skill requests no environment variables, credentials, or external config paths. That matches the described local, read-oriented purpose.
Persistence & Privilege
always is false and the skill does not request persistent system presence or modify other skills. Autonomous invocation is allowed (platform default) and is reasonable for this helper.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install magic-plus - 安装完成后，直接呼叫该 Skill 的名称或使用
/magic-plus触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.2
- 保留整体 skill 入口结构和使用说明，但已不再包含本地引用文档内容。
- 该版本仅保留问题类型、四个主仓库分工和使用原则的说明。
v1.0.1
- 优化面向 magic-api 开发、排障、二开与升级审查的本地源码检索与答题路径
- 重点梳理 magic-api、magic-api-plugin、magic-script、magic-api-example 四个仓库的分工与资料入口
- 明确不同场景（开发、扩展、排障、升级审查）的优先答题策略与资料检索顺序
- 新增详细的仓库导航和答题组织参考，提升问题定位与回答效率
- 强调按问题类型快速定位最合适的样例、源码和升级支持资料
元数据
常见问题
magic-plus 是什么？
面向 magic-api 开发、排障、二开与升版审查的本地源码技能。基于 magic-api、magic-api-plugin、magic-script、magic-api-example 四个仓库整理，强调按问题类型快速定位源码、样例与升级审查资料。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 106 次。
如何安装 magic-plus？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install magic-plus」即可一键安装，无需额外配置。
magic-plus 是免费的吗？
是的，magic-plus 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
magic-plus 支持哪些平台？
magic-plus 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 magic-plus？
由 Kwin-lv（@kwin-lv）开发并维护，当前版本 v1.0.2。
推荐 Skills