Leroy
d3e9bd45bd
- SKILL.md 双工作流（创建/迭代）+ 两道门（验料/通用化）+ 三档位 - 7 篇方法论 references + 3 个纯标准库脚本（scaffold/validate/trigger_eval） - 自身触发用例 16 条 + 先例研究/创建/迭代证据报告 - 方法论吸收自 qiaomu-meta-skill 与 luban-skill，取舍见 reports/prior-art.md
48 lines
3.8 KiB
Markdown
48 lines
3.8 KiB
Markdown
# 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）：本工作区执行沙箱的文件写入跨调用不可靠，基线复制后必须当场验证。
|