元造 yotta-skill-creator

元造（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）做发布前检查。

命名校验（不通过即拒绝）

生成内容

完整模式（默认）：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）：

结构自检（生成后自动执行）

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

• 必需文件齐全（完整模式含发布件 / 自用模式含技能本体；--with-cli 含 scripts + 测试）；
• frontmatter：name 与目录名一致，description / version / license 齐全；
• 版本对齐：package.json / SKILL.md / CHANGELOG 顶部一致；
• README 中英各含「四方式安装」（npx / git clone / Download ZIP / install.sh）；
• 无残留占位符；Markdown 代码围栏配对。

退出码

行为锚点

1. 只生成、不覆盖：目标目录已存在即拒绝，不覆盖任何文件。
2. 模板内嵌：模板随发布包分发（template/），不依赖仓库 tools/。
3. 生成即自检：create 结束前自动跑结构自检，通过才算完成。
4. 自用模式默认不碰发布件：--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 —— 中文教程（新手全流程：造 → 自检 → 交给元守）