马维斯化器

它解决什么问题

GitHub 上积累了大量 agent skill 仓库，但结构并不统一：有的把内容拆进多个子文件，有的在正文里直接调用 specify-cli 等命令行工具，还有的针对特定平台做了适配。这些差异导致同一个技能很难原样迁移到 Marvis 环境中运行。

马维斯化器的目标就是消除这种迁移成本：输入一个 GitHub 仓库 URL，自动完成格式转换、依赖抽象、元信息生成和封面制作，产出一个符合 Marvis 标准、可直接安装的单一技能。

它如何工作

整个流程是一条四步流水线：

1. 拉取（Pull）

从 URL 提取 owner/repo，并行拉取 SKILL.md、README.md、子引用文件和 LICENSE。若 web_fetch 遇到登录或浏览器重试错误，自动切换到 browser Sub Agent。

2. 内化（Internalize）

这是核心步骤，做三件事：

合并子文件：将分散的子文件内容按章节内联进主 SKILL.md，去除原有引用链接。

适配工具环境：CLI 依赖（如 uv tool install specify-cli）抽象为方法论，用 Marvis 自带的 write_file、shell_executor、python_executor 替代；特定 Agent 表述替换为通用表述；外部 API 依赖保留并注明需用户自行配置。

补充 frontmatter：按规则填写 name、displayName、description、tags、license、sources.note 等字段，并根据内容判定技能类型（八类之一）。

3. 注册（Register）

生成 meta.json，所有字段必填。display_name ≤8 字，display_description ≤20 字，use_cases 写 4 条自然语言触发语。md5 由 md5sum 对最终文件计算。写入 skills/market/ 即完成商店同步。

4. 补图（Cover）

用 Python 生成 400×240 SVG 卡片封面，含半透明网格背景、按类型定制的几何图标。配色按技能类型区分：开发工具深蓝配天蓝，设计工具深黑配紫色。体积控制在 1.8–2.4KB。

适用边界

• 只处理包含 SKILL.md 或 README.md 的 agent skill 仓库；纯 CLI 项目会被抽象为方法论，不保留可执行依赖
• 缺少 LICENSE 时默认按 MIT 处理
• 外部 API 依赖需用户自行配置
• 仓库需要登录时，拉取环节自动切换到 browser Sub Agent，属于正常降级路径