# MetaSkill

> *「把重复出现的方法，变成可触发、可验证、可维护的 Skill。」*

MetaSkill 是 Leroy 的个人 Skill 仓库：**le-meta-skill**（Skill 工坊）与其实战技能 **le-wechat-article**（公众号写作工坊）、**le-gpt-image**（无 Key GPT Image 生图工坊）、**le-app-design**（统一 App 设计工坊）。ZCode / Claude Code / Codex 通用。

## 仓库结构

```text
skills/
├── le-meta-skill/         # Skill 工坊（meta-skill）
│   ├── SKILL.md           # 入口：路由 + 创建/迭代双工作流（两道门、档位、停手点）
│   ├── references/        # 7 篇方法论：意图工坊·先例研究·写作手艺·目录架构·触发测试·迭代工坊·交付报告
│   ├── scripts/           # scaffold / validate_skill / trigger_eval（纯 python3 标准库）
│   ├── evals/  assets/  reports/
│   └── ...
├── le-wechat-article/     # 公众号写作工坊
│   ├── SKILL.md           # 9 步工作流：类型路由→校准→大纲图位→初稿→分层审读→自检→出图→交付→同步草稿箱
│   ├── references/        # 6 篇：五类型路由·排版规则·审读手册（含合规）·视觉生产·作者画像·常用事实卡
│   ├── scripts/           # check_article（硬规则自检）/ md2wechat（3 骨架×4 色板转微信 HTML）/ publish_draft（草稿箱同步，零依赖）
│   └── evals/  reports/
├── le-gpt-image/          # 无 Key GPT Image 生图工坊
│   ├── SKILL.md           # 工作流：接单→停点确认→生成交付；能力边界 / 尺寸质量速查 / 故障排查
│   ├── references/        # prompt-craft：结构公式·文字渲染·摄影/插画/信息图·中文东方风格·改图指令·反模式
│   └── scripts/           # gpt_image.py（零依赖：Codex 凭证直连内部图像通道，token 自动刷新）
└── le-app-design/         # 统一 App 设计工坊（编排器）
    ├── SKILL.md           # S0–S7 流水线：依赖门→产品理解→规范→视觉→构建→审查→迭代→验收；六铁律 + 岗位裁决表
    ├── references/        # pipeline（七阶段细则）· runtimes（四 runtime 适配矩阵）
    ├── scripts/           # check_deps（硬依赖门）/ log_call（调用证据账本）/ evidence_report（验收门），纯标准库
    └── evals/  reports/   # 触发用例 + 集成测试证据（calls.jsonl / 截图 / 审查报告）
```

## le-meta-skill —— Skill 工坊

一个用来创建与迭代 Agent Skill 的 Skill。

事情是这样的：你总有那么几类反复出现的工作——写周报的流程、审查文档的清单、一套越用越顺手的提示词。每次都现场给助手讲一遍，讲多了就成了重复劳动。LeMetaSkill 把这类方法变成真正的 Skill 资产：description 精准触发、正文可照做、改动有验证门把关。

它不只是帮你写一个 SKILL.md。工坊有两道门（这块料值不值得做成 skill？单次教训够不够格变成规则？）、两个工作流（创建 / 迭代）、三把尺（结构、触发、活体），交付时每个亮点都标注证据等级——验证不了的写「证据缺失」，不写漂亮话。

触发方式：

- 帮我把每周写周报的流程做成一个 skill
- 我有一套提示词，想沉淀成可复用的技能
- 给我的 skill 做个体检，看看触发灵不灵
- 这个 skill 最近总不触发，帮我改进一下

| 维度 | 常见 meta-skill | LeMetaSkill |
|---|---|---|
| runtime | 多绑死单一生态（如 Claude Code） | ZCode / Claude Code / Codex 通用，可移植三禁 |
| 验证 | 写完即交付 | 三把尺 + 验证门，过不了就回刀 |
| 证据 | 宣称式描述 | [设计优势]/[已验证]/[假设] 三级标注，缺证据如实写 |
| 迭代 | 无纪律 | 冻结基线 + 单面慢刨 + 回炉清单 |

方法论来源（只借机制，不复制表达，完整取舍见 [reports/prior-art.md](skills/le-meta-skill/reports/prior-art.md)）：
[qiaomu-meta-skill](https://github.com/joeseesun/qiaomu-meta-skill) ·
[luban-skill](https://github.com/LearnPrompt/luban-skill) · ZCode 内置 skill-creator。

安全边界：只读写明确的 skill 目录，不发布、不推送远程、不执行来历不明的候选脚本；迭代中大幅改变定位、删除重写大段内容、引入高风险逻辑时会停下来等你确认。

## le-wechat-article —— 公众号写作工坊

把一个主题、一堆素材（链接、笔记、聊天记录、代码变更）或一篇旧稿，变成可发布的微信公众号文章。

- **类型路由**：按「文章回答的核心问题」路由到简报 / 测评 / 复盘 / 技术解析 / 叙事五类型之一，各类型有自己的开头、节奏与审读重点——不把所有文章写成一种腔调
- **分层审读**：subagent 独立执行内容审读（去模板化 + 15 条 AI 味指纹带防误判阈值）与事实核查 + 平台合规（命中必改），长文加终审（对照初稿基线做语义保真 diff）；真实性是底线，素材不足就停下来要料，不编造
- **机器自检**：标题层级、表格、加粗落点密度、金句数、中英文间距等硬规则由脚本核验，不靠眼睛
- **排版与配图**：Markdown → 微信可粘贴 HTML（工程 / 杂志 / 简报三骨架 × 四色板）；封面与信息图默认生成（几何类信息图走 SVG 自绘 + 浏览器截图，文字逐字取自文章）
- **草稿箱同步**：经官方 API 写入公众号草稿箱并自动提交双封面裁剪框——**止于草稿，群发与发表永远手动**

触发方式：「写篇公众号文章」「把这份素材整理成推文」「同步到公众号草稿箱」。

方法论来源（只借机制，不复制表达）：[mp-article-writor](https://github.com/balabalabalading/huuuuuuho-skills/tree/main/skills/mp-article-writor)（MIT，类型路由 / 去模板化 / 语义保真）· [wechat-article-skills](https://github.com/aiworkskills/wechat-article-skills)（Apache-2.0，产出配额 / AI 味指纹 / 机器自检）· [human-writing](https://github.com/KKKKhazix/human-writing)（MIT，活人感写法 / 说话位置 / 模型腔硬禁与 check_prose 检查器）。

排版主题库直接引入：[gzh-design-skill](https://github.com/isjiamu/gzh-design-skill)（AGPL-3.0）的 6 套主题组件库、平台合规校验器与预览页脚本，存放于 `skills/le-wechat-article/references/themes/` 并适用其原协议（边界与修改声明见该目录 README）。

安全边界：不群发不发表、不做跨平台、微信凭证只走环境变量不进仓库。

## le-gpt-image —— 无 Key 的 GPT Image 生图工坊

用 GPT Image 生成与编辑图片（海报、封面、插画、信息图配图、风格迁移改图），**不需要 OpenAI API Key**：凭证复用本机 Codex CLI 的 ChatGPT 登录（`~/.codex/auth.json`），token 临过期自动刷新，直连 Codex 内部图像通道——消耗 ChatGPT 订阅额度，走订阅不走 API 计费。

- **零依赖 CLI**：`gpt_image.py` 纯 python3 标准库；`generate`（文生图）/ `edit`（1–5 张参考图、`--style-image` 风格迁移）/ `check`（凭证体检）；429 自动退避、401 自动刷新、原子落盘防覆盖
- **Gallery 优先的提示词引擎**：完整引入 GPT-Image2-Skill 的 163 条精调 prompt（31 类，MIT，`references/gallery/`）——接单先查库选最接近案例做底、替换主体与文案，不从零现写；对照实测同一海报主题，Gallery 框架比即兴 prompt 的质感与排版层级高一档
- **额度纪律**：每张图都在花订阅用量——改写用户描述、多张或 4k、编辑不可再生原图前先停点确认（回合终止契约），失败即停不偷跑重试

触发方式：「画一张…的图」「做张海报/封面」「帮文章配图」「把这张图的背景换成…」「按这张图的风格重画」。

方法论与协议来源：[GPT-Image2-Skill](https://github.com/wuyoscar/GPT-Image2-Skill)（MIT——Reference Gallery 与官方提示词指南完整引入 `references/gallery/`，附 NOTICE 与原版 LICENSE，仅删预览图外链）· [codex-imagegen-cli](https://github.com/jdmnk/codex-imagegen-cli)（Apache-2.0，凭证读取/刷新/锁与端点协议的独立实现参考）。

安全边界：凭证只读不打印不外发；内部接口无稳定性契约（native 失效可切 responses 备用通道）；内容政策拒绝即停，不换措辞绕过。

## le-app-design —— 统一 App 设计工坊

一个入口（「帮我设计这个 App」）跑完产品理解 → 设计规范 → 视觉探索 → Web 高保真原型 → 设计审查 → 优化迭代 → 交付。它不是借鉴了三个开源 Skill 的新 Skill，而是**真正集成并调用**三个上游的编排器：

- **ui-ux-pro-max**（MIT）：`search.py` CLI 真跑 `--design-system --persist` 生成 MASTER.md，UX/可访问性/触控规范走数据检索——设计规范的硬约束来源
- **frontend-design**（Apache-2.0, Anthropic）：经宿主 Skill 工具装载（或 Read 原文全文，一等路径）——视觉方向与品牌差异化的 design lead
- **impeccable**（Apache-2.0, pbakaus）：`impeccable` CLI（context / detect 62 规则 / critique-storage）+ playbook 装载照做——审查、精修与质量底线
- **三个机制保证「真集成」可验证**：`check_deps.py` 硬依赖门（缺任何一个即终止并报安装指引）、`log_call.py` 证据账本（每次调用落 calls.jsonl，含装载文件的 sha256）、`evidence_report.py` 验收门（三方各有 ≥1 条成功调用才许宣称完成）。已跑通完整 E2E（习惯打卡 App 双屏原型）：三上游真实调用 7 条留账、双独立 sub-agent 评审 26/36、修复 3×P1 后复测清零——证据见 [reports/](skills/le-app-design/reports/integration-test-2026-11-07.md)

触发方式：「帮我设计一个 App」「做一个高保真原型」「把首页和详情页这些界面设计出来」。点名单个上游（「用 impeccable 审查」）不触发，直连对应 Skill。

依赖安装：三个上游需装到 `~/.agents/skills/`（Codex 侧另链 `~/.codex/skills/`），详见 [skills/le-app-design/README.md](skills/le-app-design/README.md)。不 vendoring、不修改上游（归属见其 NOTICE）。

安全边界：上游目录只读；停点 1（设计方向）与停点 2（修复范围）为回合终止点，「一口气跑完」仅豁免停点、不豁免铁律与验收门。

## 安装

三个 runtime 读的都是同一套 SKILL.md 开放格式，脚本只用 python3 标准库。把要装的 skill 软链到对应位置即可：

```bash
git clone <本仓库> && cd MetaSkill
# ZCode（项目级，以 le-wechat-article 为例）
mkdir -p .agents/skills && ln -s <克隆路径>/skills/le-wechat-article .agents/skills/le-wechat-article
# Claude Code（用户级）
mkdir -p ~/.claude/skills && ln -s <克隆路径>/skills/le-wechat-article ~/.claude/skills/le-wechat-article
# Codex（实验性）
mkdir -p ~/.codex/skills && ln -s <克隆路径>/skills/le-wechat-article ~/.codex/skills/le-wechat-article
```

装 le-meta-skill、le-gpt-image 同理，把路径换成对应 skill 目录。装 le-app-design 还需先装三个上游依赖（ui-ux-pro-max / frontend-design / impeccable），并用其 `scripts/check_deps.py` 验证三方全绿。

## License

[MIT](LICENSE)，唯一例外：`skills/le-wechat-article/references/themes/` 目录及自 gzh-design-skill 引入的三个脚本（`validate_gzh_html.py` / `wrap_preview.py` / `component_lint.py`）与 `assets/preview-template.html` 适用 **AGPL-3.0**（原文见该目录 LICENSE）。