中文概述 · 根据原始文档整理，完整规则与命令请查看「文件」中的 SKILL.md。

FunSkill 打包助手

解决什么问题

把 Skill 整理成网站能自动读取的文件包，同时创作统一、易识别的 Skill Logo，免去重复填表和发布后补图。只补必要说明，不改变原有能力。

适用与不适用场景

用于整理和更新用户指定的 Skill；不自动运行目标脚本、安装目标 Skill 或发布网站。

需要准备什么输入

提供 Skill 文件夹即可。先一次扫描现有 SKILL.md、网站信息、关联文件和 Logo，再自动推断可确定的信息；只把没有证据或存在冲突的必要项合并成一次提问。保留原作者署名，不把本助手作者当作目标 Skill 作者。已有合格的 skill-logo.webp 时优先复用。

三分钟快速开始

将文件夹交给 AI：“使用 FunSkill 打包助手处理这个文件夹并输出 ZIP。”助手会补齐信息、创作或复用 Logo、校验文件并打包；默认在目标文件夹旁输出 <slug>-<version>.zip，不会覆盖已有文件。

完整操作步骤

一次扫描：读取 SKILL.md、funskill.json、必要关联文件和现有 Logo，同时建立文件清单；后续复用这次扫描结果，不重复读取同一资料。所有整理都在副本中完成，不运行目标脚本。
自动推断并一次提问：已有 funskill.json 优先；否则从 YAML name、H1、description、作者章节、文件夹名称和实际内容推断 slug、名称、简介、作者、分类与标签。首次发布使用 1.0.0，更新沿用 slug 并默认递增补丁版本；schemaVersion 和 Logo 路径使用固定值。不得猜测作者或验证结果。仍无法确定或资料互相冲突时，把所有必要问题合并后询问一次。
并行整理：确定名称和用途后，在环境支持并行任务时同时处理三项：补齐九项文档、创作或校验 Logo、扫描符号链接/凭据/文件大小与引用；只在三项完成后进入打包。文档简短即可，不适用项说明原因，不编造示例。Logo 从名称和用途提取一个核心动作或对象，采用 192×192 透明画布、纯色圆角底、实心白色主形和约 72% 白色辅助块；白色主体控制在 112–128px 内，只使用 1–4 个粗壮形体，禁止文字、渐变、阴影、发光、描边堆叠、3D 和复杂场景。导出根目录 skill-logo.webp，静态 WebP 不超过 24KB，并以 40px、45px 和 70px 检查辨识度。无法生成合格图片时明确说明缺口，不用随机占位图冒充最终 Logo。
一次校验并打包：只保留使用所需文件，排除凭据、缓存和无关输出；网站展示图片压缩为 WebP，原始工作素材保持原格式。运行下方命令；脚本会尽可能一次列出全部问题，集中修正后重试，并交付最终 ZIP 路径。

{
  "schemaVersion": 1,
  "slug": "your-skill-name",
  "title": "Skill 名称",
  "summary": "一句话说明用途",
  "author": "目标 Skill 的真实作者",
  "discipline": "设计",
  "tags": [],
  "version": "1.0.0",
  "logo": "skill-logo.webp"
}

分类可选设计、开发、运营、产品。格式、长度和文件大小限制由脚本检查，不在说明中重复列举。

python3 <本助手路径>/scripts/package.py <目标Skill文件夹>

默认输出到目标文件夹旁的 <slug>-<version>.zip；只有需要指定其他位置时才添加 --output <新ZIP路径>。目标文件已存在时停止，不覆盖旧包。

输出示例和可下载文件

交付一个 ZIP，根目录包含 SKILL.md、funskill.json、skill-logo.webp 及必要参考文件、脚本和素材。示例命名：your-skill-name-1.0.0.zip；同时说明采用的 Logo 隐喻与主题色，只提供实际生成文件的下载路径。

常见失败及处理方式

脚本会在一次运行中尽可能列出全部问题，按清单集中修正。缺章节或元数据：补齐对应内容。版本重复：递增版本号。Logo 缺失或不合格：重新生成 192×192 的静态 WebP，简化图形或提高压缩率。文件超限：移除无关内容或压缩展示图片。目标 ZIP 已存在：换版本号、指定新路径或明确处理旧文件，不自动覆盖。网站未通过：把完整问题清单带回修正并重新打包。结构校验通过不代表功能实测通过。

作者、协作者和维护人

作者：庞伟深。维护人：庞伟深。协作者：未指定。

版本、更新时间、最后验证时间

版本：1.2.0。更新时间：2026-09-29。最后验证时间：2026-09-29，校验范围为默认命名、多问题汇总、ZIP 完整性、Logo 格式与网站规范检测，不包含目标 Skill 的功能效果。