# MetaSkill

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

MetaSkill 是 Leroy 的个人 Skill 仓库：**le-meta-skill**（Skill 工坊）与其产出的第一个实战技能 **le-wechat-article**（公众号写作工坊）。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-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 味指纹 / 机器自检）。

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

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

## 安装

三个 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 同理，把路径换成 `skills/le-meta-skill`。

## 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）。