mcpField
S
svelte-mcp-feedback

svelte-mcp-feedback

github.com/sveltejs测试与质量33975 次安装1 周前更新
代码仓库

关于 svelte-mcp-feedback

Svelte MCP feedback 是一项 Agent 技能，可将用户纠正的 Svelte 或 SvelteKit 错误整理为可执行的自动修复反馈。它指导 Agent 制作最小复现、检查现有诊断，并向 sveltejs/ai-tools 报告具体缺口。

主要功能

  1. 01识别可泛化的 Svelte 错误
  2. 02缩减为最小复现示例
  3. 03在可用时检查自动修复器输出
  4. 04区分规则缺口与现有诊断
  5. 05准备结构化问题报告
  6. 06提交前搜索重复报告

适用场景

  1. 01报告遗漏的 Svelte 诊断
  2. 02提出错误自动修复的修正方案
  3. 03记录可复用的 SvelteKit 模式
  4. 04提交前检查是否已有相关报告

MCP 相关

这项技能面向 sveltejs/ai-tools 中的 Svelte MCP 自动修复器。它要求 Agent 在可用时查阅相关 MCP 文档并运行 svelte-autofixer。

安装

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

$npx skills add https://github.com/sveltejs/ai-tools --skill svelte-mcp-feedback

安装后在 Claude Code 中输入/svelte-mcp-feedback确认已加载。

详细介绍

Svelte MCP 反馈

将用户纠正的错误转化为针对 sveltejs/ai-tools 中 Svelte MCP 自动修复器的可执行反馈。

1. 找出自动修复器的改进机会

根据对话和你刚刚处理的代码，找出：

  • 你生成的错误代码以及用户的纠正。
  • 说明这项纠正的 Svelte 或 SvelteKit 规则。
  • MCP 可以检测的可复用代码模式，以及它可以提供的修复或建议。

包括 +page.ts、+layout.server.ts、+server.ts、hooks.server.ts 和 svelte.config.js 等 SvelteKit JavaScript/TypeScript 文件；反馈不限于 .svelte 文件。

只有在存在具体且可泛化的 Svelte/SvelteKit 错误时才继续。产品需求变更、个人命名偏好或无关的应用程序错误，都不足以作为自动修复器问题。如果纠正内容不明确，请在继续完成用户任务的同时予以澄清。

应用用户的纠正并完成所请求的工作。报告反馈时，不要让原始错误继续存在。

2. 准备最小复现

将前后代码精简为能够保留该错误的最小示例。使用通用名称和示例数据，不要复制无关的项目代码、凭据或对话历史。

如果可以使用 Svelte MCP，请查看相关文档，并在支持该文件类型时对错误示例运行 svelte-autofixer。记录它是漏报了问题、建议了错误的修复，还是已经报告了问题而你之前没有注意到。未经检查实际输出，不要声称工具漏报。如果工具不可用或不支持该文件类型，请说明；即使如此，拟议的新规则仍可能有用。

如果现有诊断已明确涵盖这项纠正，请使用该诊断，而不是提交新规则请求。只报告具体缺口，例如诊断不明确、建议的修复错误，或漏掉某种情况。

准备一个类似 Autofixer: detect <incorrect pattern> 的标题，并附上包含以下内容的 Markdown 正文：

  1. Summary — 错误是什么，以及它为何重要。
  2. Incorrect code — 带相关文件名/文件类型的最小代码示例，使用围栏代码块。
  3. User correction / expected code — 更正后的示例和简要说明。
  4. Proposed detection and fix — 可识别的模式、建议的转换或指导，以及修复存在歧义的情况。
  5. Current MCP behavior — 实际的相关输出；如果未检查，请明确写明“未检查”及原因。
  6. Environment — 已知的 Svelte、SvelteKit、MCP 和模型版本；不要臆造缺失的版本信息。

维护者无需访问原始项目，就能理解该模式和预期结果时，报告便已准备就绪。

3. 创建 issue

如果已安装并完成身份验证，请使用 GitHub CLI。通过 gh --version 和 gh auth status 检查。始终指定 --repo sveltejs/ai-tools，以免 issue 被提交到用户的项目仓库。

搜索是否已有关于相同模式的报告：

gh issue list --repo sveltejs/ai-tools --state all --search '<pattern keywords>' --limit 20

使用 gh issue view <number> --repo sveltejs/ai-tools 阅读可能相关的 issue。如果已有 issue 描述了相同的复现和预期修复，请分享其链接，而不是重复提交。如果某个已关闭的 issue 声称问题已修复，但你的示例仍然失败，请在新报告中描述此回归，并链接旧 issue。

使用文件写入工具或带引号的 heredoc，将 issue 正文写入临时 Markdown 文件。安全地引用标题，并使用 --body-file，避免代码片段和反引号被 shell 解释：

gh issue create --repo sveltejs/ai-tools --title 'Autofixer: detect <incorrect pattern>' --body-file '<temporary-body-file>'

记录并分享返回的 issue URL。不要猜测标签或指派对象。如果创建失败，请报告失败情况并使用浏览器备用方案。如果结果不确定（例如提交后网络超时），请先检查 issue 是否已创建，再重试。

浏览器备用方案

如果 gh 不可用、未通过身份验证或无法创建 issue，请为以下内容构建 URL：

https://github.com/sveltejs/ai-tools/issues/new?title=<encoded-title>&body=<encoded-body>

使用 encodeURIComponent、URLSearchParams 或等效的 URL 编码器对每个查询值进行编码；不要将原始 Markdown 插入 URL。使用可用的浏览器工具或平台 URL 打开器（macOS 上的 open、Linux 上的 xdg-open 或 PowerShell 中的 Start-Process）打开该 URL。这会打开新建 issue 表单，并为用户填好草稿，供其提交。

如果完整报告会导致 URL 过长，请预填标题和简短摘要，并提供完整的 Markdown 正文供用户粘贴。如果无法打开浏览器，请在回复中提供可点击的预填 URL 和正文。

明确说明结果：要么提供已创建/现有 issue 的 URL，要么说明草稿表单已准备就绪，用户仍需提交。然后返回用户最初的任务。

评论

支持 Markdown