LeMetaSkill v1.1.0:跨 runtime(ZCode/Claude Code/Codex)的 Agent Skill 创建与迭代工坊

- SKILL.md 双工作流(创建/迭代)+ 两道门(验料/通用化)+ 三档位
- 7 篇方法论 references + 3 个纯标准库脚本(scaffold/validate/trigger_eval)
- 自身触发用例 16 条 + 先例研究/创建/迭代证据报告
- 方法论吸收自 qiaomu-meta-skill 与 luban-skill,取舍见 reports/prior-art.md
This commit is contained in:
Leroy
2026-10-05 12:09:22 +08:00
commit d3e9bd45bd
21 changed files with 1827 additions and 0 deletions
@@ -0,0 +1,47 @@
# LeMetaSkill 迭代报告 · 2026-10-05(v1.0.0 → v1.1.0)
本轮驱动:用户反馈两条——(1) skill 不应绑死 ZCode,要能在 Claude Code 和 Codex 里用;(2) 用它自己迭代它自己。第 (1) 条即本轮唯一改动面;第 (2) 条决定了流程按 [迭代工坊](../references/iteration.md) 走。
## 本轮只刨:runtime 中性化
改动边界:只改与 runtime 定位相关的措辞与约定,不动工作流结构、不动脚本算法、不动其余 references。
### 建议文件变更(实际执行)
| 文件 | 操作 | 内容 |
|---|---|---|
| SKILL.md | 修改 | description:"创建与迭代 ZCode 技能"→"创建与迭代 Agent Skill,ZCode / Claude Code / Codex 等 runtime 通用";负触发去掉 zcode-guide 专属指向;总则"内置 skill-creator"→"宿主内置";metadata 增 `runtimes` 字段,版本 1.0.0→1.1.0 |
| references/writing-craft.md | 修改 | "ZCode 专属约定"整节重写为"跨 runtime 约定":三 runtime 发现路径表、`.agents/skills/` 默认位 + 复制/软链策略、可移植三禁(不写死 runtime 专属工具名/无私有路径/脚本仅标准库) |
| references/prior-art.md | 修改 | 本机已装 skill 的查找渠道补 `~/.claude/skills/`、`~/.codex/skills/` |
| references/handoff.md | 修改 | 取舍示例去掉 ZCode 绑定措辞 |
| evals/trigger_cases.json | 修改 | 新增 3 条用例:应触发 ×2("做成 Claude Code 的 skill"、"create a Codex skill"),不应触发 ×1("Claude Code 怎么安装插件"——配置求助不是 skill 创作) |
| reports/creation-handoff.md | 修改 | 私有绝对路径改项目相对路径(体检 WARN 抓出的疏漏) |
| references/iteration.md | 修改 | 沉淀本轮教训:基线放发现路径之外、复制后立即验证(独立第二改动,按单面单提交纪律与本面分开) |
### 六维评分(迭代前 → 迭代后,预估)
| 维度 | 权重 | 前 | 后 | 证据 |
|---|---:|---:|---:|---|
| 触发与边界 | 25 | 7 | 9 | 活体尺:用户反馈暴露定位缺陷(description 写死 ZCode);修后跨 runtime 用例 4/4 通过 |
| 可执行具体性 | 20 | 8 | 8 | 未动(本轮不改流程);跨 runtime 路径表给了明确操作 |
| 工作流清晰度 | 15 | 8 | 8 | 未动 |
| 失败模式与停手点 | 15 | 7 | 7 | 未动;"可移植三禁"补了一种失败模式 |
| 实测表现 | 15 | 6 | 7 | 冒烟 16/16;真实对话实测仍缺失(见边界) |
| 资源纪律 | 10 | 9 | 9 | 体检全绿;抓出并修复 1 处私有路径 |
## 验证门(全部满足)
1. ✅ 比基线多过 3 条测试原话(13→16 条计分用例全过,含跨 runtime 新用例)
2. ✅ SKILL.md 127→128 行,writing-craft.md 46→56 行——增长全部用于路径表与可移植规则,可执行性增加
3. ✅ 无私有路径、无密钥、无不可复现依赖(体检 WARN 修复后全绿)
4. ✅ 基线通过项无退化(原有 13 条用例仍全过)
5. ✅ `validate_skill.py` PASS:10 / WARN:0 / FAIL:0;`trigger_eval.py` 16/16 一致(报告:[trigger-eval.json](trigger-eval.json))
基线:`<项目根>/.baseline/le-meta-skill-2026-10-05/`(已验证为 v1.0.0 内容,可回滚)。
## 回炉清单
1. **真实对话实测**(连续两轮欠的账):在 ZCode 新会话测触发;复制/软链到 `~/.claude/skills/` 与 `~/.codex/skills/` 后各自实测一次——跨 runtime 可移植性目前是 [设计优势],实测后才升 [已验证]。
2. Codex skills 支持仍是实验性(2025-12 起),路径约定可能变;下次回炉时复核官方文档。
3. 本轮不做:触发判定算法调优、六维评分权重校准、references 进一步拆分——都没有失败证据驱动,不为改而改。
4. 环境教训(已沉淀进 iteration.md):本工作区执行沙箱的文件写入跨调用不可靠,基线复制后必须当场验证。