# LeMetaSkill

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

**LeMetaSkill** 是 Leroy 的 Skill 工坊——一个用来创建与迭代 Agent Skill 的 Skill（meta-skill），**ZCode / Claude Code / Codex 通用**。

## 它解决什么问题

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

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

## 仓库结构

```text
skills/le-meta-skill/
├── SKILL.md            # 入口：路由 + 创建/迭代双工作流（两道门、档位、停手点）
├── references/         # 7 篇方法论：意图工坊·先例研究·写作手艺·目录架构·触发测试·迭代工坊·交付报告
├── scripts/            # 3 个确定性工具（纯 python3 标准库）
│   ├── scaffold.py         # 按档位起草"出生即合规"的骨架
│   ├── validate_skill.py   # 结构体检（frontmatter/命名/悬空引用/密钥扫描）
│   └── trigger_eval.py     # 触发冒烟测试（概念族匹配 + 负触发词）
├── evals/              # 本 skill 自身的触发用例（每次真实误触发/漏触发，原话收编进来）
├── assets/             # SKILL.template.md 起草模板
└── reports/            # 运行证据：先例研究、创建/迭代报告、触发测试结果
```

## 安装

三个 runtime 读的都是同一套 SKILL.md 开放格式，脚本只用 python3 标准库：

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

装完直接对助手说：「帮我把这个流程做成一个 skill」。

## 触发方式

- 帮我把每周写周报的流程做成一个 skill
- 我有一套提示词，想沉淀成可复用的技能
- 给我的 skill 做个体检，看看触发灵不灵
- 这个 skill 最近总不触发，帮我改进一下
- turn this checklist into a skill（Claude Code / Codex 同样触发）

## 它和同类有什么不同

| 维度 | 常见 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 只读写明确的 skill 目录，不发布、不推送远程、不执行来历不明的候选脚本；迭代中大幅改变定位、删除重写大段内容、引入高风险逻辑时会停下来等你确认。

## License

[MIT](LICENSE)