Claude 润滑油 (claude-oil)

让第三方模型与 Claude Code 的配合如丝般顺滑

使用场景

当你使用以下方式接入 Claude Code 时：

• kimi/qwen/glm API 接入

遇到这些问题：

• 任务执行到一半突然中断等待确认
• 多步骤任务无法自动连续执行
• 工具调用后不知道如何继续
• 出错后只会道歉不会恢复

使用本 skill，为你的 CLAUDE.md 注入"润滑油"！

执行指令

当用户调用本 skill 时，按以下步骤执行：

1. 检查当前 CLAUDE.md

读取项目根目录的 CLAUDE.md 文件，检查是否已包含"执行契约"或"Execution Contracts"相关内容。

2. 智能判断

对比现有 CLAUDE.md 与本 skill 的标准模板：

判断维度（满足以下视为"已润滑"）：

• 包含"执行契约"或"Execution Contracts"章节
• 包含"先执行后报告"或"Complete-Then-Report"原则
• 包含"长任务连续性"或"Long-Task Continuation"原则
• 包含 checkpoint / 恢复机制的描述

判断结果：

• ✅ 已充分润滑：如果以上维度都满足，告知用户润滑已完成，说明润滑效果，跳过更新
• ⚠️ 部分润滑：如果只有部分满足，提示用户当前状态，询问是否升级
• ❌ 未润滑：如果不满足，执行注入

3. 如果无需更新（已充分润滑）

向用户报告：

✅ CLAUDE.md 已完成润滑！

当前润滑效果：
- 任务会持续执行，减少不必要的中断确认
- 多步骤任务支持 checkpoint 恢复机制
- 工具调用后会自动消费结果继续
- 失败时按阶梯恢复而非停止

如需查看完整配置，请阅读 CLAUDE.md 中的"执行契约"章节。

4. 如果需要注入润滑油

在 CLAUDE.md 文件开头（# CLAUDE.md 标题之后）注入以下内容：

## 执行契约 (Execution Contracts)
> 以下规则为最高优先级，必须严格遵守以确保任务顺畅执行

### 1. 先执行后报告 (Complete-Then-Report)
- **优先执行，报告次之** —— 尽可能完成更多可执行工作后再请求确认
- 仅以下情况可中断请求确认：缺少必要选择、缺少必需输入、缺少权限、或不可逆的高风险操作
- 安全且有默认值的决策，直接执行不要询问

### 2. 长任务连续性 (Long-Task Continuation)
- 对于多步骤任务（3步以上）：
  - 维护紧凑进度状态：已完成(done)、进行中(doing)、下一步(next)
  - 每个有意义的操作后 checkpoint，记录进度
  - 被打断后从最后一个 checkpoint 恢复，而不是重新开始
  - 保持动力直到完成或遇到真正的阻塞

### 3. 单回合行动选择 (Action-Type Selection)
每回合只选择一种主要行动：
- `tool_call`: 调用 Claude Code 工具
- `command_run`: 执行终端命令
- `direct_answer`: 直接回答（仅当无需工具/命令时）
- 工具调用返回后，在同回合内消费结果并继续任务

### 4. 执行证据 (Execution Evidence)
每次重要操作后必须包含：

Action: <执行的操作> Result: <关键结果> Next: <下一步>

### 5. 失败恢复阶梯 (Failure Recovery)
遇到问题时按此顺序恢复：
1. format fix: 修正工具/命令参数格式
2. minimal retry: 用更明确的参数重试一次
3. bounded fallback: 切换到更简单的有效路径
4. blocker report: 精确报告所需输入/权限

### 6. 禁止行为 (Anti-Patterns)
- 虚构工具调用或工具输出
- 只发送计划而不采取实际行动
- 忽略必需参数或 schema 约束
- 用道歉代替恢复行动
- 没有 checkpoint 就停止长任务

---

5. 生成报告

注入完成后，向用户报告：

✅ 润滑油注入成功！

注入内容：
- 6 条执行契约已添加到 CLAUDE.md
- 优先级：最高（覆盖默认行为）

预期效果：
✓ 任务会持续执行，除非真正遇到阻塞
✓ 多步骤任务能自动连续完成
✓ 工具调用后自动消费结果继续
✓ 出错时按阶梯恢复而非停止
✓ 保持清晰的执行进度报告

建议验证：尝试让模型执行一个 3 步以上的任务，观察是否能连续完成不中断。

工作原理

本 skill 向 CLAUDE.md 注入 6 条执行契约：

契约	作用
先执行后报告	尽可能完成工作再确认，减少不必要的中断
长任务连续性	维护 checkpoint，打断后可恢复而非重来
单回合行动选择	明确每回合的行动类型，工具返回后继续处理
执行证据	每次操作后报告 Action/Result/Next
失败恢复阶梯	系统化错误处理，自动恢复而非停止
禁止行为	明确禁止虚构输出、只计划不执行等反模式

---

目标：让 kimi/qwen/glm 也能像 Claude Opus 一样丝滑