skill-improver

Skill 改进器

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

核心工作流

Read improvement-plan-{name}.md
    ↓
Parse improvement items (High/Medium/Low priority)
    ↓
Group changes by file
    ↓
Detect and resolve conflicts
    ↓
Backup original files
    ↓
Execute updates (Edit or Write tools)
    ↓
Verify results
    ↓
Generate update-report

适用场景

触发短语：

• “应用 improvement-plan-git-workflow.md 中的改进”
• “根据质量报告更新我的 Skill”
• “执行 api-helper 的改进计划”
• “修复质量审查中发现的问题”

在以下情况下使用此 Skill：

• 应用改进计划中的改进
• 根据质量审查反馈更新 Skill
• 执行 skill-quality-reviewer 推荐的修复
• 对 Skill 文档实施结构化改进

分步指南

步骤 1：加载改进计划

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

# Plan is typically in current directory
ls improvement-plan-*.md

# Or specify full path
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}/

# Use backup script
~/.claude/skills/skill-improver/scripts/backup-skill.sh <skill-path>

应用更改：

• 对现有内容使用 Edit 工具
• 对新文件使用 Write 工具
• 验证每项更改均已应用

步骤 6：验证并报告

验证检查：

1. YAML 语法有效
2. 所有修改的文件均存在且有效
3. 新文件已成功创建
4. 未发生意外更改

# Use verify script
~/.claude/skills/skill-improver/scripts/verify-update.sh <skill-path>

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

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

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

优先级处理

高优先级

优先执行。通常用于处理：

• 关键描述问题
• 重大写作风格问题
• 缺失的结构要素
• 安全相关问题

中优先级

高优先级项目之后执行。通常用于处理：

• 内容组织改进
• 补充示例
• 文档增强

低优先级

最后执行。通常用于处理：

• 细节澄清
• 可有可无的改进
• 润色和完善

与 Skill Quality Reviewer 集成

此 Skill 可与 skill-quality-reviewer 无缝协作：

Current Skill (67/100 D+)
    ↓ [skill-quality-reviewer]
Improvement Plan
    ↓ [skill-improver]
Improved Skill (87/100 B+)
    ↓ [skill-quality-reviewer]
Quality Report (validation)

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

其他资源

参考文件

• 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：改进本地技能

User: "Apply improvements from improvement-plan-git-workflow.md"

[Claude executes the workflow:]
1. Reads improvement-plan-git-workflow.md
2. Parses all improvement items
3. Groups changes by file
4. Detects and resolves conflicts
5. Sorts by priority
6. Backs up git-workflow skill
7. Executes updates
8. Verifies results
9. Generates update-report-git-workflow-timestamp.md

示例 2：根据质量审查更新技能

User: "Update my api-helper skill based on quality report"

[Claude:]
1. Locates improvement-plan-api-helper.md
2. Applies all recommended changes
3. Verifies skill structure
4. Reports quality improvement: 72/100 → 91/100