heal-skill

<objective> 実行中に発見された修正に基づいて、スキルの SKILL.md および関連ファイルを更新する。

会話を分析して実行中のスキルを検出し、何が問題だったかを反省し、具体的な修正案を提示し、ユーザーの承認を得て、オプションでコミット可能な変更を適用する。 </objective>

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

<quick_start> <workflow>

1. スキルを検出 する（会話コンテキスト、呼び出しメッセージ、最近参照された SKILL.md から）
2. 反省する - 何が問題だったか、修正をどのように発見したか
3. 提示する - 変更案を修正前後の差分付きで表示
4. 承認を得る - 編集前にユーザーの承認を取得
5. 適用する - 変更を適用し、オプションでコミット </workflow>

</quick_start>

<process> <step_1 name="detect_skill"> 会話コンテキストからスキルを特定する：

• スキル呼び出しメッセージを探す
• 最近参照された SKILL.md を確認
• 現在のタスクコンテキストを検証

SKILL_NAME=[skill-name] と SKILL_DIR=./skills/$SKILL_NAME を設定

不明な場合はユーザーに確認する。 </step_1>

<step_2 name="reflection_and_analysis"> 提供された $ARGUMENTS に焦点を当てる。なければ、より広いコンテキストを分析する。

以下を判定する：

• 何が間違っていたか: SKILL.md から誤りのある特定のセクションを引用
• 発見方法: コンテキスト、エラーメッセージ、試行錯誤、ドキュメント調査
• 根本原因: 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-name]
**発見された問題:** [1～2文の要約]
**根本原因:** [簡潔な説明]

**修正するファイル:**
- [ ] SKILL.md
- [ ] references/[file].md
- [ ] scripts/[file].py

**提案される変更:**

### 変更 1: SKILL.md - [セクション名]
**位置:** SKILL.md の行 [X]

**現在（誤り）:**

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

**修正後:**

[新しいテキスト]

**理由:** [この修正が問題を解決する理由]

[すべてのファイルの各変更について繰り返す]

**影響評価:**
- 影響: [認証/API エンドポイント/パラメータ/例など]

**検証:**
これらの変更は以下を防ぎます： [この修正をもたらした具体的なエラー]

</step_4>

<step_5 name="request_approval">

これらの変更を適用しますか？

1. はい、すべての変更を適用してコミットする
2. 適用するがコミットしない（先に確認したい）
3. 変更を修正する（フィードバックを提供します）
4. キャンセル（変更しない）

選択してください (1-4):

ユーザーの応答を待つ。承認なしに進めないこと。 </step_5>

<step_6 name="apply_changes"> 承認後のみ実行（オプション 1 または 2）：

1. Edit ツールを使用してすべてのファイル全体の各修正を適用
2. 修正されたセクションを読み戻して検証
3. オプション 1 の場合、修正内容を示す構造化メッセージでコミット
4. ファイルリストで完了を確認 </step_6> </process>

<success_criteria>

• スキルが会話コンテキストから正しく検出される
• すべての誤りのあるセクションが修正前後で特定される
• ユーザーが適用前に変更を承認する
• すべての編集が SKILL.md および関連ファイル全体に適用される
• 変更が読み戻すことで検証される
• ユーザーがオプション 1 を選択した場合、git コミットが作成される
• 完了がファイルリストで確認される </success_criteria>

<verification> 完了前に確認：

• 修正されたセクションを読み戻して変更が適用されたことを確認
• クロスファイル整合性を確認（SKILL.md の例が references/ と一致）
• オプション 1 が選択された場合、git コミットが作成されたことを確認
• 意図しないファイルが修正されていないことを確認

</verification>