元造（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 <目录> |
输出父目录（缺省 = 当前目录，生成 <out>/<name>/） |
--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 —— 中文教程（新手全流程：造 → 自检 → 交给元守）
