这是一个面向 Convex 应用的组件采用规划技能,用于回答是否采用某组件、哪个组件适合计划功能,以及如何在不产生重复归属的前提下集成等问题。
用途:在推荐采用组件前,先检查应用现有的持久化数据归属方,倾向保持单一权威所有者;若引入组件会形成第二个事实来源,通常建议不予采用,除非计划是彻底替换。
主要能力:先获取实时 Convex 组件索引与具体组件文档,检查后端 package.json、convex.config.ts、schema.ts 及功能相关模块;用 Rust 辅助 CLI 做确定性准备(doctor 检查工具可用性,component 归一化包名并输出文档链接与建议命令,scaffold 生成 PLAN.md 与 CODEX_FULL_PROMPT.md 脚手架);用加权评分模型评估方案,并逐个提出带 0.0 至 10.0 评分的单选设计问题。
使用方式:先运行 curl -s https://www.convex.dev/components/components.md 获取组件索引,再按顺序运行 cargo run --manifest-path .agents/skills/convex-component-adoption-planner/scripts/convex-component-adoption-prep/Cargo.toml 的 doctor、component、scaffold 子命令。默认输出路径为 .agents/plans/YYYY-MM/MM-DD/convex-components/<component-slug>/,必须包含 PLAN.md 与 CODEX_FULL_PROMPT.md;拒绝采用时同样输出该包,但 PLAN.md 为不采用备忘。
限制:辅助 CLI 只准备确定性输入和起始文件,不做推荐或架构判断;最终推荐、重复归属分析、硬切换判断与提示包对齐由模型负责。缺少本地工具时应优雅降级,不硬依赖 opensrc、ctx7、bunx、gh 等工具。