capture-skill

会話からスキルをキャプチャする

現在の会話から知識、パターン、ワークフローを抽出し、再利用可能なスキルとして保存します。

使用するタイミング

• ユーザーが「これをスキルとしてキャプチャして」または「次回のために保存して」と言ったとき
• 会話の中で役立つワークフロー、パターン、ドメイン知識が明らかになったとき
• ユーザーが既存のスキルを新たな学びで更新したいとき
• 会話を通じて、保存する価値のある自明でない手順、注意点、ベストプラクティスが明らかになったとき

キャプチャの手順

フェーズ 1：キャプチャする内容を特定する

次の項目について会話を確認します。

1. ワークフロー：試行錯誤を通じて確立した複数ステップのプロセス
2. ドメイン知識：明らかになった、自明でない事実、設定、制約
3. 注意点と解決策：発生した問題とその解決方法
4. パターン：うまくいったコードパターン、コマンドの並び、テンプレート
5. 判断の根拠：ほかの選択肢ではなく、特定のアプローチを選んだ理由

キャプチャする内容を要約し、作業を進める前にユーザーに確認します。

フェーズ 2：保存先を決める

ユーザーがスキルをすでに指定している場合、または会話の文脈から保存先が明らかな場合は、そのまま進めます。それ以外の場合は、次の点を確認します。

1. 新規または既存のスキル？
   • 既存の場合：更新するスキルはどれですか？（~/.cursor/skills/ と .cursor/skills/ から関連するスキルを一覧表示します）
   • 新規の場合：どのような名前にしますか？
2. 保存場所（新しいスキルの場合）：
   • 個人用（~/.cursor/skills/）—すべてのプロジェクトで利用可能
   • プロジェクト用（.cursor/skills/）—リポジトリで共有

フェーズ 3：スキルの内容を作成する

新しいスキルにキャプチャする場合：

1. 内容がわかる名前を付けます（小文字、ハイフン区切り、64 文字以内）
2. WHAT と WHEN を含む具体的な説明を三人称で書きます
3. 会話の内容を簡潔で実行可能な手順にまとめます
4. 会話から得た具体例を含めます
5. 使用したユーティリティスクリプトやコマンドを追加します

既存のスキルを更新する場合：

1. 既存の SKILL.md を読みます
2. 新しい知見を追加する場所を特定します（新しいセクション、手順の更新、追加の例など）
3. 既存の内容と重複しないように統合します
4. 既存の構成と文体を維持します

フェーズ 4：要点をまとめる際の指針

まとまりのない会話を、簡潔で再利用可能な手順に変換します。

すること：

• 失敗した試みではなく、最終的にうまくいった方法を抽出します（注意点として役立つ場合を除く）
• 具体例から一般化します（ハードコードされた値をプレースホルダーに置き換えます）
• 自明でない手順の理由を含めます
• 会話がなければエージェントにはわからない背景を補います
• 500 行以内に収めます

しないこと：

• 会話の名残（「先ほど話したとおり」「あなたが言ったように」など）を含めません
• エージェントがすでに知っている情報を繰り返しません
• ほかの状況に応用できないほど具体的な詳細を含めません
• コード例で十分な場合に、冗長な説明を加えません

フェーズ 5：書き込みと検証

1. スキルファイルを作成または更新します
2. SKILL.md が 500 行以内であることを確認します
3. 説明が具体的で、トリガーとなる用語を含んでいることを確認します
4. キャプチャした内容が正確であることをユーザーに確認します

例：デバッグのワークフローをキャプチャする

会話で難しいデプロイの問題をデバッグした場合、キャプチャするスキルは次のようになります。

---
name: debug-k8s-deployments
description: Debug Kubernetes deployment failures including CrashLoopBackOff, image pull errors, and resource limits. Use when pods are failing to start or deployments are stuck.
---

# Debug K8s Deployments

## Diagnostic Steps

1. Check pod status: `kubectl get pods -n <namespace> | grep -v Running`
2. Get events: `kubectl describe pod <pod> -n <namespace>`
3. Check logs: `kubectl logs <pod> -n <namespace> --previous`

## Common Issues

### CrashLoopBackOff

- Check if the entrypoint command exists in the container
- Verify environment variables are set (especially secrets)
- Look for OOMKilled in `describe` output → increase memory limits

### ImagePullBackOff

- Verify image tag exists: `docker manifest inspect <image>`
- Check imagePullSecrets are configured for private registries

この例では、会話の名残を含めずに、診断の手順とよくある解決方法をまとめています。

例外的なケースへの対応

会話に複数のトピックが含まれていた場合：どの学びをキャプチャするか尋ねるか、トピックごとに個別のスキルを作成することを提案します。

スキルにするには学びが少なすぎる場合：代わりにルールを使用します（.cursor/rules/、.claude/rules/ など）。目安：単一の行動指針やコーディング規約ならルール、複数ステップのワークフローや関連リソースをまとめる必要があるならスキルです。

既存のスキルを大幅に書き直す必要がある場合：既存のスキルを再構成するか、それに置き換わる新しいスキルを作成するかをユーザーに確認します。