⚡

技能改进器Skill skill-improver

该技能用于自动读取并执行由技能质量审核器生成的改进计划文件，以提升Claude Skills的质量。它涉及解析改进项、分组更改、解决冲突、备份文件、执行更新和验证结果，适用于开发工具和自动化流程。关键词：技能改进、自动化更新、质量提升、Claude Skills、开发工具、DevOps、测试验证。

DevOps 0 次安装 0 次浏览 更新于 3/13/2026

name: 技能改进器 description: 此技能应在用户要求"应用技能改进"、“从计划更新技能”、“执行改进计划”、“修复技能问题”、"实施技能建议"或提及从质量审核报告应用改进时使用。读取由skill-quality-reviewer生成的improvement-plan-{name}.md文件，并智能合并和执行建议的更改以改进Claude Skills的质量。 version: 1.0.0

技能改进器

执行由skill-quality-reviewer生成的改进计划，以自动更新和修复Claude Skills中的问题。

核心工作流

读取improvement-plan-{name}.md
    ↓
解析改进项（高/中/低优先级）
    ↓
按文件分组更改
    ↓
检测并解决冲突
    ↓
备份原始文件
    ↓
执行更新（使用编辑或写入工具）
    ↓
验证结果
    ↓
生成更新报告

何时使用

触发短语：

  • “应用来自improvement-plan-git-workflow.md的改进”
  • “基于质量报告更新我的技能”
  • “执行api-helper的改进计划”
  • “修复质量审核中识别的问题”

在以下情况下使用此技能：

  • 应用改进计划中的改进
  • 基于质量审核反馈更新技能
  • 执行skill-quality-reviewer推荐修复
  • 实施结构化的技能文档改进

分步指南

步骤 1：加载改进计划

读取由skill-quality-reviewer生成的improvement-plan-{skill-name}.md文件。

# 计划通常位于当前目录
ls improvement-plan-*.md

# 或指定完整路径
read /path/to/improvement-plan-my-skill.md

验证计划：

  • 文件存在且可读
  • 包含优先级部分（高/中/低）
  • 具有结构化的改进项
  • 包括文件路径和建议更改

有关详细计划结构，请参阅references/plan-format.md。

步骤 2：解析和分组更改

提取所有改进建议并按目标文件组织。

从每个项中提取：

  • 文件路径（例如，SKILL.md:line:line或references/file.md）
  • 维度（描述质量、内容组织等）
  • 影响（+X分）
  • 当前内容
  • 建议内容
  • 更改原因

构建更新队列：

by_file = {
  "SKILL.md": [change1, change2, ...],
  "references/guide.md": [change3, ...],
  "examples/demo.md": [change4, ...],
}

步骤 3：检测和解决冲突

检查当多个更改影响相同内容时的冲突。

解决策略：

  1. 高优先级优先于中/低优先级
  2. 如果优先级相同，保留第一个更改
  3. 标记冲突以供手动审核
  4. 在更新报告中记录解决方案

有关详细合并逻辑，请参阅references/merge-strategies.md。

步骤 4：按优先级排序

在每个文件内按优先级排序更改。

优先级顺序：

  1. 高优先级（首先执行）
  2. 中优先级（其次执行）
  3. 低优先级（最后执行）

步骤 5：备份和执行

备份位置： ~/.claude/skills/backup/{skill-name}-{timestamp}/

# 使用备份脚本
~/.claude/skills/skill-improver/scripts/backup-skill.sh <skill-path>

应用更改：

  • 使用编辑工具处理现有内容
  • 使用写入工具创建新文件
  • 验证每个更改已应用

步骤 6：验证和报告

验证检查：

  1. YAML语法有效
  2. 所有修改的文件存在且有效
  3. 新文件成功创建
  4. 未发生意外更改
# 使用验证脚本
~/.claude/skills/skill-improver/scripts/verify-update.sh <skill-path>

生成update-report-{skill-name}-{timestamp}.md，记录：

  • 摘要（修改的文件、创建的文件、总更改数）
  • 应用的更改（按文件细分）
  • 质量改进（前后分数）
  • 验证结果
  • 备份位置

有关报告模板，请参阅examples/update-report-example.md。

优先级处理

高优先级

首先执行。这些通常涉及：

  • 关键描述问题
  • 主要写作风格问题
  • 缺少结构元素
  • 安全相关关注

中优先级

在高优先级之后执行。这些通常涉及：

  • 内容组织改进
  • 附加示例
  • 文档增强

低优先级

最后执行。这些通常涉及：

  • 次要澄清
  • 锦上添花的改进
  • 润色和精炼

与技能质量审核器的集成

此技能与skill-quality-reviewer无缝协作：

当前技能（67/100 D+）
    ↓ [skill-quality-reviewer]
改进计划
    ↓ [skill-improver]
改进后的技能（87/100 B+）
    ↓ [skill-quality-reviewer]
质量报告（验证）

迭代直到达到期望的质量水平。

附加资源

参考文件

  • references/plan-format.md - 改进计划文件结构和格式
  • references/merge-strategies.md - 详细合并算法和冲突解决
  • references/error-handling.md - 错误处理策略
  • references/supported-updates.md - 支持的更新类型及示例

示例文件

  • examples/improvement-plan-example.md - 示例改进计划
  • examples/update-report-example.md - 示例更新报告

脚本

  • scripts/backup-skill.sh - 更新前创建技能备份
  • scripts/verify-update.sh - 更新后验证技能完整性

最佳实践

应用更新前

  1. 审阅改进计划 - 了解将更改什么
  2. 验证备份位置 - 确保可以恢复备份
  3. 检查手动更改 - 注意任何未提交的本地修改
  4. 评估影响 - 审阅预期的质量改进

更新执行期间

  1. 按优先级顺序处理 - 高 → 中 → 低
  2. 每个文件后验证 - 检查更新是否正确应用
  3. 记录所有更改 - 记录修改内容
  4. 优雅处理冲突 - 必要时标记以供审核

应用更新后

  1. 审阅更新报告 - 确认所有更改是预期的
  2. 测试技能 - 验证其仍能正常工作
  3. 比较分数 - 检查质量改进是否符合预期
  4. 保留备份 - 保持备份直到对更改有信心

使用示例

示例 1：应用本地技能的改进

用户："应用来自improvement-plan-git-workflow.md的改进"

[Claude执行工作流：]
1. 读取improvement-plan-git-workflow.md
2. 解析所有改进项
3. 按文件分组更改
4. 检测并解决冲突
5. 按优先级排序
6. 备份git-workflow技能
7. 执行更新
8. 验证结果
9. 生成update-report-git-workflow-timestamp.md

示例 2：基于质量报告更新技能

用户："基于质量报告更新我的api-helper技能"

[Claude：]
1. 定位improvement-plan-api-helper.md
2. 应用所有推荐更改
3. 验证技能结构
4. 报告质量改进：72/100 → 91/100