mcpField
C
convex-optimize

convex-optimize

github.com/get-convex开发6931.3k 次安装1 天前更新
代码仓库

关于 convex-optimize

convex-optimize 是用于审计和改进现有 Convex 应用的技能。它结合评分就绪度报告、组件更新和可选的可观测性配置,并仅在确认后应用更改。

主要功能

  1. 01获取评分式就绪度评估
  2. 02检查固定版本的 Convex 组件更新
  3. 03针对可观测性缺口提供 sentinel
  4. 04生成优先级修复计划
  5. 05重新评估并展示评分变化

适用场景

  1. 01检查 Convex 应用的安全与数据丢失风险
  2. 02规划过时 Convex 组件的更新
  3. 03处理缺少生产错误捕获的问题

安装

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

$npx skills add https://github.com/get-convex/agent-skills --skill convex-optimize

安装后在 Claude Code 中输入/convex-optimize确认已加载。

详细介绍

审计并优化现有 Convex 应用

针对现有应用的修复工作流:先进行带评分的评估,再据此采取行动——升级过时组件并设置可观测性——先规划、再确认、后应用。评估本身交由 launch-readiness 完成(它是 findings-bus 评分器);优化功能的独特价值在于针对评估结果采取行动。

工作流

  1. 检测应用:查找 convex/ 目录和架构,并判断它是匿名部署还是云端部署。
  2. 评估:通过 launch-readiness 执行评估——获取一份涵盖 authz/reviewer/advisor/insights 的评分报告,报告经过去重,并附有排序后的修复计划。不要手动重新执行这些检查;optimize 使用 launch-readiness 的报告,而不是重新实现审计。
  3. 升级:针对固定版本的 @convex-dev/* 组件运行 check-updates,并将过时组件(staleness-class)相关发现纳入同一计划。
  4. 可观测性:如果就绪报告指出存在可观测性缺口(未捕获生产环境错误),则提出安装 sentinel。
  5. 展示合并后的优先级计划——包括 launch-readiness 评分、修复计划、升级和可观测性,并将安全和数据丢失风险列在首位;仅在明确确认后才应用,并将每项修复交由相应的 fixCapability 执行。
  6. 应用后,重新运行 launch-readiness 评估,并展示评分变化。

规则

  • 先只读。先展示计划并确认,然后再更改任何文件。
  • 将审计交由 launch-readiness(findings-bus 评分器)处理;不要在流程中重新实现 reviewer/advisor/insights——optimize 的职责是根据报告采取行动(升级和可观测性),而非重新评分。
  • 按照 launch-readiness 的排序,将安全和数据丢失风险置于样式问题之上。
  • 绝不自动将更改直接应用到他人现有的生产应用;应用后重新评估,并展示评分变化。

评论

支持 Markdown