关于 convex-optimize
convex-optimize 是用于审计和改进现有 Convex 应用的技能。它结合评分就绪度报告、组件更新和可选的可观测性配置,并仅在确认后应用更改。
主要功能
- 01获取评分式就绪度评估
- 02检查固定版本的 Convex 组件更新
- 03针对可观测性缺口提供 sentinel
- 04生成优先级修复计划
- 05重新评估并展示评分变化
适用场景
- 01检查 Convex 应用的安全与数据丢失风险
- 02规划过时 Convex 组件的更新
- 03处理缺少生产错误捕获的问题
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ get-convex/ agent-skills --skill convex-optimize安装后在 Claude Code 中输入/convex-optimize确认已加载。
详细介绍
审计并优化现有 Convex 应用
针对现有应用的修复工作流:先进行带评分的评估,再据此采取行动——升级过时组件并设置可观测性——先规划、再确认、后应用。评估本身交由 launch-readiness 完成(它是 findings-bus 评分器);优化功能的独特价值在于针对评估结果采取行动。
工作流
- 检测应用:查找
convex/目录和架构,并判断它是匿名部署还是云端部署。 - 评估:通过
launch-readiness执行评估——获取一份涵盖 authz/reviewer/advisor/insights 的评分报告,报告经过去重,并附有排序后的修复计划。不要手动重新执行这些检查;optimize 使用 launch-readiness 的报告,而不是重新实现审计。 - 升级:针对固定版本的
@convex-dev/*组件运行check-updates,并将过时组件(staleness-class)相关发现纳入同一计划。 - 可观测性:如果就绪报告指出存在可观测性缺口(未捕获生产环境错误),则提出安装
sentinel。 - 展示合并后的优先级计划——包括 launch-readiness 评分、修复计划、升级和可观测性,并将安全和数据丢失风险列在首位;仅在明确确认后才应用,并将每项修复交由相应的 fixCapability 执行。
- 应用后,重新运行 launch-readiness 评估,并展示评分变化。
规则
- 先只读。先展示计划并确认,然后再更改任何文件。
- 将审计交由 launch-readiness(findings-bus 评分器)处理;不要在流程中重新实现 reviewer/advisor/insights——optimize 的职责是根据报告采取行动(升级和可观测性),而非重新评分。
- 按照 launch-readiness 的排序,将安全和数据丢失风险置于样式问题之上。
- 绝不自动将更改直接应用到他人现有的生产应用;应用后重新评估,并展示评分变化。
评论
支持 Markdown