Skill Refactor

Other

技能改造方法。核心能力：评估技能是否需要存在（领域消除评估）→ 如果需要存在则重构技能内容（工作流重构）。八步法：边界识别→存在理由分析→消除可行性评估→独立存在必要性判断→拆解→消除→重整→改造输出。覆盖从技能领域评估、存在必要性判断、技能内容重构到改造验证的全流程。通用方法，不绑定任何特定技能。触发词：技能改造、技能重构、技能优化、skill refactor、技能整理、技能清理、技能评估。

Install

openclaw skills install skill-refactor

Skill Refactor — 技能改造方法

核心理念

技能存在的根本问题：不是"这个技能能不能优化"，而是"这个技能需不需要存在"。

传统思维是"技能存在→优化技能"，但更根本的问题是：这个技能是否本就不该存在？如果技能覆盖的领域是人的局限产物（历史遗留、重复功能、过时需求），那么消除技能比重构技能更彻底。

改造八步法：

第一步：边界识别——识别技能覆盖的领域边界
第二步：存在理由分析——追问技能存在的根本原因
第三步：消除可行性评估——评估技能是否可以完全消除
第四步：独立存在必要性判断——判断技能是否值得独立存在
第五步：拆解——识别技能的每个组成部分
第六步：消除——去掉不必要的组成部分
第七步：重整——基于需求重编技能内容
第八步：改造输出——给出明确的消除/重构/保留建议

适用范围：任何已存在的技能——用户技能、项目技能、市场技能等。

改造八步法

步骤	操作	要点
边界识别	识别技能覆盖的领域边界	明确技能包含什么、不包含什么
存在理由分析	追问技能存在的根本原因	事情本身需要 / 人的局限需要 / 历史遗留
消除可行性评估	评估技能是否可以完全消除	被其他技能吸收 / 功能分散 / 直接废弃
独立存在必要性判断	判断技能是否值得独立存在	边界清晰度 / 功能内聚性 / 消除成本
拆解	识别技能的每个组成部分	追问：这个部分存在是因为事情本身需要，还是人的局限需要？
消除	去掉不必要的组成部分	去掉传递/协调/格式环节，保留核心和校准环节
重整	基于需求重编技能内容	保留的核心部分→重新编排为完整技能
改造输出	给出明确的消除/重构/保留建议	消除/重构/保留三选一

技能存在理由分类

类型	标记	说明	处理建议
事情本身需要	✅必要	技能覆盖的领域有清晰的边界和内聚性	保留→重构技能内容
人的局限需要	❌可消除	技能覆盖的领域是因为人的认知局限、历史遗留	消除→删除技能
历史遗留	⚠️待评估	技能覆盖的领域是因为历史原因，当前必要性存疑	评估后决定
外部约束	🔒不可消除	技能覆盖的领域是因为法规、标准、合同等外部约束	保留→重构技能内容

改造判断标准

满足任一即建议消除技能：

条件	阈值	示例
功能重叠度	技能功能≥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	调研→设计
S0-06	消除	去掉传递/协调/格式环节，保留核心和校准环节	S0-05	设计
S0-07	重整	基于需求重编技能内容，保留的核心部分→重新编排为完整技能	S0-06	设计→执行
S0-08	改造输出	基于改造结果给出明确建议：消除/重构/保留	S0-07	设计

依赖链路：S0-01 → S0-02 → S0-03 → S0-04 → S0-05 → S0-06 → S0-07 → S0-08（八步法）

领域要求清单

S0-01 边界识别

必选组件: 技能名称、技能覆盖领域描述（包含什么、不包含什么）、与其他技能的交集列表、边界清晰度评估（清晰/模糊/高度重叠）
可选组件: 技能创建时间、技能使用频率、技能维护成本
组装顺序: 技能确认→领域梳理→交集识别→边界清晰度评估→数据汇总
约束: 必须完整识别技能覆盖的领域，不可跳过"理所当然"的功能；边界清晰度必须基于客观标准，不可凭感觉
格式: 技能领域边界图（Markdown表格+交集标注）

S0-02 存在理由分析

必选组件: 技能存在的根本原因（事情本身需要 / 人的局限需要 / 历史遗留 / 外部约束）、存在理由标记（✅必要 / ❌可消除 / ⚠️待评估 / 🔒不可消除）、标记理由
可选组件: 存在理由细分（组织架构/协作需要/认知局限/历史惯性/法规要求）、消除动机评估
组装顺序: 追问存在理由→根本原因判定→类型标记→理由记录→汇总统计
约束: 每个技能必须追问"如果组织是完全扁平的、没有部门壁垒，这个技能还需要独立存在吗？"；判定必须基于事情本身逻辑，不可因"行业惯例"保留
格式: 存在理由分析表（Markdown表格）

S0-03 消除可行性评估

必选组件: 消除方案（被其他技能吸收 / 功能分散到其他技能 / 直接废弃）、消除成本评估（低/中/高）、消除风险评估（低/中/高）、消除后功能覆盖度
可选组件: 消除时间表、消除后需新增的协调机制、消除后需调整的依赖关系
组装顺序: 消除方案设计→成本评估→风险评估→功能覆盖度验证→消除可行性判定
约束: 消除方案必须具体到"功能A→技能X，功能B→技能Y"；成本评估必须基于实际数据，不可凭感觉；风险评估必须考虑最坏情况
格式: 消除方案表（Markdown表格）

S0-04 独立存在必要性判断

必选组件: 边界清晰度评分（1-10）、功能内聚性评分（1-10）、消除成本评分（1-10，越高越不值得消除）、独立存在必要性评分（综合评分）
可选组件: 评分依据详细说明、敏感性分析（不同权重下的评分变化）
组装顺序: 边界清晰度评分→功能内聚性评分→消除成本评分→综合评分→必要性判定
约束: 评分必须基于客观标准，不可凭感觉；综合评分必须考虑三个维度的权重（边界清晰度30%，功能内聚性40%，消除成本30%）
格式: 评分表（Markdown表格）

S0-05 拆解

必选组件: 技能的每个组成部分（章节、范本、规则等）、每个部分的存在理由（事情本身需要 / 人的局限需要）、部分类型标记（✅核心 / 🔶校准 / ❌传递 / ❌协调 / ⚡校验 / ❌格式）
可选组件: 部分间依赖关系、部分重要性评估
组装顺序: 技能内容梳理→逐部分追问→存在理由判定→类型标记→理由记录→汇总统计
约束: 每个部分必须追问"如果执行者是一个拥有无限知识能力和零协作损耗的AI，这个部分还需要吗？"；判定必须基于事情本身逻辑，不可因"行业惯例"保留
格式: 技能组成部分分析表（Markdown表格）

S0-06 消除

必选组件: 消除清单（哪些部分消除、为什么可消除）、保留清单（✅核心部分+🔶校准部分+⚡关键校验部分）、消除后的内容传递方式
可选组件: 每个消除部分的风险评估、消除后需新增的关键校验点
组装顺序: ❌标记部分逐一评估→消除决策→🔶校准部分确认→保留部分确认→关键校验点插入→消除清单+保留清单
约束: 消除传递/协调/格式部分不可犹豫——这些是人的局限产物不是事情本身需要；校验部分精简为关键节点但涉及合规的不可消除；校准部分不可消除——起纠偏作用的必须保留
格式: 消除决策表（Markdown表格）

S0-07 重整

必选组件: 重构后技能结构（YAML frontmatter + 章节结构）、重构后技能内容
可选组件: 重构前后对比、重构理由说明
组装顺序: 保留部分排序→技能结构设计→内容填充→范本编写→规则制定→验证清单
约束: 内容必须基于实际能力，不可夸大；范本中 ________ 为待用户提供的内容，不可AI编造；YAML frontmatter 建议保留 name、author、description 三个字段；章节结构可根据用户风格规范灵活调整
格式: 完整 SKILL.md 文件

S0-08 改造输出

必选组件: 改造建议（消除 / 重构 / 保留）、改造理由、后续行动建议
可选组件: 改造置信度（高/中/低）、改造风险提示、改造后跟踪指标
组装顺序: 改造结果汇总→改造建议→理由记录→后续行动建议
约束: 改造建议必须明确，不可模棱两可；如果建议消除，必须说明消除理由；如果建议重构，必须提供重构后的完整技能内容
格式: 改造记录（Markdown）

领域范本

SR-01 技能改造范本

对应任务: S0-01 ~ S0-08

适用场景: 任何已存在的技能需要评估和重构

改造范本:

## 技能改造记录

### Step 1：边界识别（S0-01）

**目标技能**：________（如：workflow-refactor/domain-elimination-assessor/________）

**技能覆盖领域描述**：
- 包含：________
- 不包含：________

**与其他技能的交集**：

| 交集技能 | 交集内容 | 交集程度 |
|---------|---------|---------|
| ________ | ________ | 低/中/高 |
| ________ | ________ | 低/中/高 |
| ________ | ________ | 低/中/高 |

**边界清晰度**：清晰 / 模糊 / 高度重叠

**技能信息**：
- 创建时间：________
- 使用频率：近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）

**追问准则**：如果执行者是一个拥有无限知识能力和零协作损耗的AI，这个部分还需要吗？

| # | 组成部分 | 存在理由 | 类型标记 | 标记理由 |
|---|---------|---------|---------|---------|
| 1 | ________ | 事情本身需要 | ✅核心 | ________ |
| 2 | ________ | 事情本身需要 | 🔶校准 | 中间产出物起纠偏作用，保留为分步校准点 |
| 3 | ________ | 人的局限需要 | ❌传递 | 人之间信息传递 |
| 4 | ________ | 人的局限需要 | ❌协调 | 管理多人协作 |
| 5 | ________ | 人的局限需要 | ⚡校验 | 防止人出错，保留关键节点 |
| 6 | ________ | 人的局限需要 | ❌格式 | 满足组织流程 |
| ... | ... | ... | ... | ... |

**统计**：✅核心___个 / 🔶校准___个 / ❌消除___个 / ⚡精简___个

### Step 6：消除（S0-06）

**消除清单**：

| # | 被消除部分 | 原类型 | 消除理由 |
|---|-----------|--------|---------|
| 1 | ________ | 传递 | ________ |
| 2 | ________ | 协调 | ________ |
| 3 | ________ | 格式 | ________ |
| ... | ... | ... | ... |

**保留清单**：

| # | 保留部分 | 保留理由 | 类型 |
|---|---------|---------|------|
| 1 | ________ | 事情本身逻辑步骤 | ✅核心 |
| 2 | ________ | 中间产出物起纠偏作用 | 🔶校准 |
| 3 | ________ | 关键质量校验 | ⚡校验（精简后） |
| ... | ... | ... | ... |

### Step 7：重整（S0-07）

**重构后技能结构**：

YAML frontmatter 建议保留 name、author、description 三个字段。

**重构后章节结构建议**：
1. 核心理念
2. 方法论（步骤/分类/标准）
3. 典型形态
4. 验证清单
5. 任务体系
6. 领域要求清单
7. 领域范本
8. 使用规则
9. 事实纪律

注：以上为建议结构，不同用户可根据自身风格规范灵活调整。

**重构理由**：________

### Step 8：改造输出（S0-08）

**改造结果汇总**：
- 边界识别：________
- 存在理由：________
- 消除可行性：________
- 独立存在必要性：________
- 拆解结果：________
- 消除结果：________
- 重整结果：________

**改造建议**：
- ⬜ 消除：技能不值得保留，建议消除
- ⬜ 重构：技能值得保留，建议重构
- ⬜ 保留：技能已足够优化，无需改动

**改造理由**：________

**后续行动建议**：
- 如果消除：________
- 如果重构：提供重构后的完整技能内容
- 如果保留：________

**改造置信度**：高/中/低

**改造风险提示**：________

---

### 改造前后对比

| 维度 | 改造前 | 改造后 | 变化 |
|------|--------|--------|------|
| 技能状态 | 存在 | 消除/重构/保留 | ________ |
| 功能覆盖 | 集中在该技能 | 分散到其他技能/保持集中 | ________ |
| 结构一致性 | 不一致/一致 | 更一致/已消除 | ________ |
| 使用频率 | 低/中/高 | 更高/已消除 | ________ |

范本要点:

改造的核心是"追问存在理由"——每个技能都必须回答"这个技能覆盖的领域是否还需要存在"
消除技能比重构技能更彻底——如果技能领域本不该存在，消除是最佳选择
评分必须基于客观标准，不可凭感觉——功能重叠度、领域过时度、使用频率、维护成本都需要量化
改造建议必须明确——消除/重构/保留三选一，不可模棱两可
范本中 ________ 为待用户提供的内容，不可AI编造

使用规则

判断是否需要改造：当技能功能重叠、领域过时、使用频率低时，触发改造
按八步法执行：S0-01 → S0-02 → S0-03 → S0-04 → S0-05 → S0-06 → S0-07 → S0-08，不可跳步
产出交付：按领域要求清单逐项填充，或按SR-01范本结构替换实际内容
用户主权：AI按技能框架产出的内容是起点，不是终稿。用户对任何环节有独特的校准点、质量标准或业务约束，都可以也应当要求修改——尤其是评分标准的权重，只有用户知道哪些维度对他的场景最重要。用户还可以主动提供清单（该技能应包含的组件列表）和样本（高质量的同类技能作为参考）作为校准参考，让AI的产出更贴合实际需求

事实纪律

AI工具能力描述必须基于实际能力，不得夸大
改造结果必须标注为"参考范围"，实际效果取决于具体技能
涉及法规、标准、合同等外部约束的技能必须明确标注，不可因改造而忽略
"技能存在必要性判断"必须基于客观数据，不可凭感觉
"技能内容重构"必须基于实际能力，不可夸大