用途
improve-convex-plugin 是一个用于改进 Convex 系统本身的技能。它把当前 Claude Code 或 Codex 编码会话的对话记录发送到 anteater 的 POST /review 接口，由 Claude 对记录进行分析，返回结构化发现，目标对象是 runbook、bootstrap、技能和组件，而不是终端用户功能反馈。
主要能力
- 自动检测 Claude Code 与 Codex 的最新对话记录，并进行压缩与脱敏。
- 上传后在 backend 侧运行 Claude，返回包括 summary、outcome、findings[] 与 wins[] 的 JSON 结果。
- findings 覆盖含糊或错误的指令、智能体卡住或重复劳动的位置、工具故障，以及哪些做法有效。
- 支持通过 --idea 传入本次会话的一行应用想法，帮助复盘关联正在构建的内容。
- 支持 --source claude|codex 强制指定来源，否则自动检测。
使用方式
先运行辅助脚本：
curl -fsSL "https://basic-anteater-667.convex.site/send-transcript" | bash -s -- --idea "<the one-line app idea from this session>"
若脚本输出 CONSENT_REQUIRED 并以非零状态退出，说明用户尚未选择，应先停下来询问，询问内容为：为了改进 Convex 工具，会把经过脱敏的会话副本发送给 Convex 团队，密钥会先被移除，选择“始终共享（记住且不再询问）”“仅此一次”或“从不”。用户回答后，以对应参数重新运行：
- 始终 → --consent always（持久化到 ~/.convex/improve-consent，之后会话不再询问）
- 仅此一次 → --consent once（只共享本次，不存储，之后会再次询问）
- 从不 → --consent never（持久化，不再提供；删除该文件可重新启用）
示例：… | bash -s -- --idea "…" --consent always
如果脚本输出 CONSENT=never … 且退出码为 0，说明用户已选择退出，应告知共享已关闭并停止，不要再次询问或传 --consent 参数。
默认 URL 已指向正确的 anteater；如需覆盖，可使用 --base https://<anteater>.convex.site 或环境变量 QB_REVIEW_BASE。
输出解读
脚本会先打印标记：REVIEW_SOURCE=… session=… 表示找到的对话记录；REVIEW_SUBMITTED id=… 表示已接受；REVIEW_DONE status=done 表示结果就绪。随后输出复盘 JSON。若出现 REVIEW_NO_TRANSCRIPT，说明没有找到 Claude/Codex 的 .jsonl 文件，应告知用户。完成后向用户简要总结最高严重程度的发现及各目标对象，不要回贴原始密钥；脚本在上传前已脱敏，但总结仍应围绕系统而非用户数据。
适用场景与限制
适用于希望在编码过程中收集系统级改进线索的 Convex 相关开发场景。共享为选择加入机制，未获用户同意前不得发送任何内容；脚本本身由后端提供，因此同意门槛与脱敏修复可即时生效而无需更新插件。默认 URL、接口路径、持久化路径与参数名称均以资料为准；其他平台支持、收费方式等暂未提供。