PAIUpgrade

カスタマイズ

実行前に、次の場所にユーザー設定があるか確認してください： ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/PAIUpgrade/

このディレクトリが存在する場合は、そこにある PREFERENCES.md、設定、リソースを読み込み、適用してください。これらはデフォルトの動作より優先されます。ディレクトリが存在しない場合は、スキルのデフォルト設定で進めてください。

🚨 必須：音声通知（あらゆる操作の前に必須）

このスキルが呼び出されたら、ほかのことを行う前に、必ずこの通知を送信してください。

1. 音声通知を送信：

   curl -s -X POST http://localhost:31337/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow in the PAIUpgrade skill to ACTION"}' \
     > /dev/null 2>&1 &
   

2. テキスト通知を出力：

   Running the **WorkflowName** workflow in the **PAIUpgrade** skill to ACTION...
   

PAIUpgrade

主な目的： ユーザーのコンテキストを理解し、エコシステムの新着情報を発見することで、PAI の優先順位付きアップグレード推奨を生成します。

このスキルは、並行して実行される4 つのエージェントスレッドを使い、個別の推奨事項をまとめます。

• スレッド 0 — 先行作業の監査（Algorithm、PATTERNS.yaml、フック、スキル、最近の ISA、KNOWLEDGE、フィードバックメモリ）
• スレッド 1 — ユーザーコンテキスト（TELOS、プロジェクト、最近の作業、PAI の状態）
• スレッド 2 — 情報源の収集（Anthropic、YouTube、カスタムソース、GitHub のトレンド）
• スレッド 3 — 内部の振り返り（algorithm-reflections.jsonl）

スレッド 0 は、すでに実装済み、調査済みで見送られた、またはすでに採用しないと決定された内容を推奨しないためのガードレールです。 統合時には、候補となるすべての推奨事項をスレッド 0 の状態一覧と照合して絞り込む必要があります。Prior Status を割り当てずに推奨事項を出力してはいけません。

ワークフローの振り分け

ワークフロー	トリガー	ファイル
Upgrade	"check for upgrades"、"check sources"、"any updates"、"check Anthropic"、"check YouTube"、"upgrade"、"pai upgrade"	Workflows/Upgrade.md
MineReflections	"mine reflections"、"check reflections"、"what have we learned"、"internal improvements"、"reflection insights"	Workflows/MineReflections.md
AlgorithmUpgrade	"algorithm upgrade"、"upgrade algorithm"、"improve the algorithm"、"algorithm improvements"、"fix the algorithm"	Workflows/AlgorithmUpgrade.md
ResearchUpgrade	"research this upgrade"、"deep dive on [feature]"、"further research"	Workflows/ResearchUpgrade.md
FindSources	"find upgrade sources"、"find new sources"、"discover channels"	Workflows/FindSources.md
TwitterBookmarks	"check bookmarks"、"scan bookmarks"、"twitter bookmarks"、"X bookmarks"、"bookmarks for upgrades"、"what have I bookmarked"	Workflows/TwitterBookmarks.md

デフォルトのワークフロー： ユーザーが具体的な指定をせずに "upgrade" または "check for upgrades" と言った場合は、Upgrade ワークフローを実行します（スレッド 3 の振り返りのマイニングを含みます）。

出力形式

正式な仕様： References/OutputFormat.md — セクションの順序、Prior Status の凡例、表の列、厳守事項を定めた唯一の正本です。このスキルと Workflows/Upgrade.md は、それぞれの内容を個別に記載するのではなく、このファイルを参照します。

セクションの順序：Discoveries → Recommendations → Technique Details → Internal Reflections → Summary → Skipped → Sources Processed。

空でない推奨ティアのみを出力してください（空の 🟡 MEDIUM 見出しは出力しません）。

抽出ルール

要約せず、抽出してください。テクニックであり、推奨事項ではありません。推奨する前に、既存の状態を確認してください。

1. 出力するすべての項目はテクニックです — 具体的なパターン、コードスニペット、設定、またはアプローチを記載します。
2. 実際の内容を引用またはコードブロックにします — 実際に述べられた、または記述された内容をそのまま示します。
3. PAI コンポーネントに紐づけます — すべてのテクニックを、特定のファイル、スキル、ワークフロー、またはシステムコンポーネントに結び付けます。
4. 既存状態の確認（Thread 0 ゲート） — 推奨事項を出力する前に、Thread 0 のインベントリと照合します。Algorithm / PATTERNS.yaml / hooks / SKILL ファイル / KNOWLEDGE / 過去の ISA にすでに存在するか確認し、根拠を引用したうえで Prior Status の絵文字を割り当てます。✅ DONE の項目は Recommendations ではなく、Skipped に記載します。
5. 必須の説明フィールドは 2 つ。各 2 文以内で、具体的に記述します。
   • What It Is: テクニックそのもの — 何をするのか、どのように機能するのか、どのような機能を提供するのか
   • How It Helps PAI: 具体的な利点 — どのコンポーネントが改善され、どのギャップを埋めるのか
6. 実装を示します — 変更前と変更後のコード、または具体的な手順を提示します。
7. 内容を薄めず、スキップします — 抽出可能なテクニックがない場合は、その理由とともに Skipped Content に記載します。

ソースタイプのラベル：

ラベル	意味
GitHub: claude-code vX.Y.Z	特定バージョンのリリースノート
YouTube: Creator @ MM:SS	タイムスタンプ付き動画
Docs: Section Name	ドキュメントのセクション
Blog: Post Title	ブログ記事

設定

スキルファイル：

• sources.json — Anthropic ソース設定（30 件以上のソース）
• youtube-channels.json — ベースの YouTube チャンネル（デフォルトでは空）
• State/last-check.json — Anthropic の状態
• State/youtube-videos.json — YouTube の状態
• State/github-trending.json — GitHub トレンドの状態（確認済みリポジトリ）
• State/twitter-bookmarks-seen.json — 以前に処理したブックマーク URL

ユーザーによるカスタマイズ（~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/PAIUpgrade/）：

• EXTEND.yaml — 拡張マニフェスト
• youtube-channels.json — ユーザー個人の YouTube チャンネル
• user-sources.json — 追加のソース定義（例：github_trending ブロック）

ツールのリファレンス

ツール	用途
Tools/Anthropic.ts	30 件以上の Anthropic ソース（ブログ、GitHub リポジトリ、変更履歴、ドキュメント）の更新を確認

主な原則

1. 要約せず、抽出する — ソースへのリンクだけで済ませず、具体的なテクニックを抽出します。
2. ソースを引用する — 実際のコード、ドキュメントからの引用、または文字起こしの抜粋を示します。
3. PAI の文脈に結び付ける — すべてのテクニックを、特定の PAI ファイル、スキル、またはコンポーネントに紐づけます。
4. 「なぜあなたに役立つか」を説明する — 「これは、あなたの [X] が現在 [Y] であるため役立ちます」のように説明します。
5. TELOS に結び付ける — 関連性を説明する際は、ユーザーの目標や課題に触れます。
6. ためらわずにスキップする — 抽出可能なテクニックがない場合は、すべてスキップします。
7. すぐに実装できる形にする — 曖昧な推奨事項ではなく、実際のコード変更を提示します。
8. claude-code-guide で Claude Code の最新情報を確認する — 発見した内容が Claude Code の内部仕様（hooks、settings、slash commands、MCP、agent types、keybindings、Agent SDK、Claude API）に関わる場合は、Agent(subagent_type="claude-code-guide") を起動し、PAI の現在の参照情報が最新の API 仕様に対応しているか確認します。

アンチパターン（出力してはいけないもの）

以下の出力パターンは失敗です。

❌ 悪い出力	問題点	✅ 正しい出力
"Check out R Amjad's video on Claude Code"	内容を抽出せず、コンテンツを紹介している	"@ 5:42, R Amjad shows this technique: [quote]"
"v2.1.16 has task management improvements"	曖昧な要約で、具体的な手法がない	"v2.1.16 adds addBlockedBy parameter: [code example]"
"Consider looking into MCP updates"	抽出せずに推奨している	"MCP now supports [specific feature]: [docs quote]"
"This could be useful for your workflows"	関連性が曖昧	"This improves your Browser skill because [specific gap it fills]"
"Several videos covered AI agents"	内容を示さず、数だけを挙げている	"[N] videos skipped — no extractable techniques"
"This helps because it improves things"	メリットが曖昧	"How It Helps PAI: SecurityValidator currently only blocks commands. additionalContext enables reasoning context before tool execution, making decisions more nuanced."
"A new hook feature"	それが何なのか説明していない	"What It Is: PreToolUse hooks can return additionalContext that gets injected into the model's context before execution, enabling reasoning-based decisions rather than binary blocks."
"Top 3 Actions" または優先度のない推奨リスト	優先度の段階がない	🔴／🟠／🟡／🟢の段階と、それぞれにPAI Relevance列があるRecommendationsセクション
Recommendationsを末尾に置く	実行可能な項目が手法の説明の後ろに埋もれている	🔥 Recommendationsセクションを2番目に置き、手法の詳細を3番目に置く
すでに実装済みのものを推奨する	ユーザーの信頼を損なう	ファイルと行番号の根拠を添えてSkippedに移す
新たな情報なしに却下された案を再提示する	過去の決定から逸脱している	理由が変わった場合に限り、再度推奨する。何が変わったかを明記する
Prior Status列がない	Thread 0のゲートを迂回している	すべての推奨項目の行に、Thread 0のインベントリからの根拠を記載する

判定基準：「手法を見せて」と言われても、見せるものが何もないなら失敗です。

ワークフロー

• Upgrade.md — 主要なワークフロー。優先順位付きの推奨を含む、4つのスレッドによる完全な分析
• MineReflections.md — Thread 3の単独実行（内省の詳細なマイニング）
• AlgorithmUpgrade.md — アルゴリズムのバージョン更新に特化したアップグレードフロー
• ResearchUpgrade.md — 特定のアップグレード機会の詳細な調査
• FindSources.md — 監視対象となる新しいソースの発見と評価

注意点

• すべてのソースを並行して確認してください — Anthropicのブログ、変更履歴、YouTubeチャンネル、GitHubのリリースを確認します。順番に確認しないでください。
• アップグレードによって既存のスキルやワークフローを壊してはいけません。 適用前に後方互換性を検証してください。
• アップグレードの完全な確認には5～7分かかる場合があります。 外側のエージェントにはrun_in_background: trueを使用してください。

実行ログ

ワークフローの完了後、JSONLエントリを1件追記します。

echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","skill":"PAIUpgrade","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/PAI/MEMORY/SKILLS/execution.jsonl

WORKFLOW_USEDを実行したワークフローに、8_WORD_SUMMARYを入力の簡潔な説明に、SECONDSを概算の実時間に置き換えます。ワークフローが失敗した場合は、status: "error"を記録します。