SuperAPI AI 工具集

windows-protocols

通用与其它

查看项目

更新于 10-16 10:33

技能介绍

Windows 协议语料库导航器

概述

  • 语料库已提取至 SKILL.md 旁。
  • 仅使用本地文件;不要使用网络查询、下载或安装命令。

语料库布局

  • README.md — 顶层索引。从 Overview 文档开始进行主题发现。
  • LEGAL.md — 法律与再分发声明。
  • <PROTOCOL-ID>/ — 协议目录。
  • <PROTOCOL-ID>/<PROTOCOL-ID>.md — 主要 markdown 规范内容。
  • <PROTOCOL-ID>/media/ — markdown 引用的提取图片和图像资源。

当问题较宽泛时,从 Overview 文档或协议族(如 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. 歧义缩写:列出 2–4 个可能的协议(通过 Overview 文档),在深入分析前请用户选择。
  4. 在深入阅读前扫描规范 TOC(<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。
  • 对于非显而易见、有争议或安全敏感的断言,包含基于章节的证据。
  • 对于直接事实,简洁的章节引用即可。
  • 如果两个规范不一致,报告两者并指出可能的版本或上下文范围。
  • 明确说明不确定性,绝不将推断行为当作规范性要求文本。