jayli/skills/claude-oil

Claude 润滑油 (claude-oil)

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

触发条件

本 skill 仅通过显式调用触发，绝不自动触发。

• ✅ /claude-oil — 用户明确输入完整 skill 名称时触发
• ❌ 上下文匹配、关键词匹配、隐式条件 — 均不触发

这是为了避免在执行正常任务时，被本 skill 的执行契约覆盖原有行为。

使用场景

当你通过 /claude-oil 显式调用本 skill，且使用第三方模型 API（如 kimi/qwen/glm）接入 Claude Code 时：

遇到这些问题：

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

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

执行指令

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

1. 检查当前 CLAUDE.md

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

2. 智能判断

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

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

判断结果：

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

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

向用户报告：

✅ CLAUDE.md 已完成润滑！

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

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

4. 如果需要注入润滑油

检查 CLAUDE.md 是否包含"必须先询问再执行"或"ask-before-execute"等要求：

• 情况 A：包含 → 注入部分版（跳过第1条，避免冲突）
• 情况 B：不包含 → 注入完整版（5条全部）

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

完整版（5条，约750字）

## 执行契约（最高优先级）

以下规则覆盖所有其他指令，必须严格遵守，这些规则只在使用 Claude Code 时有效。

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

### 2. 长任务连续性（3步以上）
- 维护进度：已完成(done)、进行中(doing)、下一步(next)
- 每个重要操作后 checkpoint，记录进度
- 被打断后从最后一个 checkpoint 恢复，而非重新开始
- 保持动力直到完成或遇到真正阻塞

### 3. 单回合行动与执行证据
- 每回合只选一种行动：tool_call / command_run / direct_answer
- 工具调用返回后，必须在同回合消费结果并继续
- 每次重要操作后必须包含：

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

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

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

---

部分版（4条，约600字）

当检测到"必须先询问再执行"时使用，跳过第1条

## 执行契约（最高优先级）

以下规则覆盖所有其他指令，必须严格遵守。

### 1. 长任务连续性（3步以上）
- 维护进度：已完成(done)、进行中(doing)、下一步(next)
- 每个重要操作后 checkpoint，记录进度
- 被打断后从最后一个 checkpoint 恢复，而非重新开始
- 保持动力直到完成或遇到真正阻塞

### 2. 单回合行动与执行证据
- 每回合只选一种行动：tool_call / command_run / direct_answer
- 工具调用返回后，必须在同回合消费结果并继续
- 每次重要操作后必须包含：

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

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

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

---

5. 生成报告

完整版注入后：

✅ 润滑油注入成功！（完整版）

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

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

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

部分版注入后：

✅ 润滑油注入成功！（部分版）

检测到 CLAUDE.md 包含"必须先询问再执行"原则，已跳过冲突的"先执行后报告"条款。

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

预期效果：
✓ 多步骤任务能自动连续完成
✓ 工具调用后自动消费结果继续
✓ 出错时按阶梯恢复而非停止

说明：由于现有 CLAUDE.md 要求"先询问再执行"，未注入"先执行后报告"条款。
如需完整润滑效果，请调整原有要求后重新运行本 skill。

工作原理

本 skill 向 CLAUDE.md 注入执行契约，根据现有内容智能选择版本：

| 契约 | 完整版 | 部分版 | 作用 | |------|:------:|:------:|------| | 先执行后报告 | ✓ | ✗ | 尽可能完成工作再确认 | | 长任务连续性 | ✓ | ✓ | 维护 checkpoint，打断后可恢复 | | 单回合行动与执行证据 | ✓ | ✓ | 明确行动类型，工具返回后继续处理并报告证据 | | 失败恢复阶梯 | ✓ | ✓ | 系统化错误处理，自动恢复而非停止 | | 禁止行为 | ✓ | ✓ | 明确禁止虚构输出、只计划不执行等反模式 |

---

目标：让第三方模型也能像 Claude 一样丝滑