skill-improver

スキル改善ツール

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 にある改善を適用して」
• 「品質レポートに基づいてスキルを更新して」
• 「api-helper の改善計画を実行して」
• 「品質レビューで特定された問題を修正して」

このスキルを使用する場面：

• 改善計画に基づく改善を適用するとき
• 品質レビューのフィードバックに基づいてスキルを更新するとき
• skill-quality-reviewer が推奨する修正を実行するとき
• スキルのドキュメントに体系的な改善を実装するとき

手順ガイド

ステップ 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

計画を検証します：

• ファイルが存在し、読み取り可能である
• 優先度セクション（High／Medium／Low）が含まれている
• 改善項目が構造化されている
• ファイルパスと推奨される変更が含まれている

計画の構造について詳しくは、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 ツールを使用します
• 変更が適用されたことを1件ずつ確認します

ステップ 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-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