Install
openclaw skills install @wangjiaocheng/skill-refactor技能改造方法。核心能力:评估技能是否需要存在(领域消除评估)→ 如果需要存在则重构技能内容(工作流重构)。十一步法:边界识别→存在理由分析→消除可行性评估→独立存在必要性判断→决策输出→组成部分识别→组成部分存在理由分析→补偿层消除→重整→重构验证→改造形态选择。覆盖从技能领域评估、存在必要性判断、技能内容重构到改造验证的全流程。通用方法,不绑定任何特定技能。触发词:技能改造、技能重构、技能优化、skill refactor、技能整理、技能清理、技能评估。
openclaw skills install @wangjiaocheng/skill-refactor技能存在的根本问题:不是"这个技能能不能优化",而是"这个技能需不需要存在"。
传统思维是"技能存在→优化技能",但更根本的问题是:这个技能是否本就不该存在?如果技能覆盖的领域是人的局限产物(历史遗留、重复功能、过时需求),那么消除技能比重构技能更彻底。
改造十一步法:
适用范围:任何已存在的技能——用户技能、项目技能、市场技能等。
单独存在合理性:
| 阶段 | 步骤 | 操作 | 要点 |
|---|---|---|---|
| 领域消除评估 | 1. 边界识别 | 识别技能覆盖的领域边界 | 明确技能包含什么、不包含什么 |
| 2. 存在理由分析 | 追问技能存在的根本原因 | 事情本身需要 / 人的局限需要 / 历史遗留 | |
| 3. 消除可行性评估 | 评估技能是否可以完全消除 | 被其他技能吸收 / 功能分散 / 直接废弃 | |
| 4. 独立存在必要性判断 | 判断技能是否值得独立存在 | 边界清晰度 / 功能内聚性 / 消除成本 | |
| 5. 决策输出 | 给出明确的消除/重构/保留建议 | 消除/重构/保留三选一 | |
| 内容重构 | 6. 组成部分识别 | 识别技能的每个组成部分 | 章节、范本、规则等 |
| 7. 组成部分存在理由分析 | 逐部分追问存在理由 | 标记为核心/校准/传递/协调/校验/格式 | |
| 8. 补偿层消除 | 去掉不必要的组成部分 | 去掉传递/协调/格式,保留核心+校准 | |
| 9. 重整 | 基于需求重编技能内容 | 保留部分→重新编排为完整SKILL.md | |
| 10. 重构验证 | 10项验证清单 | 全部通过才算完成 | |
| 11. 改造形态选择 | 选择最终形态 | 消除/重构/保留 |
| 类型 | 标记 | 说明 | 处理建议 |
|---|---|---|---|
| 事情本身需要 | ✅必要 | 技能覆盖的领域有清晰的边界和内聚性 | 保留→重构技能内容 |
| 人的局限需要 | ❌可消除 | 技能覆盖的领域是因为人的认知局限、历史遗留 | 消除→删除技能 |
| 历史遗留 | ⚠️待评估 | 技能覆盖的领域是因为历史原因,当前必要性存疑 | 评估后决定 |
| 外部约束 | 🔒不可消除 | 技能覆盖的领域是因为法规、标准、合同等外部约束 | 保留→重构技能内容 |
| 类型 | 标记 | 说明 | 处理建议 |
|---|---|---|---|
| 核心环节 | ✅核心 | 事情本身的逻辑步骤 | 保留 |
| 校准环节 | 🔶校准 | 过程中纠偏的中间产出物 | 保留为基元内分步校准点 |
| 传递环节 | ❌传递 | 人之间传递信息的中间步骤 | 消除 |
| 协调环节 | ❌协调 | 管理多人协作的步骤 | 消除 |
| 校验环节 | ⚡校验 | 防止出错的审核步骤 | 精简为关键节点 |
| 格式环节 | ❌格式 | 满足组织流程的形式要求 | 消除 |
满足任一即建议消除技能:
| 条件 | 阈值 | 示例 |
|---|---|---|
| 功能重叠度 | 技能功能≥50%与其他技能重叠 | "文档转换"与"格式处理"高度重叠 |
| 领域过时度 | 技能覆盖的领域已不再需要 | "传真发送"技能在现代办公中已过时 |
| 使用频率 | 技能近6个月使用次数<3 | 长期未使用的技能可能已无价值 |
| 维护成本 | 技能维护成本>收益 | 技能依赖的API已废弃,维护困难 |
| 形态 | 适用场景 | 执行方式 |
|---|---|---|
| 消除 | 技能领域不再需要、功能重叠、历史遗留 | 删除技能,功能合并到其他技能 |
| 重构 | 技能领域需要存在,但内容需要优化 | 重构技能结构、内容、范本 |
| 保留 | 技能已足够优化,无需改动 | 维持现状 |
选择原则:能消除的不重构,能重构的不保留。消除是最彻底的优化。
改造完成后必须逐项验证,十项全部通过才算改造完成:
| # | 验证项 | 说明 |
|---|---|---|
| 1 | ⬜ 领域评估准确 | 是否准确评估了技能领域的存在必要性 |
| 2 | ⬜ 消除可行性评估合理 | 是否合理评估了消除的可行性 |
| 3 | ⬜ 重构内容完整 | 如果重构,是否覆盖了技能的全部核心内容 |
| 4 | ⬜ 结构一致性 | 技能结构是否合理完整 |
| 5 | ⬜ 改造建议明确 | 是否给出了明确的消除/重构/保留建议 |
| 6 | ⬜ 领域清晰度 | 技能覆盖的领域边界是否清晰 |
| 7 | ⬜ 内容完整性 | 技能是否覆盖了领域的全部核心内容 |
| 8 | ⬜ 结构规范性 | 技能结构是否合理(YAML frontmatter 建议保留 name/author/description,章节结构可灵活调整) |
| 9 | ⬜ 可执行性 | 技能是否可直接使用,范本是否完整 |
| 10 | ⬜ 独立性 | 技能是否独立,不依赖其他技能 |
阶段一:领域消除评估
| ID | 任务类型 | 说明 | 依赖 | 能力需求 |
|---|---|---|---|---|
| S0-01 | 边界识别 | 识别技能覆盖的领域边界:包含什么、不包含什么、与其他技能的交集 | 无(入口) | 调研 |
| S0-02 | 存在理由分析 | 追问技能存在的根本原因,标记为必要/可消除/待评估/不可消除 | S0-01 | 调研→设计 |
| S0-03 | 消除可行性评估 | 评估技能是否可以完全消除:被其他技能吸收、功能分散、直接废弃 | S0-02 | 设计 |
| S0-04 | 独立存在必要性判断 | 判断技能是否值得独立存在:边界清晰度、功能内聚性、消除成本 | S0-03 | 设计→执行 |
| S0-05 | 决策输出 | 基于评估结果给出明确建议:消除/重构/保留 | S0-04 | 设计 |
阶段二:内容重构
| ID | 任务类型 | 说明 | 依赖 | 能力需求 |
|---|---|---|---|---|
| S0-06 | 组成部分识别 | 识别技能的每个组成部分(章节、范本、规则等) | S0-05(仅重构时) | 调研→设计 |
| S0-07 | 组成部分存在理由分析 | 逐部分追问存在理由,标记为核心/校准/传递/协调/校验/格式 | S0-06 | 调研→设计 |
| S0-08 | 补偿层消除 | 去掉传递/协调/格式环节,保留核心和校准环节 | S0-07 | 设计 |
| S0-09 | 重整 | 基于需求重编技能内容,保留的核心部分→重新编排为完整技能 | S0-08 | 设计→执行 |
| S0-10 | 重构验证 | 10项验证清单逐项检查 | S0-09 | 调研→合规 |
| S0-11 | 改造形态选择 | 根据验证结果选择最终形态 | S0-10 | 设计 |
依赖链路:
________ 为待用户提供的内容,不可AI编造;YAML frontmatter 建议保留 name、author、description 三个字段;章节结构可根据用户风格规范灵活调整对应任务: S0-01 ~ S0-11
适用场景: 任何已存在的技能需要评估和重构
改造范本:
## 技能改造记录
### 阶段一:领域消除评估
#### Step 1:边界识别(S0-01)
**目标技能**:________
**技能覆盖领域描述**:
- 包含:________
- 不包含:________
**与其他技能的交集**:
| 交集技能 | 交集内容 | 交集程度 |
|---------|---------|---------|
| ________ | ________ | 低/中/高 |
| ________ | ________ | 低/中/高 |
| ________ | ________ | 低/中/高 |
**边界清晰度**:清晰 / 模糊 / 高度重叠
**技能信息**:
- 创建时间:________
- 使用频率:近6个月使用___次
- 维护成本:低/中/高
#### Step 2:存在理由分析(S0-02)
**追问准则**:如果组织是完全扁平的、没有部门壁垒,这个技能还需要独立存在吗?
**存在理由**:________
**存在理由标记**:
- ⬜ 事情本身需要 → ✅必要
- ⬜ 人的局限需要 → ❌可消除
- ⬜ 历史遗留 → ⚠️待评估
- ⬜ 外部约束 → 🔒不可消除
**标记理由**:________
**存在理由细分**(如适用):
- 组织架构:________
- 协作需要:________
- 认知局限:________
- 历史惯性:________
- 法规要求:________
#### Step 3:消除可行性评估(S0-03)
**消除方案**:
| 方案 | 具体描述 | 成本 | 风险 |
|------|---------|------|------|
| 被其他技能吸收 | ________ | 低/中/高 | 低/中/高 |
| 功能分散到其他技能 | ________ | 低/中/高 | 低/中/高 |
| 直接废弃 | ________ | 低/中/高 | 低/中/高 |
**推荐方案**:________
**消除后功能覆盖度**:
- 功能A → 技能X
- 功能B → 技能Y
- 功能C → 技能Z
**消除成本评估**:低/中/高(理由:________)
**消除风险评估**:低/中/高(理由:________)
#### Step 4:独立存在必要性判断(S0-04)
**评分标准**:
- 边界清晰度(1-10):边界越清晰,分数越高
- 功能内聚性(1-10):功能越相关,分数越高
- 消除成本(1-10):成本越高,分数越高(越不值得消除)
**评分结果**:
| 维度 | 评分 | 权重 | 加权分 |
|------|------|------|--------|
| 边界清晰度 | ___/10 | 30% | ___ |
| 功能内聚性 | ___/10 | 40% | ___ |
| 消除成本 | ___/10 | 30% | ___ |
| **综合评分** | ___/10 | 100% | ___ |
**评分依据**:
- 边界清晰度:________
- 功能内聚性:________
- 消除成本:________
**必要性判定**:
- 综合评分 ≥ 7:技能值得独立存在 → 继续重构
- 综合评分 4-6:技能存在必要性存疑 → 进一步评估或部分消除
- 综合评分 < 4:技能不值得独立存在 → 消除
#### Step 5:决策输出(S0-05)
**评估结果汇总**:
- 边界识别:________
- 存在理由:________
- 消除可行性:________
- 独立存在必要性:________
**决策建议**:
- ⬜ 消除:技能不值得保留,建议消除
- ⬜ 重构:技能值得保留,建议重构
- ⬜ 保留:技能已足够优化,无需改动
**决策理由**:________
**后续行动建议**:
- 如果消除:________
- 如果重构:进入阶段二执行内容重构
- 如果保留:________
**决策置信度**:高/中/低
**决策风险提示**:________
---
### 阶段二:内容重构(仅决策为"重构"时执行)
#### Step 6:组成部分识别(S0-06)
**技能组成部分清单**:
| # | 组成部分 | 类型 | 说明 |
|---|---------|------|------|
| 1 | ________ | 章节/范本/规则 | ________ |
| 2 | ________ | 章节/范本/规则 | ________ |
| 3 | ________ | 章节/范本/规则 | ________ |
| ... | ... | ... | ... |
#### Step 7:组成部分存在理由分析(S0-07)
**追问准则**:如果执行者是一个拥有无限知识能力和零协作损耗的AI,这个部分还需要吗?
| # | 组成部分 | 存在理由 | 类型标记 | 标记理由 |
|---|---------|---------|---------|---------|
| 1 | ________ | 事情本身需要 | ✅核心 | ________ |
| 2 | ________ | 事情本身需要 | 🔶校准 | 中间产出物起纠偏作用,保留为分步校准点 |
| 3 | ________ | 人的局限需要 | ❌传递 | 人之间信息传递 |
| 4 | ________ | 人的局限需要 | ❌协调 | 管理多人协作 |
| 5 | ________ | 人的局限需要 | ⚡校验 | 防止人出错,保留关键节点 |
| 6 | ________ | 人的局限需要 | ❌格式 | 满足组织流程 |
| ... | ... | ... | ... | ... |
**统计**:✅核心___个 / 🔶校准___个 / ❌消除___个 / ⚡精简___个
#### Step 8:补偿层消除(S0-08)
**消除清单**:
| # | 被消除部分 | 原类型 | 消除理由 |
|---|-----------|--------|---------|
| 1 | ________ | 传递 | ________ |
| 2 | ________ | 协调 | ________ |
| 3 | ________ | 格式 | ________ |
| ... | ... | ... | ... |
**保留清单**:
| # | 保留部分 | 保留理由 | 类型 |
|---|---------|---------|------|
| 1 | ________ | 事情本身逻辑步骤 | ✅核心 |
| 2 | ________ | 中间产出物起纠偏作用 | 🔶校准 |
| 3 | ________ | 关键质量校验 | ⚡校验(精简后) |
| ... | ... | ... | ... |
#### Step 9:重整(S0-09)
**重构后技能结构**:
YAML frontmatter 建议保留 name、author、description 三个字段。
**重构后章节结构建议**:
1. 核心理念
2. 方法论(步骤/分类/标准)
3. 典型形态
4. 验证清单
5. 任务体系
6. 领域要求清单
7. 领域范本
8. 使用规则
9. 事实纪律
注:以上为建议结构,不同用户可根据自身风格规范灵活调整。
**重构理由**:________
#### Step 10:重构验证(S0-10)
| # | 验证项 | 通过? | 说明 |
|---|--------|-------|------|
| 1 | 领域评估准确 | ⬜是/⬜否 | 是否准确评估了技能领域的存在必要性 |
| 2 | 消除可行性评估合理 | ⬜是/⬜否 | 是否合理评估了消除的可行性 |
| 3 | 重构内容完整 | ⬜是/⬜否 | 是否覆盖了技能的全部核心内容 |
| 4 | 结构一致性 | ⬜是/⬜否 | 技能结构是否合理完整 |
| 5 | 改造建议明确 | ⬜是/⬜否 | 是否给出了明确的消除/重构/保留建议 |
| 6 | 领域清晰度 | ⬜是/⬜否 | 技能覆盖的领域边界是否清晰 |
| 7 | 内容完整性 | ⬜是/⬜否 | 技能是否覆盖了领域的全部核心内容 |
| 8 | 结构规范性 | ⬜是/⬜否 | YAML frontmatter和章节结构是否合理 |
| 9 | 可执行性 | ⬜是/⬜否 | 技能是否可直接使用,范本是否完整 |
| 10 | 独立性 | ⬜是/⬜否 | 技能是否独立,不依赖其他技能 |
**验证不通过项修正**:________
#### Step 11:改造形态选择(S0-11)
**选定形态**:________
| 形态 | 适用场景 | 本案是否适配 |
|------|---------|------------|
| 消除 | 技能领域不再需要、功能重叠、历史遗留 | ⬜是/⬜否 |
| 重构 | 技能领域需要存在,但内容需要优化 | ⬜是/⬜否 |
| 保留 | 技能已足够优化,无需改动 | ⬜是/⬜否 |
**选择理由**:________
---
### 改造前后对比
| 维度 | 改造前 | 改造后 | 变化 |
|------|--------|--------|------|
| 技能状态 | 存在 | 消除/重构/保留 | ________ |
| 功能覆盖 | 集中在该技能 | 分散到其他技能/保持集中 | ________ |
| 结构一致性 | 不一致/一致 | 更一致/已消除 | ________ |
| 使用频率 | 低/中/高 | 更高/已消除 | ________ |
范本要点:
________ 为待用户提供的内容,不可AI编造