技能改造方法skill-refactor

Skill RefactorSkillHubSkill RefactorClawHubname: skill-refactorauthor: 王教成 Wang Jiaocheng (波动几何)description: 技能改造方法。核心能力评估技能是否需要存在领域消除评估→ 如果需要存在则重构技能内容工作流重构。十一步法边界识别→存在理由分析→消除可行性评估→独立存在必要性判断→决策输出→组成部分识别→组成部分存在理由分析→补偿层消除→重整→重构验证→改造形态选择。覆盖从技能领域评估、存在必要性判断、技能内容重构到改造验证的全流程。通用方法不绑定任何特定技能。触发词技能改造、技能重构、技能优化、skill refactor、技能整理、技能清理、技能评估。Skill Refactor — 技能改造方法核心理念技能存在的根本问题不是这个技能能不能优化而是这个技能需不需要存在。传统思维是技能存在→优化技能但更根本的问题是这个技能是否本就不该存在如果技能覆盖的领域是人的局限产物历史遗留、重复功能、过时需求那么消除技能比重构技能更彻底。改造十一步法阶段一领域消除评估第一步边界识别——识别技能覆盖的领域边界第二步存在理由分析——追问技能存在的根本原因第三步消除可行性评估——评估技能是否可以完全消除第四步独立存在必要性判断——判断技能是否值得独立存在第五步决策输出——消除/重构/保留阶段二内容重构第六步组成部分识别——识别技能的每个组成部分第七步组成部分存在理由分析——逐部分追问存在理由第八步补偿层消除——去掉传递/协调/格式环节第九步重整——基于需求重编技能内容第十步重构验证——10项验证清单第十一步改造形态选择——选择最终形态适用范围任何已存在的技能——用户技能、项目技能、市场技能等。单独存在合理性对象特定专门针对技能这个对象技能有独特的结构SKILL.md、范本、验证清单两阶段设计先判断值不值得存在再执行怎么重构技能特有规则技能的组成部分YAML frontmatter、章节结构、范本有其特殊性改造十一步法阶段步骤操作要点领域消除评估1. 边界识别识别技能覆盖的领域边界明确技能包含什么、不包含什么2. 存在理由分析追问技能存在的根本原因事情本身需要 / 人的局限需要 / 历史遗留3. 消除可行性评估评估技能是否可以完全消除被其他技能吸收 / 功能分散 / 直接废弃4. 独立存在必要性判断判断技能是否值得独立存在边界清晰度 / 功能内聚性 / 消除成本5. 决策输出给出明确的消除/重构/保留建议消除/重构/保留三选一内容重构6. 组成部分识别识别技能的每个组成部分章节、范本、规则等7. 组成部分存在理由分析逐部分追问存在理由标记为核心/校准/传递/协调/校验/格式8. 补偿层消除去掉不必要的组成部分去掉传递/协调/格式保留核心校准9. 重整基于需求重编技能内容保留部分→重新编排为完整SKILL.md10. 重构验证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设计依赖链路S0-01 → S0-02 → S0-03 → S0-04 → S0-05S0-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 决策输出必选组件: 决策建议消除 / 重构 / 保留、决策理由、后续行动建议可选组件: 决策置信度高/中/低、决策风险提示、决策后跟踪指标组装顺序: 评估结果汇总→决策建议→理由记录→后续行动建议约束: 决策建议必须明确不可模棱两可如果建议消除必须说明消除理由如果建议重构必须进入阶段二执行格式: 决策记录MarkdownS0-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编造使用规则判断是否需要改造当技能功能重叠、领域过时、使用频率低时触发改造按十一步法执行S0-01 → S0-11不可跳步阶段一必执行无论决策结果如何都必须完成领域消除评估阶段二仅重构时执行只有决策为重构时才执行内容重构产出交付按领域要求清单逐项填充或按SR-01范本结构替换实际内容用户主权AI按技能框架产出的内容是起点不是终稿。用户对任何环节有独特的校准点、质量标准或业务约束都可以也应当要求修改——尤其是评分标准的权重只有用户知道哪些维度对他的场景最重要。用户还可以主动提供清单该技能应包含的组件列表和样本高质量的同类技能作为参考作为校准参考让AI的产出更贴合实际需求事实纪律AI工具能力描述必须基于实际能力不得夸大改造结果必须标注为参考范围实际效果取决于具体技能涉及法规、标准、合同等外部约束的技能必须明确标注不可因改造而忽略技能存在必要性判断必须基于客观数据不可凭感觉技能内容重构必须基于实际能力不可夸大