Yotta Skill Creator（元造）

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install yotta-skill-creator
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 yotta-skill-creator。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Yotta Skill Creator（又称元造）是一款零依赖 Python 工具，可通过内置模板创建标准化的 AI agent 技能目录。它会验证必需的 yotta- 命名规范、应用占位符、创建相应文件，并在报告成功前运行结构自检。
该工具专为 Openclaw Skills 工作流设计，支持完整的发布脚手架，也支持用于私有技能的轻量级 --self-use 模式。生成器会创建结构和模板，但有意不编写技能的生产逻辑、算法、测试或发布检查。

应用场景

从合规的起点创建新的
yotta-
技能。
生成完整的可发布技能包，包含文档、元数据、许可、安装程序、参考资料、资源和 CI 配置。
创建仅包含
SKILL.md
、参考资料和可选 CLI 文件的私有或内部技能。
使用 Openclaw Skills 在团队或多个 AI agent 之间统一技能创建流程。
避免在初始搭建过程中出现命名、缺少文件、版本不一致、占位符和 Markdown 代码围栏错误。
准备技能，之后交由
yotta-publish-guard
进行发布验证和发布。
不要使用此工具重写现有技能目录、实现业务逻辑或执行最终的多来源发布检查。

工作原理

输入 yotta- 标识符、中文显示名称 元X，以及包含用途、触发条件和边界的描述。
验证技能名称，包括 yotta- 前缀、仅含小写字母/数字/连字符、最长 64 个字符，以及输出目录必须不存在。
验证中文名称格式：必须以 元 开头，且长度为 2–8 个字符。
选择生成模式：默认模式创建完整的发布脚手架，而 --self-use 仅创建技能主体和可选的 CLI 结构。
将内置模板复制到目标目录，不依赖仓库级别的 tools/ 目录。
使用提供的名称、中文名称、描述和摘要替换模板占位符。
使用 --with-cli 添加可选 CLI 文件和测试，使用 --no-banner 省略横幅资源，或使用 --skip-installer 省略安装程序文件。
运行自动结构自检，检查必需文件、frontmatter、版本一致性、双语安装说明、占位符和 Markdown 代码围栏。
成功时返回退出码 0；参数、命名或验证失败时返回 2；致命错误时返回 4；Ctrl+C 中断时返回 130。

配置指南

Yotta Skill Creator 需要 Python 3.8 或更高版本，且仅使用 Python 标准库。它可跨平台运行于 Windows、Linux 和 macOS。
获取技能源代码，并确保生成器位于 scripts/yotta_skill_creator.py。
确认 Python 运行环境：
python3 --version
生成可供发布的完整脚手架：
python3 scripts/yotta_skill_creator.py create yotta-my-tool \ --zh 元工 \ --desc "What it does, when it triggers, and its boundaries" \ --summary "A one-sentence summary" 生成不含发布产物的私有技能主体：
python3 scripts/yotta_skill_creator.py create yotta-private \ --zh 元私 \ --desc "Description of the private skill" \ --self-use 生成可选 CLI 框架和测试，同时省略横幅和安装程序：
python3 scripts/yotta_skill_creator.py create yotta-tool2 \ --zh 元工 \ --desc "What it does, when it triggers, and its boundaries" \ --with-cli \ --no-banner \ --skip-installer 手动编辑生成的 SKILL.md、脚本和测试。使用 yotta-publish-guard 执行最终发布前检查、打包、版本检查和发布。无需安装 pip 软件包。
Yotta Skill Creator（元造） 数据架构与分类体系
输入元数据
字段 要求
技能名称 yotta- 前缀，仅限小写字母/数字/连字符，最多 64 个字符
中文名称 必填的 元X 名称，长度为 2–8 个字符
描述 为 SKILL.md 提供必需的用途、触发条件和边界
摘要 README 文件的可选单行摘要；默认为描述内容
输出目录 使用 --out 指定的可选父目录；工具会创建 //
完整脚手架模式
默认模式会生成：
带有 frontmatter 和技能说明的 SKILL.md。
README.md 和 README.zh-CN.md，包含四种安装方式：npx、Git clone、Download ZIP 和 install.sh。
使用 MIT 许可的 package.json、CHANGELOG.md、LICENSE，以及 NOTICE。
install.sh 和 bin/install.js，除非使用 --skip-installer。
.gitignore、.npmignore 和 .github/workflows/publish.yml。
用于补充文档的 references/，以及用于可选横幅素材的 assets/。
自用模式
使用 --self-use 时，输出会有意限制为技能主体：SKILL.md、references/，以及在选择 --with-cli 时生成的 scripts/ 和测试。不会生成 README 文件、包元数据、变更日志、许可、声明、安装程序、资源和发布工作流。
验证元数据
生成后检查会确认必需文件与所选模式相符；SKILL.md frontmatter 包含 name、description、version 和 license；frontmatter 中的名称与目录名称一致；package.json、SKILL.md 和变更日志中的版本相符；没有遗留占位符；并且 Markdown 代码围栏成对匹配。

高级特性

内置模板随技能包一起分发，因此生成过程不依赖仓库级别的
tools/
目录。
安全且不具破坏性的行为会拒绝在已存在的目标目录中生成内容，且绝不会覆盖文件。 --self-use 将创建技能与准备公开发布包清晰分开。
对于需要命令行行为的技能， --with-cli 会生成可选 CLI 框架和测试。 --no-banner --skip-installer 可精细控制生成的资源和安装文件。
自动生成后验证会在脚手架不完整或不一致时快速失败，并返回退出码
。
版本一致性检查可确保
package.json
、
SKILL.md
CHANGELOG.md
保持同步。
双语 README 会记录四种安装途径，以便更广泛地分发 Openclaw Skills。
渐进式参考文档包含 CLI 参考、脚手架结构指南和中文端到端教程。
该工具旨在融入更大的工作流：使用 Yotta Skill Creator 创建，手动实现逻辑，使用
yotta-publish-guard
验证和打包，然后通过所需渠道发布。

name: yotta-skill-creator slug: yotta-skill-creator version: 0.1.3 displayName: 元造·技能创建助手 summary: 一键生成合规技能目录与全套发布件脚手架，命名校验 + 结构自检，支持自用模式。 description: 元造 —— 从内嵌模板一键生成合规技能目录并做结构自检：命名校验（yotta- 前缀 / 小写连字符 / 元X 规范 / 目标不重复）+ 完整发布件脚手架（SKILL.md / README 中英四方式安装 / package.json / CHANGELOG / LICENSE / NOTICE / install.sh + bin/install.js / .gitignore / .npmignore / publish.yml / references / assets）+ 占位符替换 + 结构自检；--self-use 自用模式只生成技能本体（SKILL.md / references / 可选 CLI），不生成任何发布件。触发：新建一个 yotta- 技能、从零搭技能脚手架、想把发布规范里的坑固化成模板时；或用户说 元造 / 造技能 / 脚手架 / scaffold / 新建技能 等。边界（Do NOT trigger）：不替用户写技能正文与脚本逻辑（SKILL.md 正文 / scripts 需人工开发）；不做发布前校验与三源发布（那是元守 yotta-publish-guard）；不做既有技能目录的批量改造。 tags: [技能创建, 脚手架, 发布件, 模板, skill creator, scaffold] category: dev-programming license: MIT homepage: https://github.com/YottaMeta/yotta-skill-creator metadata: zh_name: 元造 元造（yotta-skill-creator）

端到端造技能脚手架：输入 yotta- + 中文名 + 描述，一键生成符合元阁发布规范的 技能目录，生成后立即做结构自检，通过才输出「脚手架合格」。

create：命名校验 → 内嵌模板 → 占位符替换 → 结构自检，输出完整技能目录。 --self-use 自用模式：只生成技能本体（SKILL.md / references / 可选 CLI），不生成任何发布件—— 造一个自用技能不需要推 GitHub / npm / ClawHub。

零依赖（Python 3.8+ 标准库），Windows + Linux + macOS 通用。

何时使用
要新建一个 yotta- 技能，想从合规骨架起步，不重复踩发布规范里的坑；
需要一个不打算发布的自用技能，只要 SKILL.md + references（可选 CLI）；
想给团队 / 其他智能体统一「造技能」入口，保证命名、结构、发布件一致。

Do NOT trigger：

不替用户写技能正文与脚本逻辑——脚手架只生成骨架与模板，正文 / 算法 / 测试需人工开发；
不做发布前校验与三源发布——那是元守（yotta-publish-guard）的职责；
不做既有技能目录的批量改名 / 迁移——直接编辑目标目录。
快速使用

# 完整发布版脚手架（生成全套发布件）
python3 scripts/yotta_skill_creator.py create yotta-my-tool \

--zh 元工 --desc "做什么 + 何时触发 + 边界" --summary "一句话简介"

# 自用模式：只生成技能本体，不生成任何发布件
python3 scripts/yotta_skill_creator.py create yotta-private \

--zh 元私 --desc "自用技能描述" --self-use

# 同时生成 CLI 骨架 + 测试；跳过 banner / install.sh 可选
python3 scripts/yotta_skill_creator.py create yotta-tool2 \

--zh 元工 --desc "..." --with-cli --no-banner --skip-installer

生成目录后按提示编辑 SKILL.md 正文 / scripts，再交给元守（publish-guard）做发布前检查。

命名校验（不通过即拒绝）
规则 要求 反例
前缀 必须以 yotta- 开头 my-tool
字符 小写字母 / 数字 / 连字符，不以连字符收尾 yotta-Bad / yotta-
长度 ≤ 64 字符 超长名
中文名 元X：以「元」开头，2-8 字符 工具（缺「元」）
目标 输出目录不存在（不覆盖） 已存在的同名目录
生成内容

完整模式（默认）：SKILL.md（四要素 frontmatter）/ README.md + README.zh-CN.md（四方式安装）/ package.json / CHANGELOG.md / LICENSE(MIT) / NOTICE / install.sh + bin/install.js / .gitignore / .npmignore / .github/workflows/publish.yml / references/ / assets/。

自用模式（--self-use）：只生成 SKILL.md / references/（加 --with-cli 时含 scripts/）， 不生成 README 中英 / package / CHANGELOG / LICENSE / NOTICE / install.sh / publish.yml 等发布件。

选项速查（详见 references/cli-reference.md）：

选项 作用 --zh 元X 中文名（必需，元X 规范） --desc "..." SKILL.md 描述：做什么 + 何时触发 + 边界（必需） --summary "..." 一句话简介（README 用；缺省 = desc） --out 输出父目录（缺省 = 当前目录，生成 //） --with-cli 同时生成 CLI 骨架 + 测试（scripts/） --no-banner 跳过 assets/ 素材目录 --skip-installer 不生成 install.sh / bin/install.js（并从 package.json 去掉 bin） --self-use 自用模式：只生成技能本体，不生成发布件 结构自检（生成后自动执行）

生成后立即校验，任何一项不通过返回退出码 2：

必需文件齐全（完整模式含发布件 / 自用模式含技能本体；--with-cli 含 scripts + 测试）；
frontmatter：name 与目录名一致，description / version / license 齐全；
版本对齐：package.json / SKILL.md / CHANGELOG 顶部一致；
README 中英各含「四方式安装」（npx / git clone / Download ZIP / install.sh）；
无残留占位符；Markdown 代码围栏配对。
退出码
退出码 含义 0 成功，脚手架合格 2 参数 / 命名 / 自检不通过 4 致命异常 130 Ctrl+C 中断 行为锚点
只生成、不覆盖：目标目录已存在即拒绝，不覆盖任何文件。
模板内嵌：模板随发布包分发（template/），不依赖仓库 tools/。
生成即自检：create 结束前自动跑结构自检，通过才算完成。
自用模式默认不碰发布件：--self-use 明确「造技能 ≠ 发布」。
与工坊 / 工具链分工
元造（本技能）= 造：生成合规脚手架 + 结构自检；
元守 yotta-publish-guard = 守：发布前聚合校验 / 版本对齐 / 查重 / 打包检查 / 发布命令；
仓库 tools/scaffold-skill.py / tools/validate-skill.py = 内部实现；工坊技能把流程「技能化」 并自包含（发布包内带实现副本），任何智能体装了就能用。
推荐链路：元造 create（脚手架）→ 人工开发正文 / 脚本 / 测试 → 元守 check / pack / versions / names → publish（三源或指定渠道）。
渐进披露
references/cli-reference.md —— 完整参数 / 命名规则 / 退出码 / 自用模式差异
references/scaffold-structure.md —— 生成目录结构与每个文件的用途（完整 / 自用对照）
references/tutorial.md —— 中文教程（新手全流程：造 → 自检 → 交给元守）
元引 · Intent Clarification Assistant (yotta-prompt)
AI 指纹弱化工具