关于 windows-protocols
windows-protocols 是用于查阅 Microsoft Open Specifications Windows 协议本地语料的导航技能,指导从主题概览定位协议规范、章节及相关文档,并要求区分确认事实与不确定内容。
主要功能
- 01通过概览文档导航主题
- 02验证已知协议 ID
- 03要求澄清含义不明的缩写
- 04追踪关联及引用的规范
- 05依据准确章节组织答案
- 06区分已确认事实与推断
适用场景
- 01查找 Windows 协议主题相关规范
- 02查询已知协议 ID
- 03确认含义不明的协议缩写
- 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。
导航工作流
对所有查询使用以下统一工作流:
- 主题类问题:确定领域,打开
README.md中匹配的 Overview 文档,并沿其成员规范链接查找。- 反面模式:不要只依赖 README 关键词搜索;Overview 文档提供权威的主题到协议映射。
- 已知协议 ID:根据
README.md和目录名称(<PROTOCOL-ID>/)验证,然后直接打开规范。- 如果找不到该协议,请说明并询问准确的协议 ID 或更具体的范围。
- 含义不明确的缩写:通过 Overview 文档列出 2–4 个可能的协议,并请用户在深入分析前选择。
- 深入阅读前,先扫描规范目录(
<summary>块和编号条目)。 - 按以下顺序阅读各节:概述/版本控制 → 语法 → 行为/时序 → 安全/产品行为。
- 如果要求分散在基础规范和扩展规范中,请交叉核对,并视需要跟进交叉引用链接。
- 回答时明确列出协议 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) 来表明支持,并将版本相关注意事项列入不确定性或产品行为说明。
回答约定
默认回答结构:
Protocols consulted:列出准确的 ID。Sections used:列出准确的章节标题(以及可用时的章节编号)。Findings:结合这些章节给出简明事实。Inference / uncertainty:明确区分已确认内容与推断。
指南:
- 优先提供有章节依据的回答,并包含准确的协议 ID。
- 对不明显、有争议或涉及安全的主张,提供有章节依据的证据。
- 对简单事实,简要注明相关章节即可。
- 如果两份规范存在分歧,请同时报告,并指出可能适用的版本或上下文范围。
- 明确说明不确定之处,绝不要将推断行为表述为规范性要求。
评论
支持 Markdown