mcpField
T
tres-request-skill-update

tres-request-skill-update

github.com/anthropicsAgent 工作流4.8k49 次安装2 周前更新
代码仓库

关于 tres-request-skill-update

面向 Claude 的技能，用于收集关于 TRES 插件的可执行反馈，并通过 TRES MCP 工具提交。它引导用户完成反馈梳理、确认和提交。

主要功能

  1. 01引导收集反馈
  2. 02反馈类别归类
  3. 03针对性追问
  4. 04提交前由用户审核
  5. 05会话结束时可选提示

适用场景

  1. 01报告插件错误
  2. 02提出功能或改进建议
  3. 03在会话结束时分享反馈

MCP 相关

使用 TRES MCP 的 `get_viewer` 工具识别组织，并通过 `save_ai_conversation_feedback` 提交经用户审核的反馈。

安装

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

$npx skills add https://github.com/anthropics/claude-plugins-community --skill tres-request-skill-update

安装后在 Claude Code 中输入/tres-request-skill-update确认已加载。

详细介绍

TRES 插件反馈

引导用户提交清晰、可执行的 TRES Claude 插件反馈，并使用 save_ai_conversation_feedback TRES MCP 工具保存。无需额外配置——任何拥有 TRES API 令牌的用户都可以使用。

此技能有两种模式：

  1. 主动反馈 — 用户要求提交反馈、报告 Bug 等。请从第 1 步开始，运行完整的引导流程。
  2. 对话结束时提示 — 对话即将结束时，进行简短、友好的提醒（参见第 0 步）；只有用户同意后才继续完整流程。

第 0 步 — 对话结束时提示

当对话似乎即将结束（用户说“谢谢”“就这些”“看起来不错”等），且此技能主动触发时：

随意地询问：

结束前——你对这次对话有什么反馈吗？Bug、想法或可以改进的地方都可以。我可以在 30 秒内帮你记录下来，供团队参考。

  • 如果用户拒绝（“不用了”“我没事”“不了”）——回复“没关系，祝你今天愉快！”然后停止。不要继续追问。
  • 如果用户分享了内容——转到第 1 步并运行完整的引导流程，但保持轻松简洁。跳过用户在对话中已经回答的问题，尽量快速完成。
  • 保持轻松、随意的语气——绝不要让用户觉得这是强制调查。

第 1 步 — 确认提交者

  1. 调用 get_viewer（TRES MCP，不带参数）以确认提交者身份。

    • 从响应中提取组织名称。
    • 如果 get_viewer 调用失败，则使用 "Unknown org" 作为提交者并继续。

  2. 获取用户的 Git 身份信息，用于反馈记录：

    git config user.name && git config user.email

    将第 1 行用作 agent_name，将第 2 行用作 agent_email。如果无法使用 Git，则使用系统用户名，并将邮箱留空。

告诉用户：“你已通过 {orgName} 连接。想分享什么反馈？”

第 2 步 — 了解反馈

先让用户用自己的话描述反馈，然后根据其描述将反馈归入以下类别之一：

类别使用时机
Bug 报告某项功能无法正常工作、报错或产生错误结果
功能请求用户希望新增目前尚不存在的能力
改进建议现有功能可以正常使用，但仍有提升空间（用户体验、格式、流程、性能）
新技能想法提议开发一项全新的技能
MCP / 数据问题TRES MCP 返回的数据有误、缺少字段或行为异常
正面反馈某项功能运行良好，用户希望团队知晓
一般反馈其他情况 — 工作流阻碍、困惑、文档、入门指导

向用户确认类别：“听起来这是一个{category}，对吗？”

如果反馈涉及某项具体技能或 MCP 工具，请确认是哪一项。如果反馈比较笼统，或涉及整个插件，请注明。

已知技能：

技能说明
tres-asc845-swap-reprice-skill按 ASC 845 重新定价掉期，使清算账户余额为零
tres-explorer-tx-to-ledger将区块链浏览器 TX 添加到 TRES 账本
tres-tx-storyTX 流程图和说明
tres-recon-gaps对账差异解决
tres-asset-balance-validation与 DeBank 进行余额验证
tres-report-analyzer分析 TRES 报告 XLSX 导出文件
tres-report-advisor推荐合适的 TRES 报告
tres-invoice-bill-matching将交易与 ERP 发票/账单匹配
tres-export-3rd-party-contacts将无法识别的交易对手方导出到 XLSX
tres-import-contacts从 CSV/XLSX 导入联系人
tres-cost-basis成本基础计算、策略、问题、重新评估、导出
tres-rollup-rules子交易汇总规则（汇总交易）
tres-onboarding实体完整入门流程（协调子技能）
tres-settings-management组织和平台设置
tres-wallets-upload钱包入门流程
tres-upload-tx-header-validation批量交易 CSV 表头命名验证
tres-request-skill-update此反馈技能

维护者备注：添加新技能时，请更新此表。

第 3 步 — 深入了解

根据类别提出有针对性的后续问题，让反馈具有可操作性。 每次问一两个问题，保持对话自然，不要像盘问。

对于 Bug 报告：

  • 具体发生了什么？你看到了什么？
  • 你原本希望发生什么？
  • 发生时你正在做什么？（复现步骤）
  • 你看到错误消息了吗？如果有，消息内容是什么？
  • 可以分享一个具体示例吗？（交易哈希、钱包地址、你使用的输入）

对于功能请求和改进建议：

  • 这能帮你解决什么问题？
  • 没有这个功能时，你现在是如何处理的？
  • 可以描述一下理想的使用体验吗？
  • 你多久会遇到一次这种需求？

对于新技能的想法：

  • 这个技能会自动化什么工作流或任务？
  • 你团队中的哪些人会使用它？使用频率如何？
  • 可以举一个你会如何使用它的具体示例吗？
  • 它需要什么数据源？（TRES MCP、外部 API、本地文件）

对于 MCP／数据问题：

  • 涉及哪个 MCP 工具或查询？
  • 返回了什么数据？其中有什么问题？
  • 你原本期望数据是什么样的？
  • 可以分享你使用的具体查询或标识符吗？

对于正面反馈：

  • 具体来说，哪些方面表现良好？
  • 有没有什么让你（惊喜地）感到意外的地方？
  • 有没有某个工作流或使用场景特别出色？
  • 你会做什么调整来让它变得更好吗？

对于一般反馈：

  • 你在反馈体验的哪一部分？
  • 有没有什么令人困惑或不清楚的地方？
  • 怎样做会让体验更好？

根据用户已经提供的信息灵活调整，跳过他们已经回答的问题。 目标是收集足够详细的信息，让阅读反馈的人能够理解背景并采取行动，而无需再提出后续问题。

第 4 步 — 预览反馈

整理反馈并展示给用户审阅。清晰地排版：

Headline: {concise summary — max 80 chars}

Category: {Bug report | Feature request | Improvement | New skill idea | MCP issue | Positive feedback | General}
Area: {skill name, "MCP", or "General"}
Org: {orgName}

---

{Well-structured description that includes:
 - What the feedback is about (context)
 - The core issue, idea, or praise (substance)
 - Supporting details — steps to reproduce, examples, expected behavior, etc.
 - Impact — how often this comes up, how many people it affects, how it blocks work}

Tags: {comma-separated list}

撰写描述：

  • 将用户的回答整合成清晰易读的叙述，不要只罗列问答。
  • 先说明最重要的内容。
  • 加入具体细节（交易哈希、错误消息、具体步骤），这些信息能让反馈具有可操作性。
  • 对于正面反馈，具体说明哪些方面表现良好以及其重要性。

同时向用户展示将要提交的对话摘录（参见第 5 步格式）。 这样用户就能清楚了解哪些内容会离开自己的设备。

询问：“这是我将要提交的内容——是否涵盖了所有信息？你想修改什么吗？”

如果用户希望修改，请继续迭代。只有在用户明确确认后才能继续。

第 5 步 — 提交反馈

使用以下参数调用 save_ai_conversation_feedback：

参数值
headline简洁摘要（最多 80 个字符）。在前面加上类别标签：[Bug]、[Feature]、[Improvement]、[New Skill]、[MCP Issue]、[Praise] 或 [Feedback]
description第 4 步中整理的完整结构化描述
conversation限定范围并经过脱敏的对话摘录（参见下方格式）
tags数组——始终包含 "plugin-feedback"，以及类别标签（"bug"、"feature"、"improvement"、"new-skill"、"mcp-issue"、"praise"、"general"）；如适用，还要包含技能名称
agent_name从 git config 获取（第 1 步）
agent_email从 git config 获取（第 1 步）

对话格式——只包含上下文窗口中的最后 30 轮对话（用户＋助手对话），不要包含整个会话历史。在纳入任何消息前，先进行脱敏处理：

  • 将 Bearer [A-Za-z0-9._\-]{20,} 替换为 Bearer [REDACTED]
  • 将独立出现的 64 个字符十六进制字符串替换为 [REDACTED_HEX]
  • 将符合 /Users/<name>/ 或 /home/<name>/ 格式的文件路径替换为 /Users/[REDACTED]/
  • 移除任何疑似 BIP-39 助记词短语（12–24 个词）

格式：

USER: <text, redacted>

ASSISTANT: <text, redacted>

TOOL_CALL: <tool_name>(arg1=value1, arg2=value2)
TOOL_RESULT: <one-line summary of the result>

... continue for the last 30 exchanges only ...

第 6 步 — 报告结果

成功时： 告诉用户：

您的反馈已提交 — 谢谢！团队会审核。

如果反馈是错误或阻塞问题，请补充：

如果情况紧急，也请直接联系团队。

失败时： 显示 MCP 工具返回的错误，并建议：

  • 检查 TRES API 令牌是否有效
  • 重试 — 这可能是暂时性问题

错误处理

情况操作
get_viewer 失败继续操作，将“Unknown org”作为提交者
save_ai_conversation_feedback 失败显示错误；建议检查 TRES API 令牌
用户在预览时取消告知“没问题 — 未提交反馈”并停止
用户提供的描述为空再次询问 — 必须填写描述
git config 不可用使用系统用户名作为 agent_name，agent_email 留空

评论

支持 Markdown