Skill 优化器

> 「Skill 是其构建者意志的延伸。」

核心理念

本 Skill 不是凭空「创造」优化方案——所有建议都锚定自 18 种进阶工程技巧。

每条建议有明确出处：指出缺失哪项技巧 → 说明为什么需要 → 给出具体改法。

关键原则：宁可少改，绝不瞎改。每一条改动都让用户确认后再应用。

Workflow

Step -1：自更新检查（技巧六）

> 此步骤在每次调用时首先执行，完成后再进入 Step 0，不得跳过（超时或失败时除外）。

执行步骤：

1. 使用 Shell 工具运行更新命令（block_until_ms 设为 30000）：

```bash

openclaw skills update eagle-skill-optimizer 2>&1

```

1. 根据命令输出判断结果：

| 输出特征 | 处理方式 |

|---------|---------|

| 包含「up to date」「already」「no update」等 | 输出 ✅ skill-optimizer 已是最新版本（v[本文件 frontmatter 中的 version 字段]） → 进入 Step 0 |

| 包含「updated」「installed」「downloaded」等 | 输出 🔄 已更新到新版本！重新读取 SKILL.md... → 用 Read 工具重新读取本文件 → 从 Step 0 开始执行 |

| 包含「not found」「not tracked」「unknown」等 | 输出 ⚠️ 该 Skill 未通过 openclaw 安装，跳过版本检查 → 进入 Step 0 |

| 命令不存在（command not found） | 输出 ⚠️ openclaw CLI 不可用，跳过版本检查 → 进入 Step 0 |

| 其他错误 | 输出 ⚠️ 版本检查失败，继续使用当前版本 → 进入 Step 0 |

1. 超时处理（命令超过 30 秒未完成）：

输出以下提示，等待用户决策：

```

⏳ 更新检查超时（>30秒）

选项：

• 回复「等待」→ 再等待 30 秒
• 回复「跳过」→ 忽略更新，使用当前版本继续

```

• 收到「等待」→ 再次等待，重复最多 2 次
• 收到「跳过」→ 直接进入 Step 0

原则：版本检查失败或超时均不阻断主流程，直接进入 Step 0 继续执行。

Step 0：目标确认 + 问题采集

前置信息收集（技巧五）：一次性收集，禁止分多轮询问。

1. 确认目标 Skill
• 用户已指定 → 读取该 SKILL.md 全文
• 用户未指定 → 询问「请告诉我你想优化哪个 Skill？给出路径或名称。」
• 如用户不确定，执行 find . -name SKILL.md 列出可用 Skill

1. 采集用户问题
• 用户已描述问题 → 记录并进入 Step 1
• 用户未描述 → 询问「这个 Skill 在使用过程中出现了什么问题？（触发不稳定/步骤被跳过/结构每次不一样/大文件时遗忘/中途报错... 或说「全面体检」）」

Step 1：18 维度诊断

前置：先判断 Skill 类型，再开始逐条评估。禁止未判断类型就开始输出体检结果。

类型确认后，对上述已标记为 — 不适用的技巧，在评估时直接填 —，不得标记为 ❌ 缺失。

读取目标 SKILL.md 全文，逐条对照 18 种进阶工程技巧 评估：

18 条体检清单

【流程稳定性组 — 技巧一～七】

【过程稳定性 / 数据可信度 / 用户体验组 — 技巧八～十五】

【调查员模式组 — 技巧十六～十八】

诊断进度输出规则（技巧十五）

逐组评估时，在每组结束后输出一行进度提示，让用户知道进展：

• 完成流程稳定性组（技巧 1–7）后：输出 📊 流程稳定性组（7/18）评估完成
• 完成过程稳定性组（技巧 8–15）后：输出 📊 过程稳定性组（15/18）评估完成
• 完成调查员模式组（技巧 16–18）后：输出 📊 全部 18 条评估完成，正在生成报告...

结合用户问题的重点检查

Step 2：输出体检报告 + 优化建议（按优先级排序）

诊断完成后，首先检查结果：

如果 ❌ 缺失 = 0 且 ⚠️ 部分覆盖 = 0：

输出以下内容并结束流程（不进入 Step 3~6）：

✅ 该 Skill 质量良好！
18 条技巧均已覆盖或不适用，无需优化。
[列出所有 ✅ 已覆盖的技巧]

否则，输出结构化报告：

📋 Skill 体检报告：[Skill 名称]

📊 总览：✅ 已覆盖 N 项 | ⚠️ 部分覆盖 N 项 | ❌ 缺失 N 项 | — 不适用 N 项

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔴 高优先级（强烈建议修复）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[1] ❌ 技巧二：步骤锁定 — 无编号步骤，LLM 可能跳步
    风险：[结合用户问题说明具体风险]
    建议改法：
    - 将所有操作改为 Step 0/1/2... 编号
    - 每步添加「必须在步骤 X 完成后才进入 Y」约束
    - 添加「禁止跳过本步骤」声明

[2] ❌ 技巧十三：输出模板锁定 — 无固定输出模板
    风险：每次生成的报告结构不一致
    建议改法：
    - 在 Skill 末尾添加固定输出模板（含占位符）
    - 明确要求「严格按此结构生成」

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🟡 中优先级（建议优化）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[3] ⚠️ 技巧七：优先环境自检 — 有检查但不区分核心/可选
    ...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🟢 低优先级（可选改进）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 已做得好的方面
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- ✅ 技巧五：前置信息收集 — 已一次性列出所有信息

优先级判定规则：

• 🔴 高：用户明确反馈的问题对应的缺失项，或技巧 2/7/12/13（流程稳定性和数据可信度核心）
• 🟡 中：非核心但影响稳定性和体验的缺失项
• 🟢 低：锦上添花项

输出后询问用户：

> 以上共 N 条可改进建议。请告诉我你想修复哪些：

> - 回复编号（如「1,2,3」）→ 修复指定项

> - 回复「全部重要」→ 修复所有 🔴 和 🟡 项

> - 回复「全部」→ 修复所有建议（含 🟢 低优先级）

> - 回复「跳过」→ 不做修改

Step 3：备份原始 Skill

用户确认要修改后，在修改前立即执行备份：

使用 Shell 工具执行以下命令，将 $TARGET_PATH 替换为 Step 0 中确认的 Skill 文件绝对路径。

# 将 $TARGET_PATH 替换为实际绝对路径，例如：/Users/me/.claude/skills/foo/SKILL.md
TARGET_PATH="/path/to/SKILL.md"
BACKUP_DIR="$(dirname "$TARGET_PATH")/.backups"
mkdir -p "$BACKUP_DIR"
BACKUP_PATH="$BACKUP_DIR/SKILL.md.backup.$(date +%Y%m%d_%H%M%S)"
cp "$TARGET_PATH" "$BACKUP_PATH"
echo "✅ 备份路径：$BACKUP_PATH"

告知用户：

✅ 原 Skill 已备份
备份路径：[绝对路径]
如需回滚：cp [备份路径] [原始路径]

安全约束：

• 备份必须保留原文件内容
• 备份路径必须在机器本地可访问
• 备份目录建在 Skill 同级目录下

⚠️ 反例示例（技巧十四）—— 常见误判，执行前必读

误判一：把"不适用"错标为 ❌ 缺失

❌ Bad：对一个「只读文档查询」类 Skill 输出：
  [1] ❌ 技巧十七：草稿确认门 — 缺少草稿确认流程（🔴 高优先级）

✅ Good：先判断 Skill 类型，只读查询类不适用技巧八/十七/十八：
  [技巧十七] — 不适用（只读查询类 Skill，无写入操作）

误判二：改动幅度失控，超出用户选择范围

❌ Bad：用户只选了「修复技巧二（步骤锁定）」，LLM 却顺手重写整个 Workflow 章节，
        改变了原有措辞、顺序和格式。

✅ Good：只在原有章节中插入「Step 0 / Step 1 / ...」编号和「禁止跳过」约束句，
        其余内容保持原文不动。

Step 4：生成修改草稿（草稿确认门 · 技巧十七）

根据用户选择的优化项，逐一生成拟修改内容。

> ⚠️ 禁止在此步骤写入任何文件。 本步骤仅在对话中展示草稿内容，所有文件写入必须等到 Step 5 用户确认后才执行。

修改规则

1. 每个技巧的改动保持独立段落，不将多项技巧的改动合并成一个大块写入；如用户选了多项，草稿中每一项单独展示
2. 每项草稿后记录变更摘要（修改位置 + 修改内容 + 修改理由）
3. 保持 Skill 原有风格，只做增量修改

各技巧标准改法速查

Step 5：变更确认

所有修改完成后，展示变更摘要：

📝 变更摘要

共修改 N 处：

[1] 技巧二：步骤锁定
    位置：Workflow 章节
    变更：将流程改为 Step 0~4 编号结构，添加强制约束

[2] 技巧十三：输出模板锁定
    位置：文件末尾（新增章节）
    变更：添加固定输出模板（5个占位符区块）

[3] 技巧七：优先环境自检
    位置：Step 0 新增
    变更：添加环境检查，区分核心/可选依赖

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
请确认：
- 回复「确认」→ 保存修改
- 回复「修改第 N 处」→ 重新调整该处
- 回复「取消」→ 从备份恢复

只有收到用户「确认」后，才执行文件写入——将 Step 4 中生成的所有草稿内容一次性写入原文件。

如果用户取消：从备份恢复原始 SKILL.md，告知用户已恢复（备份仍保留）。

Step 6：完成回执（执行回执 · 技巧十八）

修改确认保存后，输出完成回执：

✅ Skill 优化完成

📁 文件信息：
   原文件：[绝对路径]
   备份：  [绝对路径]

📦 已应用的优化（N 项）：
   1. [技巧二] 步骤锁定
   2. [技巧十三] 输出模板锁定
   3. [技巧七] 优先环境自检

🧪 建议验证：
   用你常用的触发方式重新运行该 Skill，检查：
   - [对应每个优化项的验证要点]

🔄 如需回滚：
   cp [备份路径] [原始路径]

设计原则

证据驱动（技巧十二）

每条优化建议必须锚定到具体的 18 种技巧之一，不允许凭空捏造「建议」。

不适用范围声明

某些技巧对特定类型 Skill 不适用：

• 只读查询类（如文档问答）：不适用技巧八、十七、十八
• 无外部依赖：不适用技巧七、十
• 短流程（<5步）：不适用技巧十五

改动最小化

只修用户选中的项，不碰其他地方。

备份优先

任何修改前必须先备份，这是不可跳过的安全步骤。