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. 01查找 Windows 协议主题相关规范
  2. 02查询已知协议 ID
  3. 03确认含义不明的协议缩写
  4. 04核对基础规范与扩展规范中的行为

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/windows-protocols确认已加载。

详细介绍

Windows 协议语料导航器

概述

  • 语料已解压到 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. Protocols consulted:列出准确的 ID。
  2. Sections used:列出准确的章节标题(以及可用时的章节编号)。
  3. Findings:结合这些章节给出简明事实。
  4. Inference / uncertainty:明确区分已确认内容与推断。

指南:

  • 优先提供有章节依据的回答,并包含准确的协议 ID。
  • 对不明显、有争议或涉及安全的主张,提供有章节依据的证据。
  • 对简单事实,简要注明相关章节即可。
  • 如果两份规范存在分歧,请同时报告,并指出可能适用的版本或上下文范围。
  • 明确说明不确定之处,绝不要将推断行为表述为规范性要求。

评论

支持 Markdown