关于 convex-optimize
convex-optimize 用于评估并改进现有 Convex 应用。它结合 launch-readiness 结果、组件更新和可观测性操作,并在修改前要求确认。
主要功能
- 01检测 Convex 应用及部署类型
- 02使用 launch-readiness 评估
- 03检查固定版本组件更新
- 04发现可观测性缺口时提供 sentinel
- 05确认计划后应用修复
- 06重新评估并报告分数变化
适用场景
- 01优先处理安全和数据丢失风险
- 02更新过时的 Convex 组件
- 03添加生产环境错误捕获
- 04检查修复后的评估变化
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ 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