SuperAPI AI 工具集

improve-convex-plugin

智能体与模型

查看项目

更新于 10-15 21:51

技能介绍

用途:本技能把当前会话记录上传到 anteater 的 POST /review 接口,由 Claude 分析并返回结构化发现(指令歧义或错误、代理卡住或重复工作之处、工具故障,以及哪些做法有效),针对 runbook、bootstrap、技能或组件进行系统改进,而非终端用户功能反馈。

同意机制:分享会话为可选项,只需询问一次。运行下列辅助脚本;若输出 CONSENT_REQUIRED 并以非零状态退出,说明用户尚未选择,应停止并按其原意询问是否分享(先剥离密钥):始终分享(记住不再询问)、仅此一次、或从不。在用户作答前不得代为决定或发送任何内容。随后按选择传入对应参数:--consent always(写入 ~/.convex/improve-consent,后续会话不再提示)、--consent once(仅本次分享,不存储)、--consent never(持久化,永不再询问;删除该文件可重新启用)。若脚本输出 CONSENT=never 并以 0 退出,说明用户已拒绝,告知分享已关闭并停止,不要再次询问或传参。

使用方式:辅助脚本由 Convex 后端提供,因此同意门控与脱敏修复可即时生效,无需更新插件。通过 curl 拉取并管道给 bash,会自动检测 Claude 或 Codex(查找最新会话记录),压缩并脱敏后上传,再轮询复盘结果: curl -fsSL "https://basic-anteater-667.convex.site/send-transcript" | bash -s -- --idea "<本次会话的一行应用想法>" 用户选择后可追加同意参数,例如 … | bash -s -- --idea "…" --consent always。传入 --idea 便于复盘与所构建内容关联(从会话上下文读取,未知则省略);--source claude|codex 可强制指定框架,否则自动检测;--base https://<anteater>.convex.site 或环境变量 QB_REVIEW_BASE 可覆盖默认地址。

输出解读:脚本先打印标记再输出复盘 JSON。REVIEW_SOURCE=… session=… 表示找到的记录;REVIEW_SUBMITTED id=… 表示已接受;REVIEW_DONE status=done 表示结果就绪。JSON 包含 summary、outcome、findings[](每项含 title、target、severity、observation、evidence、suggestedFix)与 wins[]。完成后向用户简述最高严重级别发现及各自针对的系统部分;若输出 REVIEW_NO_TRANSCRIPT 表示未找到 Claude/Codex 的 .jsonl 文件,应告知用户。切勿回传原始密钥;脚本上传前已脱敏键与令牌,总结应聚焦系统而非用户数据。

适用场景与限制:适用于希望基于真实会话持续改进 Convex 相关工具链的开发者,依赖 Claude Code 或 Codex 会话记录,需联网访问 Convex 后端,且必须获得用户同意。未提供具体收费、价格、平台支持范围与效果保证等信息。