mcpField
H
heal-skill

heal-skill

github.com/everyincエージェントワークフロー25.8k40 回インストール今日更新
リポジトリ

heal-skill について

heal-skillは、実行中に見つかった問題に基づいてエージェントスキルのファイルを更新します。対象を特定して変更案を提示し、承認後に編集します。任意でコミットもできます。

主な機能

  1. 01会話からスキルを特定
  2. 02問題と根本原因を分析
  3. 03変更前後の案を提示
  4. 04承認後にファイルを編集
  5. 05任意で変更をコミット

活用シーン

  1. 01古くなったスキルの説明を修正
  2. 02実行中に判明した誤りに対応
  3. 03関連ファイルの変更案を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/everyinc/compound-engineering-plugin --skill heal-skill

インストール後、Claude Code で/heal-skillを入力して読み込まれたか確認します。

詳細

実行中に判明した修正点に基づいて、スキルの SKILL.md と関連ファイルを更新します。

会話を分析して、実行中のスキルを特定し、何がうまくいかなかったかを振り返り、具体的な修正案を提示してユーザーの承認を得たうえで、変更を適用します。必要に応じてコミットも行います。

スキルの検出:!`ls -1 ./skills/*/SKILL.md | head -5`

<quick_start>

  1. スキルを検出します(会話のコンテキスト、呼び出しメッセージ、最近参照された SKILL.md から)
  2. 振り返りを行い、何がうまくいかなかったか、修正方法をどのように見つけたかを確認します
  3. 変更案を提示します(変更前と変更後の差分を含めます)
  4. 承認を得てから変更します
  5. 変更を適用し、必要に応じてコミットします

</quick_start>

会話のコンテキストからスキルを特定します。
  • スキルの呼び出しメッセージを探します
  • 最近参照された SKILL.md を確認します
  • 現在のタスクのコンテキストを調べます

次のように設定します:SKILL_NAME=[skill-name]、SKILL_DIR=./skills/$SKILL_NAME

判別できない場合は、ユーザーに確認します。 </step_1>

<step_2 name="reflection_and_analysis"> $ARGUMENTS が指定されている場合はその内容を優先し、指定されていない場合はより広いコンテキストを分析します。

次の点を特定します。

  • 問題点:誤りのある SKILL.md の該当箇所を引用します
  • 発見方法:Context7、エラーメッセージ、試行錯誤、ドキュメントの確認など
  • 根本原因:古い API、誤ったパラメーター、間違ったエンドポイント、コンテキストの不足など
  • 影響範囲:単一のセクションか、複数のセクションか。関連ファイルへの影響も確認します
  • 修正案:対象ファイルと各セクションの変更前・変更後を示します </step_2>

<step_3 name="scan_affected_files">

ls -la $SKILL_DIR/
ls -la $SKILL_DIR/references/ 2>/dev/null
ls -la $SKILL_DIR/scripts/ 2>/dev/null

</step_3>

<step_4 name="present_proposed_changes"> 次の形式で変更内容を提示します。

**Skill being healed:** [skill-name]
**Issue discovered:** [1-2 sentence summary]
**Root cause:** [brief explanation]

**Files to be modified:**
- [ ] SKILL.md
- [ ] references/[file].md
- [ ] scripts/[file].py

**Proposed changes:**

### Change 1: SKILL.md - [Section name]
**Location:** Line [X] in SKILL.md

**Current (incorrect):**

[現在のファイルの正確なテキスト]


**Corrected:**

[新しいテキスト]


**Reason:** [why this fixes the issue]

[repeat for each change across all files]

**Impact assessment:**
- Affects: [authentication/API endpoints/parameters/examples/etc.]

**Verification:**
These changes will prevent: [specific error that prompted this]

</step_4>

<step_5 name="request_approval">

Should I apply these changes?

1. Yes, apply and commit all changes
2. Apply but don't commit (let me review first)
3. Revise the changes (I'll provide feedback)
4. Cancel (don't make changes)

Choose (1-4):

ユーザーの返答を待ちます。承認なしに先へ進んではいけません。 </step_5>

<step_6 name="apply_changes"> 承認(オプション 1 または 2)を得た後にのみ、次を行います。

  1. 各修正について、すべてのファイルに Edit ツールを使用します
  2. 変更した箇所を読み返して確認します
  3. オプション 1 の場合は、修正内容が分かる構成のコミットメッセージでコミットします
  4. 対象ファイルの一覧を添えて、完了を報告します </step_6>

<success_criteria>

  • 会話のコンテキストからスキルを正しく特定している
  • 誤りのある箇所をすべて特定し、変更前・変更後を示している
  • 変更を適用する前にユーザーの承認を得ている
  • SKILL.md と関連ファイルすべてに変更を適用している
  • 変更を読み返して確認している
  • ユーザーがオプション 1 を選んだ場合、コミットを作成している
  • 対象ファイルの一覧を添えて完了を報告している </success_criteria>
完了前に、次の点を確認します。
  • 変更した各箇所を読み返し、変更が適用されていることを確認します
  • ファイル間の整合性を確認します(SKILL.md の例と references/ の内容が一致していること)
  • オプション 1 が選択された場合、git コミットが作成されていることを確認します
  • 意図しないファイルが変更されていないことを確認します

コメント