Skill Refactor

技能自动化重构器 (Skill Refactor)

📁 详细代码实现见 code.md

功能概述

本技能用于自动化维护和优化其他技能的文件结构：

1. 代码分离：自动识别并���取 SKILL.md 中的代码块到 code.md
2. 内容拆分：当文件过长时智能拆分为多个模块
3. 结构优化：保持功能完整性，添加模块引用

触发条件

自动触发（混合模式）

当检测到以下情况时，提示用户确认后执行：

• 写入 .claude/skills/**/SKILL.md 后检测到：
  • 包含可提取的代码块
  • 文件行数 > 300行
• 写入 .claude/skills/**/code.md 后检测到：
  • 文件行数 > 400行

手动触发

• "重构技能"、"拆分技能"
• "技能代码分离"、"优化技能结构"
• "整理技能文件"、"技能模块化"

阈值配置

用户确认机制

检测到需要重构时，显示预览并询问用户：

🔍 检测到 {skill_name} 需要重构：
- 包含 X 个代码块可提取
- 文件长度 Y 行（超过阈值）

是否执行重构？
[✅ 立即执行] [⏭️ 跳过] [📋 查看详情]

工作流程

1. 代码提取流程

SKILL.md (包含代码块)
    ↓ 分析
识别 ```python``` 等代码块
    ↓ 提取
创建/更新 code.md
    ↓ 引用
在 SKILL.md 添加 > 📁 详见 [code.md](code.md)

2. 内容拆分流程

SKILL.md (> 300行)
    ↓ 分析章节结构
按 ## 标题分组
    ↓ 拆分
├── SKILL.md (主文档，< 150行)
├── modules/overview.md (模块概览)
├── modules/module1.md (模块1详细)
└── modules/module2.md (模块2详细)

3. code.md 拆分流程

code.md (> 400行)
    ↓ 分析代码结构
按功能模块分组
    ↓ 拆分
├── code.md (主入口)
├── scripts/core.py (核心函数)
├── scripts/utils.py (工具函数)
└── scripts/constants.py (常量定义)

拆分原则

1. 按章节拆分：以 ## 标题为边界
2. 保持功能完整：每个模块独立可用
3. 添加引用链接：模块间双向引用
4. 更新文档索引：在 SKILL.md 中维护模块列表

输出格式

变更报告

# 🔧 技能重构报告

## 📊 变更统计
| 项目 | 原始 | 重构后 |
|------|------|--------|
| SKILL.md 行数 | 404 | 198 |
| code.md 行数 | 0 | 285 |
| 新增模块文件 | 0 | 2 |

## ✅ 执行操作
1. 提取 5 个代码块到 code.md
2. 拆分 "详细SOP模板" 章节到 modules/sop_details.md
3. 拆分 "符号体系" 章节到 modules/symbols.md
4. 更新 SKILL.md 模块引用表

## 📁 文件变更
- 修改: SKILL.md (-206行)
- 新增: code.md (+285行)
- 新增: modules/sop_details.md (+156行)
- 新增: modules/symbols.md (+89行)

验证标准

• 代码块已提取到 code.md
• SKILL.md 长度 < 300行
• code.md 长度 < 400行（如已拆分）
• 功能描述保持不变
• 模块引用链接正确
• 无内容丢失

使用示例

示例1：自动触发

用户修改了 kaoyan-electronics-sop/SKILL.md

AI 检测后提示：
🔍 检测到 kaoyan-electronics-sop/SKILL.md 需要重构：
- 包含 8 个代码块可提取
- 文件长度 404 行（超过 300 行阈值）

用户确认：[✅ 立即执行]

AI 执行重构并生成报告...

示例2：手动触发

用户：帮我重构 kaoyan-electronics-core 技能

AI 执行：
1. 分析 kaoyan-electronics-core 目录
2. 检测 SKILL.md 和 code.md
3. 执行必要的拆分操作
4. 生成变更报告

技能集成

与其他技能的协作

📁 模块文档

创建日期: 2026-03-27 版本: 1.0.0