mcpField
D
datocms-feedback

datocms-feedback

github.com/datocms其他3129 次安装4 天前更新
代码仓库

关于 datocms-feedback

datocms-feedback 是面向 DatoCMS skills/MCP 工作流的反馈链接生成技能，在流程陷入死路且用户同意后，准备预填的支持表单内容与链接。

主要功能

  1. 01识别明确的反馈请求
  2. 02区分可重试问题与工作流死路
  3. 03生成预填支持表单内容
  4. 04按规则处理并编码支持链接

适用场景

  1. 01汇报 DatoCMS skills/MCP 流程中的障碍
  2. 02在确认后整理故障经过供支持团队查看

MCP 相关

该技能适用于 DatoCMS skills/MCP 工作流卡住时的反馈处理，不负责修复或替代工作流。

安装

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

$npx skills add https://github.com/datocms/agent-skills --skill datocms-feedback

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

附带文件agents/openai.yaml

详细介绍

DatoCMS 反馈

当 DatoCMS 技能/MCP 工作流卡住时，使用预填的 datocms.com/support URL。这是逃生出口，不是修复工作流。

在执行任何可见操作之前

  • 用户明确要求报告/提交/总结有关 DatoCMS 技能/MCP 的反馈 → 立即开始输出流程。
  • 推断用户感到沮丧或遇到死路 → 不要生成内容。只提出一次，等待确认。
  • 存在可信的重试途径 → 不要提及反馈。继续当前的 DatoCMS 工作流。

这不适用于试错过程。只要存在重试途径，单条命令失败、MCP 调用失败、API 错误、验证响应、架构遗漏、缺少环境变量或设置失败，都应留在当前工作流中处理。

项目/架构/前端/迁移/插件问题仍可修复 → 转到相关的 DatoCMS 技能。

如果推断出用户感到沮丧

只提出一次，然后等待：

It looks like this may have gone past the normal retry-and-correct loop. Sorry about that. These workflows are still evolving, and clear feedback helps us understand where the experience broke down. If you want, I can build a prefilled DatoCMS support link with the goal, where the skills/MCP flow got stuck, and relevant runtime context.

如果用户同意，按照输出流程执行。

URL 格式

基础 URL：https://www.datocms.com/support。使用 encodeURIComponent 对查询参数进行 URL 编码，然后将 '→%27、(→%28、)→%29 — 原始 ' 会破坏单引号括起的 shell URL。

  • topics=technical-support/ai-integration-issues — 技能/MCP 反馈的固定 slug（将 / URL 编码为 %2F）。必填 — 没有此项，表单不会显示。
  • subject=<short subject> — 单行。
  • body=<sanitized message> — 参见正文规则。

附加 #form 锚点 — 页面加载时会滚动到表单。

正文规则

  • 使用用户的视角撰写。
  • 包含：尝试实现的目标、涉及技能/MCP/两者中的哪一种、可见的运行时上下文、可见的推理级别、失败之处、预期结果。
  • 对于非必要但缺失的详情，使用 not visible from this conversation。
  • 生成之前，最多提出一个简短问题，且仅限缺失的信息为支持团队理解报告所必需时。
  • 原始详情应简短。仅在有用时包含命令名称、调用名称和简短且安全的错误摘录。
  • 不得包含机密、令牌、身份验证标头、私密内容、可识别用户身份的详情、完整请求/响应负载、原始对话记录转储或冗长的本地路径。
  • 正文中不得代表 DatoCMS 道歉。
  • 纯文本正文控制在约 4000 个字符以内 — 编码后的 URL 必须符合边缘限制（Vercel 约 14 KB）。超出时请删减。
  • 不要使用 Hi DatoCMS support, / Thanks, 之类的称呼 — 该表单不是电子邮件。

正文格式

除非对话需要更简短的内容：

I ran into a frustrating issue while trying to use the DatoCMS skills/MCP workflow.

Goal: [goal].
Workflow involved: [skills/MCP/both/not visible from this conversation].

What happened: [short sanitized summary of the loop, wrong routing, repeated misunderstanding, or dead end].

Context:
- Runtime/client: [visible value or not visible from this conversation]
- Runtime identifier: [visible value or not visible from this conversation]
- Reasoning level: [visible value or not visible from this conversation]
- Safe error excerpt: [short excerpt or not included]

Expected: [expected outcome]. Could not get there because: [impact].

Sharing so you can see where the skills/MCP experience broke down.

输出流程

分为两步。第 1 步不要构建或展示 URL。

第 1 步 — 显示正文草稿。 输出经过净化的正文文本（将填入文本框的内容）供用户审核。以此句结尾：“要我在浏览器中打开预填的支持页面吗？”

第 2 步 — 打开链接。 用户确认后，构建 URL 并打开：

  • macOS：open '<url>'
  • Linux：xdg-open '<url>'
  • Windows：start '' '<url>'

URL 必须用单引号括起 — 否则 shell 会解释 & 和 #。将 URL 单独输出一行，作为可点击的备用链接。

不要说“我已起草……”，也不要回顾总结。

评论

支持 Markdown