azuresql-db-feedback

报告技能或容器的问题

用户不应该需要手动整理 Bug 报告。生成一份优质报告所需的信息你都已经掌握：你正在使用的技能、它告诉你要做什么、你实际不得不做什么、镜像标签、主机、运行时、失败的命令以及错误。你的任务是将这些信息整理成完整的报告，交给用户提交。

存储库： microsoft/azure-sql-database-container（容器和技能都在这里）。

此技能中的说法针对的是 microsoft/azure-sql-database-container 中的问题表单，而非引擎，因此不适用于引擎测量。已于 2026-09-05 验证：aka.ms/sql-agent-skills-feedback 仍会将请求重定向（301）到 https://github.com/microsoft/azure-sql-database-container/issues/new?template=skill_feedback.yml，并丢弃查询字符串。这正是预填报告必须使用完整 github.com URL 的原因。字段 ID、标签和下拉选项均取自此存储库中的问题表单定义，并在 references/issue-fields.md 中有对应说明。构建任何 URL 之前，请先打开该文件。

两条最重要的规则

1. 未经明确确认，绝不创建问题。 先向用户展示完整的标题和正文，并等待明确答复。你可以提出创建问题，但绝不能在用户未提出要求时提交。以下所有方式都适用，包括 gh CLI。
2. 发送前先删去敏感信息。 提交的所有内容都是公开的。请参阅删去敏感信息。

第 1 步：技能问题还是容器问题？

首先要判断正确：两者使用不同的问题模板。

问问自己，实际出现了什么故障。

问题	归属	模板
技能告诉 Agent 去做错误的事，或没有告诉它所需的信息	技能	skill_feedback.yml
加载了错误的技能，或本应加载技能却没有加载	技能	skill_feedback.yml
技能无法安装，或 Agent 根本没有识别到它	技能	skill_feedback.yml
你不得不偏离技能指引或绕过它才能完成任务	技能	skill_feedback.yml
技能说得正确，Agent 也做对了，但容器仍然出错（无法启动、查询报错、引擎行为异常）	容器	bug_report.yml
容器缺少用户需要的功能	容器	feature_request.yml

判断标准是：如果指引正确，但引擎仍然出错，那就是容器 Bug。如果指引有误、不完整或被忽略，那就是技能 Bug。 如果确实无法判断，请询问用户。不要猜测，也不要同时提交两份问题。

如果用户只是想反馈某项功能运行良好，请不要创建问题。引导他们前往 Discussions，然后结束。

第 2 步：收集信息

只有在尚不知道答案时才运行命令。

对于技能问题（这是最重要的问题，也是我们最不了解的部分）：

• 技能名称（例如 azuresql-db-rag）。如果没有加载技能，请明确说明：这本身就是一个 Bug。
• 你使用的是哪个 Agent（Claude Code、GitHub Copilot、Codex、Cursor）。不同技能在不同运行环境中的表现不同，而我们无法看到用户使用了哪一种。
• 技能中有误或缺失的指引原文，以及实际有效的做法。 这是整份报告中最有价值的字段。没有这些信息，我们就无法修复技能。
• 用户给你的提示词。

**对于容器问题：**镜像标签、主机操作系统（对应准确的下拉选项）、容器运行时及其版本、发生了什么，以及可复现问题的命令。如果出问题的是容器，请运行 docker logs sqldb。

步骤 3：脱敏（在进行任何构建之前执行）

从每个字段中删除以下所有内容，包括日志和复现步骤：

• SA 密码（MSSQL_SA_PASSWORD、-P <password>、连接字符串中的 Password= 字段）。替换为 ***。
• 注册表凭据（docker login 的用户名和密码）。
• 完整连接字符串。保留格式，删除机密信息：Server=localhost,1433;Database=appdb;User Id=sa;Password=***;TrustServerCertificate=true。
• 任何客户或应用数据、表内容、嵌入向量，或可识别用户或其雇主的路径。
• 任何类型的访问令牌。

此仓库是公开的，问题内容对所有人可见。泄露用户密码的报告还不如不提交。

步骤 4：起草并展示

撰写报告，然后向用户完整展示，并询问是否提交。说明你填写了哪些字段，哪些字段留空。如果无法有把握地确定某个值，请留空，不要猜测：错误的技能名称或主机操作系统会让问题分流走错方向。

步骤 5：提交

按以下顺序尝试，首次成功后停止；无论采用哪种方式，都要先征得用户确认。

第 1 层：gh CLI，前提是 gh auth status 执行成功。问题由用户提交，因此他们会收到回复。

gh issue create --repo microsoft/azure-sql-database-container \
  --title "[Skill]: <one-line summary>" \
  --label skills --label needs-triage --label User-filled --label via-skill \
  --body-file <path-to-body>

将正文写入文件，而不是直接作为参数传入，以确保引号和换行符得以保留。

第 2 层：预填 URL。 无需凭据或设置，用户可以在提交前准确查看将要提交的内容。gh 不可用时请使用此方式；此方式始终可用。

根据问题表单的字段 ID 构建 URL，并打印出来供用户打开。三个模板的字段 ID、逐字一致的下拉选项值以及完整示例都在 references/issue-fields.md 中。构建 URL 前请先阅读该文件。

验证规则

• 提交前，用户看到了准确的标题、正文和标签，并明确同意提交。
• 报告使用了正确的模板：技能问题使用技能表单，容器问题使用容器表单。
• 任何字段中都没有 SA 密码、注册表凭据或访问令牌。提交前再次检查正文。
• 每个下拉选项值都与字段参考中的内容完全一致；构建任何 URL 前须先打开该参考文件；否则应省略该字段。
• 预填报告使用完整的 github.com URL，绝不使用 aka.ms 链接，因为后者会丢弃查询字符串。
• 第 1 层仅在 gh issue create 打印出新问题 URL 时才算成功；第 2 层仅在用户打开 URL，且表单已预填字段时才算成功。如果两者都未成功，就表示报告未提交：请如实说明，不要暗示已提交。

请勿

• 未经用户明确确认，不要创建、评论或关闭问题。
• 不要在任何字段中包含 SA 密码、注册表凭据或访问令牌。绝不包含。
• 不要在容器模板中提交技能问题，反之亦然。两类问题由不同人员负责分流。
• 不要猜测下拉选项值。不确定时请省略该字段；省略的下拉选项会保持未选中，但选错会导致问题分流错误。
• 不要使用 aka.ms 短链接承载预填报告。这类链接会丢弃查询字符串，导致所有已填写字段都悄然丢失。请使用完整的 github.com URL。（aka.ms 链接用于供用户打开空白表单：技能反馈、容器错误、容器功能请求。）
• 不要为已知限制页面中已有的内容，或未关闭的问题中已有的问题提交报告。请改为引导用户查看相关页面。
• 不要反复催促。只询问一次，用户拒绝后就此作罢，继续处理其他事项。

参考资料

• references/issue-fields.md：三个模板的确切字段 ID、下拉选项的原文、URL 构造方式及其长度限制，以及示例。构建预填充 URL 前请先阅读。

保持信息更新

本技能所用工具的权威版本固定参考资料（按需阅读）：

• GitHub 问题表单架构语法：预填充映射到的表单架构字段（input、textarea、dropdown）。

如果已配置 Microsoft Learn MCP 服务，请使用 mcp__microsoft-learn__microsoft_docs_search 或 mcp__microsoft-learn__microsoft_docs_fetch 按需获取这些资料的当前版本。这是可选步骤；如果无法使用，上述参考资料即为权威资料。