mcpField
W
windows-protocols

windows-protocols

github.com/awakecoding開発5268 回インストール2 日前に更新
リポジトリ

windows-protocols について

windows-protocols は、Microsoft Open Specifications の Windows プロトコルに関するローカルコーパスを調べるナビゲーションスキルです。トピック概要から仕様書や関連文書へ案内し、確認済みの事実と不確実性を分けて回答するよう定めています。

主な機能

  1. 01概要文書からトピックを検索
  2. 02既知のプロトコル ID を検証
  3. 03曖昧な略語の確認を促す
  4. 04関連仕様書や参照先を追跡
  5. 05正確なセクションに基づく回答
  6. 06確認済みの事実と推論を区別

活用シーン

  1. 01Windows プロトコルのトピックに関する仕様書探し
  2. 02既知のプロトコル ID の調査
  3. 03曖昧なプロトコル略語の確認
  4. 04基本仕様と拡張仕様の動作の照合

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/awakecoding/openspecs --skill windows-protocols

インストール後、Claude Code で/windows-protocolsを入力して読み込まれたか確認します。

詳細

Windows Protocols Corpus Navigator

概要

  • コーパスはすでに SKILL.md の隣に展開されています。
  • ローカルファイルのみを使用してください。ネットワーク検索、ダウンロード、セットアップコマンドは使用しないでください。

コーパスの構成

  • README.md — 最上位のインデックスです。トピックを探すには、Overview Documents から始めてください。
  • LEGAL.md — 法的事項および再配布に関する通知です。
  • <PROTOCOL-ID>/ — プロトコルのディレクトリです。
  • <PROTOCOL-ID>/<PROTOCOL-ID>.md — 主要な Markdown 仕様の内容です。
  • <PROTOCOL-ID>/media/ — Markdown から参照される図や画像アセットを展開したものです。

質問の範囲が広い場合は、Overview Documents、または MS-RDP*、MS-AD*、MS-MQ* などのプロトコルファミリーから始めてください。

参照ファイル

  • 標準のワークフロー、実例、回答の要件については SKILL.md を使用してください。
  • REFERENCE.md を開くのは、Domain Clusters、Canonical Spec Structure、Section-First Routing の参照資料を確認する場合に限ってください。

ナビゲーションのワークフロー

すべての質問に、次の統一ワークフローを使用してください。

  1. トピックに関する質問:ドメインを特定し、README.md から該当する Overview ドキュメントを開いて、そこに記載された仕様へのリンクをたどります。
    • アンチパターン:README のキーワード検索だけに頼らないでください。Overview ドキュメントには、トピックとプロトコルの正式な対応関係が示されています。
  2. 既知のプロトコル ID:README.md とディレクトリ名(<PROTOCOL-ID>/)で検証し、仕様を直接開きます。
    • プロトコルが見つからない場合は、その旨を伝え、正確なプロトコル ID またはより限定された範囲を尋ねてください。
  3. 曖昧な略語:Overview ドキュメントを使って有力なプロトコルを 2~4 件挙げ、詳細な分析に進む前にユーザーに選んでもらいます。
  4. 詳細を読み込む前に、仕様の目次(<summary> ブロックと番号付き項目)を確認します。
  5. 次の順序でセクションを読みます:概要/バージョン管理 → 構文 → 動作/シーケンス → セキュリティ/製品の動作。
  6. 要件が分割されている場合は、必要に応じて相互参照リンクをたどり、基本仕様と拡張仕様を相互に確認します。
  7. プロトコル ID と正確なセクション見出しを明示して回答し、確認済みの事実と推論を分けます。
リンクをたどる
  • パスを推測するのではなく、Overview ドキュメント内の参照とインラインリンクをたどってください。
  • Overview → 仕様 → 関連仕様の順を、想定された経路として扱ってください。
  • 仕様が型、拡張、依存関係について別の仕様を参照している場合は、そのリンクをたどって正式な情報源を確認してください。
  • 最初に言及された箇所だけで終わらず、質問への回答となる正式なセクションに到達するまでリンクをたどってください。

実例

ユーザーの質問:「SMB2 では、サーバーは永続ハンドルをサポートしていることをどのように通知しますか?」

経路:File Access Overview → MS-SMB2 → 2.2.4 NEGOTIATE Response → 3.3.5.4 Receiving an SMB2 NEGOTIATE Request

回答:MS-SMB2 を引用し、サーバーは NEGOTIATE Response の Capabilities フィールドに SMB2_GLOBAL_CAP_PERSISTENT_HANDLES (0x00000010) を設定してサポートを通知する、と記載します。バージョン固有の注意点は、不確実性または製品の動作に関する注記に記載してください。

回答の要件

標準的な回答形式:

  1. 参照したプロトコル:正確な ID を列挙します。
  2. 使用したセクション:正確なセクションタイトル(および可能な場合は番号)を列挙します。
  3. 調査結果:該当するセクションに基づく簡潔な事実を示します。
  4. 推論/不確実性:確認済みの記述と明確に分けます。

指針:

  • セクションに根拠を置いた回答を優先し、正確なプロトコル ID を含めてください。
  • 自明でない主張、見解が分かれる主張、またはセキュリティ上重要な主張には、セクションに基づく根拠を含めてください。
  • 単純な事実については、簡潔なセクション参照で十分です。
  • 2 つの仕様の記述が異なる場合は、両方を報告し、想定されるバージョンまたは適用範囲を示してください。
  • 不確実性を明示し、推論した動作を規範的な要件の記述として決して提示しないでください。

コメント