skill-forge

skill-forge

スキルのためのスキル、それがスキルです。新しいスキルを構築し、既存のスキルを改善し、次に何を構築すべきかをチャットのトランスクリプトから掘り起こします。

呼び出しタイミング

3 つのモードがあります。ユーザーの発言に応じて選んでください。

モード	トリガー	動作
forge	「X を行うものを skill-forge して」「...するスキルを forge して」「...のためのスキルを構築して」	2〜3 個の明確化質問をし、テンプレートから ~/.claude/skills/<name>/SKILL.md をスキャフォールドし、mphinance/alpha-skills へ PR を開きます。
audit	「skill-forge audit」「skill audit」「/skill-forge」「どのスキルを構築すべきか」	~/.claude/projects/**/*.jsonl に対してマイナーを実行し、reports/latest.md を提示し、どの候補を forge または refine するかを尋ねます。
refine	「自分のスキルを refine して」「skill-forge refine 」「 スキルを改善して」	既存のスキルに対して追加のみの変更（新しいトリガーフレーズ、新しい例、新しいセクション）を提案します。差分付きで PR を開きます。

フロー

forge モード

1. ユーザーに最大 2〜3 個の質問をします: スキル名（ケバブケース）、一文での目的、主要なトリガーフレーズ。過度に聞き込みしないでください。
2. スキャフォールダーを実行します。

   python scripts/forge_new.py --name <name> --brief "<one-sentence purpose>"
   

   スキャフォールダーは templates/SKILL.md.tmpl を読み込み、{{name}}、{{description}}、{{title}}、{{when_to_invoke}}、{{flow}}、{{hard_rules}} を置換します。
3. 書き出されたばかりの ~/.claude/skills/<name>/SKILL.md を開きます。ユーザーとレビューします。必要なら文言を引き締めます。
4. 公開します。

   python scripts/publish.py <name>
   

   これは存在しなければ mphinance/alpha-skills を ~/.cache/skill-forge/alpha-skills にクローンし、skill-forge/<name>-<short-ts> をブランチし、コミットし、プッシュし、PR を開きます。PR の URL を出力します。そこで止めてください。 ユーザーがレビューしてマージします。

audit モード

1. マイナーを実行します。

   python scripts/mine_chats.py --days 30
   

2. reports/latest.md（markdown レポート）と reports/latest.json（構造化された候補）を読み上げます。
3. 3 つのセクションを提示します: 新規スキル候補、改善候補、ペインポイント。どれに対応するかを尋ねます。
4. 選ばれた新規スキル候補ごとに、publish.py --from-audit を付けて forge モード に移行し、PR 本文が掘り起こした根拠を引用するようにします。
5. 選ばれた改善候補ごとに、refine モード に移行します。

refine モード

1. 対象スキルの既存の SKILL.md を全文読みます。何も削除したり再構成したりしてはいけません。
2. 追加のみを提案します: frontmatter の description に新しいトリガーフレーズ、新しい例、新しい「使用しない場合」の箇条書き、新しいフローステップ。
3. 最初に提案された変更を proposals/<skill-name>/CHANGES.diff に書き出します。ユーザーに確認します。
4. ~/.claude/skills/<skill-name>/SKILL.md に追加的な編集を適用します。
5. 公開します。

   python scripts/publish.py <skill-name>
   

   コミットメッセージは「Refine skill: 」で始まります。PR 本文は追加内容を説明し、掘り起こした根拠をリンクします。

厳格なルール

• PR を自動マージしないこと。 publish.py は PR を開きます。ユーザーがマージします。gh pr merge は決して使いません。
• refine モードで既存のスキルを再構成しないこと。 追加のみです。スキルが書き直しを必要とするなら、それは refine ではなく新しい forge です。
• 改善は追加のみです。 純粋な空白以外で削除される行はありません。publish.py は refine モードでこれを強制します。
• skill-forge 自身のセッションを再帰的にマイニングしないこと。 マイナーはすでに自己参照をフィルタリングします。無効にしないでください。
• SSH トランスクリプトをスキップすること。 ssh- で始まるプロジェクトパス、または /home/ 配下の cwd はリモート作業であり、マイニングされません。
• em ダッシュを使わないこと。 スペース付きの en ダッシュかカンマを使ってください。forge されたスキルに絵文字は使いません。
• stdlib のみ。 forge されたスキルと skill-forge スクリプトは Python stdlib を使い、pip インストールは行いません。
• 常に PR を経由すること。 ~/.cache/skill-forge/alpha-skills/skills/ 内のファイルを直接編集しないでください。

スケジューリング

監査は cron に載せたい部分です。2 つの選択肢があります。

• 推奨 – /schedule スキルを使用します。

  /schedule weekly /skill-forge audit
  

  監査を毎週実行し、reports/latest.md を書き込み、次のセッションで通知します。

• 無料枠向けの代替案（miner 単体）。 Windows タスクスケジューラで、週次トリガーに python C:\Users\mphan\.claude\skills\skill-forge\scripts\mine_chats.py --days 7 を実行するように設定します。トークン消費はゼロです。好きなタイミングで reports/latest.md を読み、その後に対話形式で skill-forge audit を呼び出して候補に対応します。

forge モードと refine モードは、設計上対話形式です。これらをスケジュールしないでください。

対象外

• PR の自動マージ。マージは常にユーザーが行います。
• refine モード中に ~/.claude/skills/ 内のスキルを直接編集すること。常に mphinance/alpha-skills に対する PR を経由してください。
• このマシン以外のマシンからトランスクリプトを mining すること。
• 非 Markdown のスキル（バイナリプラグイン、MCP サーバー、SKILL.md と任意のスクリプト以外のもの）を forge すること。
• 既存のスキルを書き換えたり再構成したりすること。改良は追加のみです。