MetaSkill/README.md

LeMetaSkill

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

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

它解决什么问题

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

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

仓库结构

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 标准库：

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）： qiaomu-meta-skill · luban-skill · ZCode 内置 skill-creator。

安全边界

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

License

MIT