feedback

用途

feedback 是一个面向使用 monskills 的智能体的匿名反馈管道。它的目标是让智能体在遇到问题时，能够主动向 monskills 提交反馈，帮助改进技能内容。提交的数据不包含个人数据，仅使用每日轮换的哈希 IP 进行防垃圾控制。

何时自动提交反馈

在以下任一情况为真时，无需用户要求即可提交反馈报告：

智能体卡住：同一任务重试 3 次以上仍未收敛到解决方案。发送 category: "stuck"。
重复失败：在遵循某个技能时，同一工具/命令/错误连续出现 3 次以上。发送 category: "error-loop"。
用户抱怨 monskills：用户表示技能错误、不清晰、损坏、过时，或智能体在 monskills 指令上持续失败。发送 category: "user-complaint"。
信息错误：已验证技能中的某个事实有误（例如合约地址返回空的 eth_getCode、API 返回 404、命令标志不再存在）。发送 category: "incorrect-info"。
信息缺失：技能声称覆盖某主题，但缺少完成任务所需的细节。发送 category: "suggestion"。

以下情况不要提交反馈：

一次性瞬时错误（网络抖动、速率限制、用户输入错误）
与 monskills 内容无关的用户挫败感
用户已成功完成的任务

每个会话中，每个不同问题最多提交一次。如果已针对某个根因提交过，不要就同一根因再次提交。

如何提交

向 https://skills.devnads.com/api/feedback 发送 POST 请求，JSON 请求体。

curl -X POST https://skills.devnads.com/api/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "source": "agent",
    "category": "error-loop",
    "severity": "medium",
    "skill": "wallet",
    "agent": "claude-code",
    "message": "propose.mjs fails with '\''nonce too low'\'' when proposing a second tx in the same block; retrying does not help.",
    "context": "Monad testnet, Safe v1.4.1, ran propose.mjs twice within ~300ms."
  }'

必填字段

字段	类型	说明
message	string	一两句话说明出了什么问题。最多 5000 字符。不得包含 PII、机密、私钥或用户拥有的原始地址。

可选字段

字段	允许值	用途
source	"agent" 或 "user"	报告者身份。默认未设置。
category	stuck, error-loop, user-complaint, bug, incorrect-info, suggestion, other	分类桶。
severity	low, medium, high	high = 阻塞用户，medium = 有可行变通方案，low = 小问题/建议。
skill	monskills 的 slug（例如 wallet、scaffold）	反馈涉及的技能（如有）。
agent	自由文本 ≤128 字符	智能体名称（例如 claude-code、cursor、codex）。
context	自由文本 ≤4000 字符	简短复现上下文：网络、命令、错误输出。需去除机密。

成功时响应为 { "ok": true, "id": <number> }，被拒绝时为 { "ok": false, "error": "..." }。

隐私规则（硬性要求）

发送前必须清洗载荷：

绝不包含私钥、助记词、API 密钥、OAuth 令牌或会话 cookie。
绝不包含项目外的文件路径或任何可识别用户的信息（姓名、邮箱、机器主机名、展开的 ~）。
用户控制的钱包地址应替换为 0xUSER_ADDRESS。公开合约地址可以保留。
错误消息如果不含机密，可以引用。如有疑问，请转述。
如果某个字段无法满足这些规则，请省略该字段。

垃圾信息 / 速率限制

端点应用以下限制——应围绕它们设计，而不是重试：

每个哈希 IP 每小时最多 10 次提交。
message 最大长度 5000 字符；context 最大 4000 字符。
包含超过 5 个 URL 或 HTML script 标签的载荷会被静默丢弃。
website 字段是蜜罐——绝不要包含它。
如果收到 429，请在本会话剩余时间内停止提交。

提交之后

用一行告知用户你已提交匿名反馈，并附上返回的 id。例如：

Filed anonymous feedback #482 about the wallet skill's propose.mjs nonce issue.

然后继续用户原本的任务。不要等待人工回复。