GitHub からのスキル作成

ユーザーが何かを達成したいと考えている場合、その問題を解決する高品質な GitHub プロジェクトを検索し、深く理解した上で、その知識に基づいてスキルを作成します。

使用時機

ユーザーがタスクを説明し、既存のツール/プロジェクトから学びたい場合:

• 「Markdown を PDF に変換したい」
• 「顧客レビューの感情分析を手伝ってほしい」
• 「コードから API ドキュメントを生成する必要がある」

ワークフロー

ステップ 1: ユーザーの意図を理解する

ユーザーが何を達成したいのかを明確にします:

• 入力は何か?
• 期待される出力は?
• 制約事項(言語、フレームワークなど)?

ステップ 2: GitHub を検索

この問題を解決するプロジェクトを検索します:

{task keywords} language:{preferred} stars:>100 sort:stars

検索のヒント:

• 広く始めて、絞り込む
• 異なるキーワードの組み合わせを試す
• 関連する場合は「cli」「tool」「library」を含める

品質フィルター(すべて満たす必要があります):

• Stars > 100 (コミュニティで検証済み)
• 過去 12 ヶ月以内に更新(積極的にメンテナンス中)
• 明確なドキュメントを備えた README を所有
• 実際のコード(awesome-list だけではない)

ステップ 3: ユーザーにオプションを提示

上位 3 〜 5 の候補を表示します:

## この問題を解決できる X 個のプロジェクトが見つかりました

### オプション 1: [project-name](github-url)
- Stars: xxx | 最終更新: xxx
- 内容: 1 行の説明
- 良い理由: 具体的な強み

### オプション 2: ...

どれを深掘りするべき? または別の方法で検索する?

先に進む前にユーザーの確認を待ってください。

ステップ 4: 選択されたプロジェクトを深く調べる

ユーザーがプロジェクトを選択したら、徹底的に理解します:

1. README を読む - 目的、機能、使用方法を理解
2. コアソースファイルを読む - どのように機能するかを理解
3. 例を確認 - 実際の使用パターンを確認
4. 依存関係をメモ - 何に依存しているか
5. 重要な概念を特定 - その背後にあるメンタルモデル

以下を抽出します:

• コアアルゴリズム/アプローチ
• 入出力形式
• エラーハンドリングパターン
• コードに組み込まれたベストプラクティス

ステップ 5: 理解を要約

学んだことをユーザーに提示します:

## [project-name] の理解

### コアアプローチ
問題の解決方法...

### 主要技術
1. ...
2. ...

### 制限事項
- ...

### スキルに組み込む内容
- ...

これで大丈夫? スキル作成に進める?

ユーザーの確認を待ってください。

ステップ 6: skill-creator でスキルを作成

以下の情報を skill-creator に引き継ぎます:

1. 明確な目的 - スキルが何をするか
2. 方法論 - プロジェクトから学んだアプローチ
3. ステップバイステップのプロセス - 具体的な指示
4. 品質基準 - 良い出力とは何か
5. よくある落とし穴 - 避けるべきこと(プロジェクトの issues/ドキュメントから学習)

重要: スキルはプロジェクトの知識をエンコードする必要があり、単にツールをラップするだけではありません。スキルは元のプロジェクトがインストールされなくても機能する必要があります。

例

ユーザー: 「より良いコミットメッセージを書きたい」

ステップ 2 - 検索:

commit message convention stars:>100 sort:stars

ステップ 3 - 提示:

## 4 つのプロジェクトが見つかりました

### オプション 1: conventional-commits/conventionalcommits.org (4.2k ⭐)
- 人間と機械が読み取り可能なコミットメッセージの仕様
- 理由: 業界標準、Angular、Vue など多くのプロジェクトで使用

### オプション 2: commitizen/cz-cli (15k ⭐)
- 従来型のコミットを作成するための CLI ツール
- 理由: 本番環境で検証済み、多くのアダプタを搭載

### オプション 3: carloscuesta/gitmoji (14k ⭐)
- コミットメッセージの絵文字ガイド
- 理由: ビジュアル、楽しいアプローチ

どれに興味がある?

ユーザー: 「従来型のコミットで行こう」

ステップ 4 - 深掘り:

• 仕様を読む
• タイプ(feat、fix、docs など)を理解
• スコープ、破壊的変更について学習
• 実際の例を研究

ステップ 5 - 要約:

## 従来型コミットの理解

### コアアプローチ
構造化フォーマット: <type>(<scope>): <description>

### 主要タイプ
- feat: 新機能
- fix: バグ修正
- docs: ドキュメント
- ...

### 学んだ利点
- 自動化されたチェンジログ生成
- セマンティックバージョニング
- 明確な履歴

このベースでコミットメッセージスキルを作成する準備ができた?

ステップ 6 - これらの原則をエンコードしてスキルを作成

重要な注記

1. 常にユーザーの確認を取る - ステップ 3(プロジェクト選択)とステップ 5(作成前)で
2. ラップするより学習を優先 - ツールを「実行する」だけでなく、知識をエンコード
3. ライセンスを確認 - プロジェクトに制限的なライセンスがある場合は記載
4. ソースに言及 - 生成されたスキルに帰属表示を含める
5. 速度より品質 - プロジェクトを真に理解する時間をかける

このスキルではないもの

• パッケージインストーラではない
• ツールラッパーではない
• これは最高のプロジェクトから学び、その知識を再利用可能なスキルにエンコードすることです