SuperAPI AI 工具集

feedback

智能体与模型

查看项目

更新于 10-16 07:14

技能介绍

用途:为使用 monskills 的智能体提供一套匿名反馈机制,在遇到问题时把最小化、已脱敏的信息上报给维护方。

何时提议反馈:同一任务重试 3 次以上仍无法收敛时用 stuck;同一工具、命令或错误连续出现 3 次以上时用 error-loop;用户抱怨技能错误、不清晰、失效或过时时用 user-complaint;已核实技能中事实有误时用 incorrect-info;技能声称覆盖某主题但缺少完成所需细节时用 suggestion。一次性瞬时错误、与 monskills 内容无关的用户情绪、已成功完成的任务不应上报。每个不同问题每会话最多提交一次。

同意要求:绝不自动发送。需先在本地起草最小化、已脱敏的载荷,告知用户反馈将发往 https://skills.devnads.com/api/feedback,展示计划发送的字段摘要,说明端点可能获取请求 IP 用于限流且仅以每日轮换哈希存储,并请求明确确认(如“回复 yes 发送”)。用户拒绝、沉默、转换话题或答复含糊时不得发送。

提交方式:向 https://skills.devnads.com/api/feedback 发送 JSON 请求体。必填字段为 message(一到两句话说明问题,最长 5000 字符,不含个人信息、密钥、私钥、原始地址、私有仓库名或主机用户标识)。可选字段包括 source(agent 或 user)、category(stuck、error-loop、user-complaint、bug、incorrect-info、suggestion、other)、severity(low、medium、high)、skill(monskills 标识,如 wallet、scaffold)、agent(自由文本 ≤128 字符)、context(自由文本 ≤4000 字符,含网络、命令与已脱敏错误输出)。成功返回 {"ok": true, "id": 数字},被拒返回 {"ok": false, "error": "..."}。

隐私硬性要求:发送前必须清洗载荷,不得包含私钥、助记词、API 密钥、OAuth 令牌、会话 cookie,也不得包含姓名、邮箱、用户名、组织名、主机名、本地绝对路径、隐藏目录路径或展开后的家目录。仅在理解问题所需时使用仓库相对路径,仓库外路径替换为 <REDACTED_PATH>。钱包地址、与用户关联的交易哈希、ENS 名、账户 ID、项目 ID、数据库 ID、工单或客户 ID 一律替换为占位符,如 0xUSER_ADDRESS、<TX_HASH>、<ACCOUNT_ID>。公开合约地址仅在识别错误技能内容且非用户可控时才可包含。不得包含原始命令输出、堆栈跟踪、环境转储、完整提示、聊天记录、截图或文件内容,只总结最小复现细节。除作为报告主题的公开文档或 API 页面外,移除 URL。若某字段无法满足规则,则省略该字段。

发送内容:经用户同意后仅发送所准备的 JSON 字段,不会发送仓库文件、终端历史、聊天记录、环境变量或凭据。

限流:每个哈希 IP 每小时最多 10 次提交;message 上限 5000 字符,context 上限 4000 字符;含超过 5 个 URL 或 HTML script 标签的载荷会被静默丢弃;website 字段为蜜罐,绝不要填写;收到 429 后应停止本会话的后续提交。

提交后:用一行告知用户已提交匿名反馈及返回 id,随后继续用户原任务,不等待人工回复。