Files

T

Leroy d3e9bd45bd 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

2026-10-05 12:09:22 +08:00

3.8 KiB

Raw Permalink Blame History

LeMetaSkill 迭代报告 · 2026-10-05（v1.0.0 → v1.1.0）

本轮驱动：用户反馈两条——(1) skill 不应绑死 ZCode，要能在 Claude Code 和 Codex 里用；(2) 用它自己迭代它自己。第 (1) 条即本轮唯一改动面；第 (2) 条决定了流程按迭代工坊走。

本轮只刨：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 处私有路径

验证门（全部满足）

✅ 比基线多过 3 条测试原话（13→16 条计分用例全过，含跨 runtime 新用例）
✅ SKILL.md 127→128 行，writing-craft.md 46→56 行——增长全部用于路径表与可移植规则，可执行性增加
✅ 无私有路径、无密钥、无不可复现依赖（体检 WARN 修复后全绿）
✅ 基线通过项无退化（原有 13 条用例仍全过）
✅ validate_skill.py PASS:10 / WARN:0 / FAIL:0；trigger_eval.py 16/16 一致（报告：trigger-eval.json）

基线：<项目根>/.baseline/le-meta-skill-2026-10-05/（已验证为 v1.0.0 内容，可回滚）。

回炉清单

真实对话实测（连续两轮欠的账）：在 ZCode 新会话测触发；复制/软链到 ~/.claude/skills/ 与 ~/.codex/skills/ 后各自实测一次——跨 runtime 可移植性目前是 [设计优势]，实测后才升 [已验证]。
Codex skills 支持仍是实验性（2025-12 起），路径约定可能变；下次回炉时复核官方文档。
本轮不做：触发判定算法调优、六维评分权重校准、references 进一步拆分——都没有失败证据驱动，不为改而改。
环境教训（已沉淀进 iteration.md）：本工作区执行沙箱的文件写入跨调用不可靠，基线复制后必须当场验证。

3.8 KiB Raw Permalink Blame History Unescape Escape