Skill Refactor

Skill Refactor — 技能改造方法

核心理念

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

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

改造十一步法：

• 阶段一：领域消除评估
  • 第一步：边界识别——识别技能覆盖的领域边界
  • 第二步：存在理由分析——追问技能存在的根本原因
  • 第三步：消除可行性评估——评估技能是否可以完全消除
  • 第四步：独立存在必要性判断——判断技能是否值得独立存在
  • 第五步：决策输出——消除/重构/保留
• 阶段二：内容重构
  • 第六步：组成部分识别——识别技能的每个组成部分
  • 第七步：组成部分存在理由分析——逐部分追问存在理由
  • 第八步：补偿层消除——去掉传递/协调/格式环节
  • 第九步：重整——基于需求重编技能内容
  • 第十步：重构验证——10项验证清单
  • 第十一步：改造形态选择——选择最终形态

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

单独存在合理性：

• 对象特定：专门针对"技能"这个对象，技能有独特的结构（SKILL.md、范本、验证清单）
• 两阶段设计：先判断"值不值得存在"，再执行"怎么重构"
• 技能特有规则：技能的组成部分（YAML frontmatter、章节结构、范本）有其特殊性

---

改造十一步法

---

技能存在理由分类

---

技能组成部分类型

---

改造判断标准

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

---

改造后典型形态

选择原则：能消除的不重构，能重构的不保留。消除是最彻底的优化。

---

改造验证清单

改造完成后必须逐项验证，十项全部通过才算改造完成：

---

任务体系

领域清单与依赖拓扑

阶段一：领域消除评估

阶段二：内容重构

依赖链路：

• S0-01 → S0-02 → S0-03 → S0-04 → S0-05
• S0-05 → S0-06 → S0-07 → S0-08 → S0-09 → S0-10 → S0-11（仅决策为"重构"时执行）

---

领域要求清单

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 决策输出

• 必选组件: 决策建议（消除 / 重构 / 保留）、决策理由、后续行动建议
• 可选组件: 决策置信度（高/中/低）、决策风险提示、决策后跟踪指标
• 组装顺序: 评估结果汇总→决策建议→理由记录→后续行动建议
• 约束: 决策建议必须明确，不可模棱两可；如果建议消除，必须说明消除理由；如果建议重构，必须进入阶段二执行
• 格式: 决策记录（Markdown）

S0-06 组成部分识别

• 必选组件: 技能的每个组成部分（章节、范本、规则等）
• 可选组件: 组成部分间依赖关系、组成部分重要性评估
• 组装顺序: 技能内容梳理→组成部分列表→依赖关系标注→数据汇总
• 约束: 必须完整识别技能的所有组成部分，不可跳过"理所当然"的部分
• 格式: 技能组成部分清单（Markdown表格）

S0-07 组成部分存在理由分析

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

S0-08 补偿层消除

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

S0-09 重整

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

S0-10 重构验证

• 必选组件: 10项验证清单逐项检查结果
• 可选组件: 验证不通过项的修正方案
• 组装顺序: 逐项验证→记录结果→不通过项修正→二次验证→通过
• 约束: 10项必须全部通过；"内容完整性"不可妥协；"结构规范性"是硬约束
• 格式: 验证清单（Markdown检查表）

S0-11 改造形态选择

• 必选组件: 选定改造形态及理由、执行方式说明
• 可选组件: 形态切换条件、后续迭代方向
• 组装顺序: 验证结果评估→三种形态适配判断→选定→理由记录
• 约束: 选择最简形态——能消除的不重构，能重构的不保留
• 格式: 形态选择记录（Markdown）

---

领域范本

SR-01 技能改造范本

对应任务: 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编造

---

使用规则

1. 判断是否需要改造：当技能功能重叠、领域过时、使用频率低时，触发改造
2. 按十一步法执行：S0-01 → S0-11，不可跳步
3. 阶段一必执行：无论决策结果如何，都必须完成领域消除评估
4. 阶段二仅重构时执行：只有决策为"重构"时，才执行内容重构
5. 产出交付：按领域要求清单逐项填充，或按SR-01范本结构替换实际内容
6. 用户主权：AI按技能框架产出的内容是起点，不是终稿。用户对任何环节有独特的校准点、质量标准或业务约束，都可以也应当要求修改——尤其是评分标准的权重，只有用户知道哪些维度对他的场景最重要。用户还可以主动提供清单（该技能应包含的组件列表）和样本（高质量的同类技能作为参考）作为校准参考，让AI的产出更贴合实际需求

---

事实纪律

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