ruan-cat
- 98 skills
- 0 followers
- 4 hours ago last updated
- ▌ Spec Workflow · ruan-catUse when medium-to-large changes need explicit requirements, technical design, and task planning before implementation, especially for multi-module work, unclear acceptance criteria, or architecture-heavy requests.
- ▌ Record Bug Fix Memory 2 · ruan-cat bundle当用户要求在 bug 已经定位并修复后,记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么",不要把它用于实际修复 bug。
- ▌ Cloudbase Agent 2 · ruan-cat bundleBuild and deploy AI agents with Cloudbase Agent (TypeScript), a TypeScript SDK implementing the AG-UI protocol. Use when: (1) deploying agent servers with @cloudbase/agent-server, (2) using LangGraph adapter with ClientStateAnnotation, (3) using LangChain adapter with clientTools(), (4) building custom adapters that implement AbstractAgent, (5) understanding AG-UI protocol events, (6) building web UI clients with @ag-ui/client, (7) building WeChat Mini Program UIs with @cloudbase/agent-ui-miniprogram.
- ▌ Use Iconify · ruan-catUse when 开发者需要在后台项目 `apps/eams-frontend` 中显示图标,尤其是要在 Vue 页面、配置驱动菜单、组合式函数、或兼容旧 `IconXxx` 写法之间选择合适方案时使用。适用于 `ReIcon`、`IconifyIconOffline`、`IconifyIconOnline`、`useRenderIcon`、离线图标扩展和 iconify 接入排错。
- ▌ Package Linter · ruan-cat校验和规范化 monorepo 中 Node 包的 package.json、tsup.config.ts、tsconfig.json 配置。在创建新包、修改包配置、审查包规范合规性、初始化新的工作区子包时使用。触发关键词:新建包、创建包、package.json、tsup 配置、包校验、包规范、初始化子包。
- ▌ Openspec Explore · ruan-catEnter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.
- ▌ Openspec Onboard · ruan-catGuided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
- ▌ Openspec Ff Change · ruan-catFast-forward through OpenSpec artifact creation. Use when the user wants to quickly create all artifacts needed for implementation without stepping through each one individually.
- ▌ Openspec New Change · ruan-catStart a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature, fix, or modification with a structured step-by-step approach.
- ▌ Openspec Sync Specs · ruan-catSync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.
- ▌ Openspec Apply Change · ruan-catImplement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.
- ▌ Openspec Verify Change · ruan-catVerify implementation matches change artifacts. Use when the user wants to validate that implementation is complete, correct, and coherent before archiving.
- ▌ Openspec · ruan-cat bundleOpenSpec 规范驱动开发助手 - 基于 OPSX 工作流的 AI 辅助编程框架。 在编写代码前与 AI 就需求达成一致,使用 Schema 驱动的工件依赖系统管理变更。 触发条件(满足任意一项即触发): 1. 用户提及 "openspec"、"opsx"、规范驱动开发、spec-driven 2. 用户想要开始新功能开发、重构或探索复杂需求 3. 用户抱怨 AI 理解偏差或频繁返工 4. 用户使用斜杠命令如 /opsx:new、/opsx:ff、/opsx:apply 等 5. 项目初始化或准备重大变更时 6. 需要生成 proposal、design、tasks 等规范文档时 推荐使用:改进现有项目(棕地开发)、需要高质量实现的关键功能、团队协作开发。 不推荐:快速原型验证(0→1 探索)、一次性小脚本、需求极度不明确的创新探索。
- ▌ Openspec Archive Change · ruan-catArchive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.
- ▌ Openspec Continue Change · ruan-catContinue working on an OpenSpec change by creating the next artifact. Use when the user wants to progress their change, create the next artifact, or continue their workflow.
- ▌ Use Pnpm · ruan-cat bundleUse when 需要处理 pnpm 包管理、workspace 命令、npm/npx/yarn 到 pnpm 的替换、Windows 或 PowerShell pnpm 故障、Corepack 管理的 pnpm、NVM Desktop 切换 Node 后的路径错位、全局包更新、ERR_PNPM_UNEXPECTED_VIRTUAL_STORE、virtual-store-dir 混淆、PNPM_HOME/global-dir/store-dir 诊断,或 pnpm install/update/rebuild 排障;English: handling pnpm package management, workspace commands, npm/npx/yarn replacement, Windows or PowerShell pnpm failures, Corepack-managed pnpm, NVM Desktop Node switches, global package updates, ERR_PNPM_UNEXPECTED_VIRTUAL_STORE, virtual-store-dir confusion, PNPM_HOME/global-dir/store-dir diagnosis, or pnpm install/update/rebuild troubleshooting.
- ▌ Git Commit · ruan-cat bundle创建高质量的 git 提交:审查/暂存预期的变更,拆分为逻辑提交,并编写清晰的提交信息 (遵循 Conventional Commits 规范,支持 Emoji)。当用户要求提交代码、编写提交信息、 暂存变更或将工作拆分为多个提交时使用此技能。当用户提及【破坏性变更】关键词时, 必须按照本技能的 BREAKING CHANGE 规范使用感叹号格式编写提交信息。 优先针对 git 暂存区(staged)中的文件进行提交,只有当暂存区为空时才考虑整个工作树。 当用户提及【分门别类】关键词时,必须按照本技能的多提交拆分规范, 从文件类型、业务模块、修改类型、修改范围四个维度认真拆分多个提交。
- ▌ Init AI Md · ruan-cat bundle初始化、迁移和增量更新项目 AI 记忆文件,以 AGENTS.md 作为唯一事实来源。 通过交互式选择和差异对比,智能补全记忆项内容。触发条件: 当用户提及初始化记忆文件、更新 AGENTS.md、迁移 CLAUDE.md/GEMINI.md、同步 AI 记忆、 init-ai-md 等关键词时主动调用。 Use when initializing, migrating, or incrementally updating project AI memory documents. The skill maintains the canonical root AGENTS.md, redirects CLAUDE.md and GEMINI.md, and manages the project-level record-bug-fix-memory skill.
- ▌ Add Favicon · ruan-cat bundle为文档站、前端站点或 monorepo 内多个站点补全或重做 favicon.svg。用户提到 favicon、浏览器标签页图标、Iconify、Lucide 风格、VitePress/VuePress 文档站、 public/favicon.svg、head link icon、图标太丑/一团浆糊/不要背景块时必须使用; 尤其适合批量为多个 VitePress 站点设计本地 SVG favicon,并显式配置 head。
- ▌ Init Vscode · ruan-cat bundle初始化或更新 VSCode 配置文件(.vscode/extensions.json 和 .vscode/settings.json), 治理扩展推荐的生命周期与已知替代关系,并在 JSONC 安全迁移、工作区/用户级 scope、 preflight/postflight 和可回滚验收之间建立明确边界;同时把 `files.eol` 收敛为 `"\n"`, 配合 `.gitattributes`、`.editorconfig`、Prettier 解决 Windows 上的 CRLF/LF 漂移与 git 幽灵修改问题, 并补齐大型 monorepo 的 VSCode 启动慢、文件监听、搜索索引与 TypeScript Server 性能优化默认值。 只要用户提到初始化 vscode、编辑器配置、工作区设置、扩展替换/弃用迁移、行尾统一、EOL、CRLF/LF、 幽灵修改、团队规范、VSCode 启动慢、大仓库性能、文件监听降噪、搜索索引优化,都应该使用本技能。
- ▌ Install MCP · ruan-catUse when 用户需要盘点、规划或批量安装 MCP 配置,确认各 agent 的配置目标、JSON 或 TOML 形态、合并策略、dry-run、备份或第三方 server entry 时。
- ▌ Rebase2main · ruan-cat将当前开发分支(通常是 dev)的提交通过 git rebase 同步到 main 分支,推送到远端, 然后切回原分支。当用户提及「同步到 main」「rebase 到 main」「更新 main」 「推送到主分支」「把 dev 合到 main」等关键词时使用此技能。 即使用户没有明确说 rebase,只要意图是把开发分支内容同步到 main,就应触发此技能。
- ▌ Openspec Bulk Archive Change · ruan-catArchive multiple completed changes at once. Use when archiving several parallel changes.
- ▌ Do Long Task · ruan-cat bundle当复杂开发、修复、重构、迁移、验证或 OpenSpec change 需要跨 checkpoint 持续推进、上下文恢复, 或需要把进度与失败记录严格存放在具体 OpenSpec change 或 archive 目录内时使用;当用户要求生成 Claude Code `/goal`、Codex `/goal` 或 do-long-task 长任务提示词时也使用。不要用于一次性短改、 问答、简单格式化、changeset、发版日志或纯计划讨论。 Use when a complex development, fix, refactor, migration, verification, or OpenSpec change must be advanced across resumable checkpoints, recovered after context loss, or executed with durable progress and failure notes that stay inside the concrete OpenSpec change or archive directory. Also use when the user asks to generate a Claude Code `/goal`, Codex `/goal`, or do-long-task prompt. Do not use for short one-off edits, Q&A, simple formatting, changesets, release notes, or pure planning.
- ▌ Skill Hardening From Incidents · ruan-cat bundleUse when upgrading, hardening, or creating skills from reports, incident reviews, historical lessons, agent-team feedback, or repeated workflow failures
- ▌ Install Skills · ruan-cat bundleUse when 用户需要安装、卸载、盘点、规划或分发 AI agent skills,确认全局 skills 来源、目录级链接目标、项目级候选目录或特殊安装策略,或排查清除 Kimi Desktop(Daimon)等第三方供应器对全局技能目录的污染时。
- ▌ Pr Ruancat Repo · ruan-cat bundle用于对 ruan-cat 相关仓库执行批量 Pull Request、跨仓库同步改动、为多个已克隆本地仓库规划 PR 策略、选择本地 git/Bash 与 GitHub API/MCP 混合执行方式的场景。触发关键词包括“批量 PR” “多仓库同步改动”“对 ruan-cat 的仓库发 PR”“pr-ruancat-repo”。
- ▌ Use Other Model · ruan-cat bundleUse when the user or agent asks to delegate work to another model/provider such as OpenCode, Claude Code, MiniMax, Gemini, or an independent reviewer; when the goal is token savings, batch or multi-file work, a task expected to run longer than 5 minutes, independent verification or security audit, model-tier routing, provider/model identity checks, OpenCode default/headless model checks, or choosing between MCP tools, an independent Claude Code session, OpenCode provider mode, and OpenCode default/internal-model mode. 当用户或代理要求“使用其他模型/Provider”、节省 token、批量或多文件处理、预计超过 5 分钟的长任务、 独立验证/安全审计、模型分层、provider/model 身份检查、OpenCode 默认/无头模型检查, 或需要在 MCP、独立 Claude Code、OpenCode provider 模式与默认内部模型之间选择时使用。
- ▌ Release AI Plugins · ruan-cat bundleUse when releasing or upgrading the common-tools, dev-skills, or low-frequency-skill plugins, synchronizing Claude/Cursor/Codex manifests and marketplaces, updating CHANGELOG files, validating README and installation-document consistency, or generating/checking the skill-registry.json discovery manifest for Skill Router MCP. 当用户要求插件发布、版本升级、更新日志、manifest、marketplace、README 一致性、 skill-registry.json、MCP skill registry 或 registry stale 校验时使用。
- ▌ Init Shadcn Docs Nuxt · ruan-cat bundleUse when initializing or rebuilding any component-library/project documentation site based on `shadcn-docs-nuxt`, or troubleshooting its Nuxt Content/H3, `nuxt-og-image` Nuxt-generation drift, prerender, SSR externalization, module-compatibility, MDC syntax, or Windows build issues. 适用于初始化或重构任意组件库/项目的 `shadcn-docs-nuxt` 文档站,快速建立可运行、可构建、可维护的 Nuxt 文档底座,或排查配置复杂化、 模块兼容、Nuxt Content/H3 版本漂移、prerender、SSR externalization、MDC 语法错误、 Windows 构建假卡死等故障。触发词包括“搭建组件库文档”“接入 shadcn-docs-nuxt”“重做 Nuxt 文档站”、 “迁移文档模板”以及 Content cache/search API 500、`ERR_INVALID_URL`、`sendError` 导出缺失、 `entities/decode`、`FUNCTION_INVOCATION_FAILED`、Vercel `READY` 但请求失败、`rolldown@nightly` 解析失败、 `@vueuse/core`、`registerMessageResolver`、`prerender:routes` 等错误信号。
- ▌ Init Tsconfig · ruan-cat bundle通过 tsconfig.json 的合理配置降低 VSCode tsserver 的运行时内存占用,附 14 仓库实证策略矩阵与批量落地流程。当用户要求降低 tsserver 或 TypeScript 内存、优化 VSCode/IDE 内存占用、批量治理项目 tsconfig 时使用。
- ▌ Init Pure Admin Iconify · ruan-cat bundle初始化 vite+vue3 项目的 pure-admin 风格 iconify 图标渲染体系 (离线 + 在线 + useRenderIcon 统一渲染)。当用户提及"初始化 iconify" "pure-admin 图标方案""ReIcon/useRenderIcon""离线图标接入" "后台项目图标基础设施"时使用此技能。
- ▌ Get Git Branch · ruan-cat诊断并修复 Git 仓库无法看到所有远程分支的问题,将受限的 fetch refspec 恢复为通配符模式, 使 git fetch 能拉取全部远程分支。当用户提及「看不到远程分支」「分支不全」 「只有 master/main」「fetch 所有分支」「shallow clone 补全分支」 「--single-branch 修复」「远程分支丢失」「获取全部分支」等关键词时使用此技能。 即使用户没有明确提到 refspec 或 shallow clone,只要意图是让仓库能看到并拉取所有远程分支, 就应触发此技能。
- ▌ Init Playwright · ruan-cat在 pnpm monorepo 初始化 Playwright 三件套(@playwright/test + @playwright/cli + playwright-mcp),含 e2e/视觉测试骨架、MCP 配置、AI skills 生成、AI 记忆更新。 内置无头浏览器 CPU 过载事故复盘与故障排查指南:可排查 headless 模式下的 高 CPU 占用(100%)、浏览器卡死、Chromium 进程残留无法退出、 大屏 3D WebGL 渲染性能问题;提供紧急止损步骤和长期回归检查清单。 当用户提及 playwright 初始化、大屏视觉测试、e2e 测试搭建、 playwright monorepo 配置、pw_core/pw_visual MCP 等时触发。 也适用于无头浏览器性能故障排查、headless CPU 100% 诊断、 Chromium 进程残留清理、浏览器进程无法退出处理、 大屏 3D 渲染性能调优等排查场景。
- ▌ Init Prettier Git Hooks · ruan-cat bundleUse when 初始化或纠偏 Node.js 项目的 Prettier、lint-staged、simple-git-hooks、LF 行尾配置,或需要在 GitHub PR 云端任务中安装 Node/pnpm 环境并安全格式化 PR 改动;适用于 prettier-plugin-lint-md 版本漂移、插件加载失败、git hooks、EOL、CRLF/LF 和幽灵修改问题。
- ▌ Clone Ruancat Repo · ruan-cat bundle按固定清单快速克隆 GitHub 用户 ruan-cat 的常用仓库(及 tocque/h5mota-web)到约定目录名, 支持浅克隆与多分支抓取等参数组合。在用户提及「克隆 ruan-cat 仓库」「拉常用仓库」 「clone-ruan-cat」「初始化本地多仓」「同步阮喵喵 GitHub 仓库」或需要一键复现本机仓库存量时使用。 命令清单以 references/clone-commands.md 为唯一真实来源。
- ▌ Init Linux Cloud Agent Env · ruan-cat bundle当用户需要在云 linux 环境内初始化 AI agent 的基础环境时使用本技能:安装 Anthropic Python MCP cli 客户端, 按 templates/mcp.json 安装并验证 github、skill-router-mcp、vercel、Neon 四款 http 类型 MCP, 安装 gh cli 与 vercel cli,并落地基于 github pr 的云任务执行规范(连接器优先级、备份降级、 pr 稿进度工件与阶段收尾汇报)。只要用户提到初始化云 linux 环境、云端 agent 环境、云任务自测自检、 MCP 客户端安装、github MCP 连接失败、skill-router-mcp 等场景,都应该使用本技能。 Use when initializing an AI agent environment on a cloud Linux host: installing the Anthropic Python MCP CLI client, installing and verifying the four HTTP MCP servers (github, skill-router-mcp, vercel, Neon) from templates/mcp.json, installing the gh and vercel CLIs, and following GitHub-PR-based cloud task conventions such as connector priority, fallback ordering, PR-body progress artifacts and stage-close reporting.
- ▌ Init Simple Memorix · ruan-cat bundleUse when 用户提到 init-simple-memorix、Memorix hooks 过多或噪音、项目级或全局 hooks 配置、Memorix MCP 工具缺失、full 模式、WorkBuddy MCP 启动失败、信任审批、Node 参数兼容、setup 或升级后重新精简等场景。
- ▌ Use Vercel Deploy In Monorepo · ruan-cat bundle用于将 pnpm monorepo 或独立仓库部署到一个或多个 Vercel Project,处理 Vercel Git Integration、 本地 link、Project Settings 漂移、Shared Environment Variables、Node 22.x/24.x、 Turbo 任务链、Nitro 产物和 Vercel 部署日志诊断。 Use when deploying pnpm monorepos or standalone repositories to one or more Vercel Projects, including Vercel Git Integration, local linking, Project Settings drift, Shared Environment Variables, Node 22.x/24.x, Turbo task chains, Nitro artifacts, or Vercel deployment-log diagnosis.
- ▌ Sync Local Global Agents Skills · ruan-cat bundleUse when 已完成全局 skills 安装后,需要把 `~/.agents/skills` 后置同步到 WorkBuddy、QoderWork、Kimi Work、CodeBuddy、Qoder 等本地平台,或显式修复本地 skills 链接。 这是后置同步、显式同步和链接修复工具,不是 `skills add` 的替代安装器。 支持 dry-run、自动备份、错误链接替换,并可按需刷新 memorix 内部 skills。 触发关键词:sync-local-global-agents-skills、同步 skills、全局 skills 同步。
- ▌ Init Release Base Relizy And Bumpp · ruan-cat bundleUse when 需要为 pnpm monorepo 从零接入 relizy + bumpp 组合发版方案,或处理 init relizy、init bumpp、接入发版、monorepo 发版初始化、relizy + bumpp、 relizy.config、bump.config、changelog.config、独立版本、GitHub Release 自动化。
- ▌ Cleanup Agent Team Node Processes · ruan-cat bundleUse when Windows or PowerShell agent-team sessions leave suspected stale node, npx, Windows command processor, agent-browser browser or CLI processes, stale MCP or dev-server children provably owned by the current run, lingering listeners, unclear process ownership after multi-agent automation, or unexplained WorkBuddy prewarm pools, MCP subtrees, native agent-browser workers, or shell-snapshot bash processes. 当 Windows 或 PowerShell 的 agent team 会话结束后,出现疑似残留 node / npx / Windows 命令处理程序 / agent browser 浏览器或 CLI 进程、可证明归属当前 run 的残留 MCP 或开发服务器子进程、残留监听器、多代理自动化后的进程归属不清,或无法解释的 WorkBuddy prewarm 池、MCP 子树、原生 agent-browser worker、shell snapshot bash 进程时使用。
- ▌ Init Claude Code Statusline · ruan-cat bundle初始化、更新或覆盖 Claude Code 状态栏配置文件(.claude/settings.json 和 .claude/statusline.sh)。用于在任何项目中快速搭建 Claude Code 状态栏显示功能, 展示目录、Git 分支、模型、版本和上下文窗口使用情况。
- ▌ Factory Reset Vscode Fork Ide · ruan-cat bundle将基于 VSCode 二次开发的 IDE(如 Qoder CN IDE、Trae、Cursor、Windsurf、Cline 类)还原到出厂状态:强制卸载全部导入/内置的 vscode 插件、删除扩展残留文件夹、重置用户级 settings.json / keybindings.json / snippets。当用户提到「还原出厂」「清空插件」「删除导入的 vscode 扩展」「重置 IDE 配置」「二次开发 IDE 清理」「factory reset」「uninstall all extensions」,或给出某个 IDE 安装目录要求删光其插件与个人配置时使用。内置 CLI 选错入口、built-in 扩展拦截、目录找错时的主动探索方案。
- ▌ Cloudbase · ruan-cat bundleUse this skill when you develop, design, build, deploy, debug, migrate, or troubleshoot CloudBase (腾讯云开发, 云开发, TCB, 微信云开发) projects. Covers Web apps (React, Vue, Vite, Next, Nuxt, dashboards, 管理后台), 微信小程序, 小程序, uni-app, native/mobile (iOS, Android, Flutter, React Native) via HTTP API. Includes UI (页面, 界面, 登录页, 表单, form, dashboard, prototype, 原型), auth (登录, 注册, OAuth, 微信登录, publishable key), databases (NoSQL 文档数据库, MySQL, PostgreSQL/CloudBase PG, app.rdb(), queryPgDatabase/managePgDatabase, CRUD, security rules), 云函数 (serverless, scf_bootstrap, HTTP Functions), CloudRun (云托管, Dockerfile), 云存储 (file upload, hosting, 静态托管). Built-in AI (内置大模型, streaming, 流式输出, image generation, 图片生成, generateText, streamText, createModel, generateImage, TokenHub, Hunyuan, hunyuan-exp, DeepSeek, GLM, Token Credits 资源包, 小程序成长计划), 第三方大模型, 大模型接入, 大模型调用, LLM API, chatbot, AI 助手, AI agent, 智能体, AG-UI, LangGraph, LangChain. Ops (巡检, 诊断, health check, 日志, troubleshooting). Spec workflow (需求文档, 技术方案, requirements, tasks.md).
- ▌
- ▌ Neon Postgres · ruan-cat bundleGuides and best practices for working with Neon Serverless Postgres. Covers getting started, local development with Neon, choosing a connection method, Neon features, authentication (@neondatabase/auth), PostgREST-style data API (@neondatabase/neon-js), Neon CLI, and Neon's Platform API/SDKs. Use for any Neon-related questions.
- ▌ Neon DB Query · ruan-cat项目数据库表清单与批量查询工具。提供项目中所有数据库表的完整列表,并支持使用 Neon MCP 批量查询表结构信息(字段、索引、外键),用于数据库结构查询和开发参考。当你需要验证表名、理解数据库结构、检查数据库 Schema 定义、批量查询全部表数据、或为开发和调试获取表结构参考时,必须使用此技能。
- ▌
- ▌ Neon Postgres Zh · ruan-cat bundle使用 Neon Serverless Postgres 的指南和最佳实践。涵盖入门、使用 Neon 进行本地开发、选择连接方式、Neon 功能、身份验证 (@neondatabase/auth)、PostgREST 风格的数据 API (@neondatabase/neon-js)、Neon CLI 以及 Neon 的平台 API/SDK。用于任何与 Neon 相关的问题。
- ▌ Schema Change Sync · ruan-cat数据库 Schema 变更时的全项目同步检查清单。当修改 apps/type 中 schema.ts 的表字段、新增数据库表、或删除表时,使用此技能确保类型项目、数据库迁移、后端接口、前端页面、种子数据和技能文档全部同步更新,避免遗漏。
- ▌ Frontend Development · ruan-cat bundle前端开发指南与模式,涵盖 `apps/admin`(Vue 3 + TypeScript)的页面结构、列表页、表单页、弹窗和 i18n 的最新标准写法。
- ▌ Use Wd Form · ruan-cat使用 wot-design-uni 的 wd-form 组件编写表单页的标准规范 - 提供表单结构、wd-picker 选择器、校验规则、提交处理的完整规范。 触发条件(满足任意一项即触发): - 页面包含 <wd-form> 组件 - 需要实现表单页面(创建、编辑、提交等) - 需要添加选择功能(必须使用 wd-picker 而非 wd-radio-group) - 需要添加表单分区标题(必须使用 FormSectionTitle) - 用户提及"表单"、"wd-form"、"表单校验"、"表单提交"等关键词 - 从 Vue2 迁移表单页面 - 需要实现单选/多选功能(单选用 wd-picker,多选用 wd-checkbox-group) 必须协同的技能: - beautiful-component-design(FormSectionTitle、图标、美化) - api-migration(如果有接口调用) - api-error-handling(如果有接口调用) - code-migration + component-migration(从 Vue2 迁移时) 禁止项: - 禁止使用 wd-radio-group 实现单选(应使用 wd-picker) - 禁止使用 <view class="section-title"> 代替 FormSectionTitle - 禁止 wd-cell 包裹 wd-picker(正确:wd-picker 包裹 wd-cell) - 禁止使用不存在的 #value 插槽 - 禁止单选初始化为数组(应为空字符串) - 禁止多选初始化为字符串(应为空数组) 覆盖场景:维修工单创建、房屋申请、投诉录单、活动报名、用户信息编辑等所有表单页面。
- ▌ Nitro API Development · ruan-cat bundle使用 Nitro v3 框架和 H3 编写服务端 API 的技能。适用于后端接口开发、Mock 数据迁移到 Neon 数据库、以及编写符合 Drizzle ORM 标准的查询逻辑。当需要开发新的 CRUD 接口或修复现有后端逻辑时使用此技能。
- ▌ API Migration · ruan-cat bundle专业的接口迁移与编写专家。从 Java110Context + uni.request 迁移到 Alova + TypeScript,并同时适配当前仓库的 Nitro / Vite mock 双运行时架构。 触发条件(满足任意一项即触发): - 需要新增或修改 `src/api/*.ts` 接口定义 - 需要新增或修改 `server/modules/*/{endpoints,repository}.ts` - 需要为 H5 mock / Nitro 双运行时补齐同一份接口实现 - 需要从旧项目 `examples/gitee-exampl-app/constant/url.js` 迁移接口地址 - 需要维护 `src/api/mock/*.mock.ts` 本地 mock 包装层 - 用户提及“API 迁移”“接口定义”“Nitro 接口”“本地 mock”“useRequest”等关键词 必须协同的技能: - api-error-handling(几乎所有接口调用都需要) - z-paging-integration(分页列表时) - use-wd-form(表单提交时) - code-migration(从 Vue2 页面迁移时) 禁止项: - 禁止为已共享化模块把业务数据和 CRUD 逻辑继续堆回 `src/api/mock/*.mock.ts` - 禁止把迁移后的前端接口统一改成 `/api/**`,应继续兼容旧业务路径 - 禁止在 API 泛型里包裹 `ApiResponse` - 禁止使用 `try/catch` 包装 `send()` - 禁止在 `server/**` 运行时代码中使用 `@/` alias 或省略相对导入 `.ts` 扩展名 - 禁止为了写 H5 mock 再维护一套与 Nitro 分叉的业务实现 覆盖场景:列表、详情、创建、更新、状态流转、字典查询、分页接口,以及双运行时下的接口复用。
- ▌ Project Migration Guide · ruan-cat bundle项目范围迁移的策略和协议,特别关注数据库 schema 和类型系统的影子迁移(Shadow Migration)策略。
- ▌ Project Schema Registry · ruan-cat bundle项目数据库schema架构综合指南,包含架构原则、编写标准(Trinity Pattern)和详细的领域参考。用于定义新表、修改schema或理解数据模型时使用。
- ▌ Code Migration · ruan-cat bundle专注于 Vue2 Options API 到 Vue3 Composition API + TypeScript 的迁移。 触发条件(满足任意一项即触发): - 任务包含"Vue2 到 Vue3"、"Options API"、"Composition API"、"代码迁移"等关键词 - 需要将 Options API(data、methods、computed)转换为 Composition API(ref、reactive、computed) - 需要添加 TypeScript 类型定义 - 需要迁移生命周期钩子(mounted → onMounted) - 需要将 Vuex 迁移到 Pinia - 需要编写组合式函数(Composables) - 需要添加 definePage 页面配置 - 需要处理静态资源导入(@/ 别名 → import) - 从 Vue2 项目迁移页面代码 必须协同的技能: - component-migration(组件迁移)- ColorUI → wot-design-uni - style-migration(样式迁移)- ColorUI 类名 → UnoCSS 原子类 - api-migration(如果有接口)- API 调用 - api-error-handling(如果有接口)- 错误提示 - route-migration(路由迁移)- pages.json → 约定式路由 禁止事项: - 禁止使用 export default {}(必须使用 <script setup lang="ts">) - 禁止使用 this(Composition API 中不存在 this) - 禁止使用 any 类型(必须明确类型) - 禁止在 definePage 中添加 name 或 meta 字段(只使用 style) - 禁止在微信小程序样式中使用 * 通配符选择器 - 禁止在模板中直接使用 @/ 别名字符串(静态资源必须 import) 覆盖场景:几乎所有从 Vue2 迁移到 Vue3 的页面都需要此技能,包括代码结构、响应式数据、生命周期、状态管理等。
- ▌ Schema And Seed Guardian · ruan-cat当你修改数据库结构或种子生成脚本时,请务必阅读并遵循此指南,以防止性能问题、数据一致性崩溃和部署失败。新 Schema 应在 apps/type 中创建。
- ▌ Route Migration · ruan-cat专注于 Vue2 传统路由配置到 Vue3 约定式路由的迁移。 触发条件(满足任意一项即触发): - 任务包含"路由迁移"、"pages.json"、"约定式路由"、"路由配置"等关键词 - 需要从 pages.json 迁移到文件系统路由 - 需要添加 definePage 页面配置 - 需要配置强类型路由系统(TypedRouter) - 需要更新路由跳转代码(uni.navigateTo → TypedRouter) - 需要处理多平台路由适配 - 需要查阅路由迁移映射表(docs/prompts/route-migration-map.yml) - 从 Vue2 项目迁移页面路由 必须协同的技能: - code-migration(代码迁移)- Vue2 → Vue3 代码写法 - component-migration(组件迁移)- ColorUI → wot-design-uni - style-migration(样式迁移)- ColorUI 类名 → UnoCSS 原子类 禁止事项: - 禁止自行决定路由路径(必须查阅映射表) - 禁止使用 uni.navigateTo 字符串拼接(必须使用 TypedRouter) - 禁止在 definePage 中添加 name 字段(只使用 style) - 禁止跳过 definePage 配置(会导致标题显示为 "unibest") - 禁止不更新映射表状态(完成后必须添加 ✅ 标记) 覆盖场景:几乎所有从 Vue2 迁移到 Vue3 的页面都需要此技能,包括路由配置、页面跳转、参数传递等。
- ▌ Style Migration · ruan-cat bundle专注于 ColorUI 到 UnoCSS + wot-design-uni 的样式系统迁移,从传统 CSS 框架到现代化原子 CSS。 触发条件(满足任意一项即触发): - 任务包含"样式迁移"、"ColorUI"、"UnoCSS"、"原子 CSS"等关键词 - 需要将 ColorUI 类名(cu-btn、cu-list、cu-card)迁移到 UnoCSS 原子类 - 需要将 SCSS 变量迁移到 UnoCSS 主题配置 - 需要将固定像素(20px)转换为响应式单位(20rpx) - 需要迁移渐变背景(bg-gradual-* → bg-gradient-to-*) - 需要迁移间距样式(margin-xs → m-10rpx) - 需要迁移圆角样式(radius-sm → rounded-8rpx) - 从 Vue2 项目迁移页面样式 必须协同的技能: - component-migration(组件迁移)- ColorUI → wot-design-uni - code-migration(代码迁移)- Vue2 → Vue3 代码写法 - beautiful-component-design(可选)- 样式美化 禁止事项: - 禁止滥用 UnoCSS shortcuts 功能(不要将业务样式写入 uno.config.ts) - 禁止将 ColorUI 类名直接转为 shortcuts(应展开为原子类) - 禁止在微信小程序样式中使用 * 通配符选择器 - 禁止使用 UnoCSS 的 space-y-* / space-x-* 类(微信小程序不支持) - 禁止使用 UnoCSS 的 divide-y-* / divide-x-* 类(微信小程序不支持) - 禁止使用复杂的 :nth-child() 选择器(如 n+2, 3n+1) - 禁止使用 :not() 伪类选择器(特别是 :not([hidden])) 覆盖场景:几乎所有从 Vue2 迁移到 Vue3 的页面都需要此技能,包括布局、颜色、间距、形状、渐变等样式。
- ▌ Type Project Organization · ruan-cat bundle规范类型项目(apps/type)的代码组织方式、导出语法和文件结构。用于解决类型导出冲突、创建统一导出入口、处理重复导出等问题。适用于类型项目开发、类型错误修复、代码规范实施场景。在处理类型项目的代码写法时,请使用本技能。
- ▌ Add New Component · ruan-cat新建公共组件规范专家 - 指导在 src/components/common 目录下创建符合项目规范的公共组件,包括文件结构、TypeScript 类型、Vue 组件、文档和测试页面。 触发条件(满足任意一项即触发): - 任务包含"新建组件"、"公共组件"、"common 组件"、"创建组件"等关键词 - 需要在 src/components/common 目录下创建新组件 - 需要创建可复用的业务组件(如表单分区标题、操作按钮组、信息展示卡片) - 需要编写组件的 TypeScript 类型定义 - 需要编写组件使用文档(index.md) - 需要创建组件测试页面(src/pages/test-use/) - 用户提及"组件规范"、"组件文档"、"组件测试"等关键词 必须协同的技能: - beautiful-component-design(组件美化时)- 图标、响应式设计、表单分区标题 - component-migration(从旧组件迁移时)- ColorUI → wot-design-uni - use-wd-form(组件内包含表单时)- 表单结构、wd-picker、校验规则 禁止事项: - 禁止在 components 目录外创建公共组件 - 禁止不编写组件文档(index.md) - 禁止不提供使用示例和测试页面 - 禁止组件命名不规范(必须使用短横线命名法) - 禁止不定义 TypeScript 类型(types.ts) - 禁止在组件文件顶部不添加说明注释 - 禁止不使用 withDefaults 设置 props 默认值 覆盖场景:所有需要跨页面复用的业务组件,包括表单分区标题(FormSectionTitle)、操作按钮组(ActivityActions)、信息展示卡片(ActivityInfo)、加载状态组件(ZPagingLoading)等。
- ▌ API Error Handling · ruan-cat接口错误提示能力 - 提供统一的接口错误提示标准和实施方案,基于 wot-design-uni 和 Alova useRequest 回调模式。 触发条件(满足任意一项即触发): - 编写任何 API 接口调用代码(使用 useRequest) - 处理 useRequest 的 onError 回调 - 实现全局错误拦截逻辑 - 用户提及"接口错误提示"、"错误处理"、"Toast 提示"等关键词 - 从 Vue2 迁移 API 调用(需要添加错误处理) - 实现表单提交、列表加载等涉及 API 的功能 必须协同的技能: - api-migration(API 接口迁移时) - z-paging-integration(分页列表时) - use-wd-form(表单提交时) 禁止项: - 禁止使用 try/catch 包装 send() 函数 - 禁止在组件内手动显示错误 Toast(全局拦截器已处理) - 禁止使用 immediate: true(必须手动触发请求) - 禁止在 onError 中重复显示错误提示 覆盖场景:几乎所有 API 调用都需要此技能,包括列表查询、详情查询、表单提交、数据删除、状态更新等。
- ▌ Component Migration · ruan-cat bundle专业的 uni-app 组件迁移专家,从 ColorUI + uni-app 内置组件到 wot-design-uni 组件库的迁移。 触发条件(满足任意一项即触发): - 任务包含"组件迁移"、"ColorUI"、"wot-design-uni"等关键词 - 需要将 ColorUI 组件(cu-btn、cu-list、cu-card)迁移到 wot-design-uni - 需要修复 wot-design-uni 组件使用错误(类型错误、插槽错误、嵌套顺序错误) - 需要迁移 Icon 图标(cuIcon-* → i-carbon-*) - 需要迁移表单组件(cu-form → wd-form) - 需要迁移空状态组件(no-data-page → wd-status-tip) - 需要迁移图片组件(image → wd-img) - 从 Vue2 项目迁移页面组件 必须协同的技能: - use-wd-form(表单页面迁移时,必须)- 表单结构、wd-picker、校验规则 - beautiful-component-design(表单页面迁移时,必须)- FormSectionTitle、图标、美化 - api-migration(如果有接口)- API 调用 - api-error-handling(如果有接口)- 错误提示 - style-migration(样式迁移)- ColorUI 类名 → UnoCSS 原子类 - code-migration(Vue2 迁移)- Options API → Composition API 禁止事项: - 禁止使用 wd-empty 组件(不存在,必须使用 wd-status-tip) - 禁止使用 wd-cell 的 #value 插槽(不存在) - 禁止使用 wd-radio-group 替代 wd-picker(除非动态场景) - 禁止在子组件内直接使用 <wd-toast />、<wd-message-box />(必须使用全局组合式函数) - 禁止跳过 beautiful-component-design 技能(表单页面必须使用) 覆盖场景:几乎所有从 Vue2 迁移到 Vue3 的组件都需要此技能,包括按钮、列表、卡片、表单、图标、空状态等。
- ▌ Auth Web Cloudbase · ruan-catCloudBase Web Authentication Quick Guide for frontend integration after auth-tool has already been checked. Provides concise and practical Web authentication solutions with multiple login methods and complete user management.
- ▌ HTTP API Cloudbase · ruan-cat bundleCloudBase official HTTP API client guide. This skill should be used when backends, scripts, or non-SDK clients must call CloudBase platform APIs over raw HTTP instead of using a platform SDK or MCP management tool.
- ▌ Record Bug Fix Memory · ruan-cat bundle当用户要求在 bug 已经定位并修复后,记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么",不要把它用于实际修复 bug。
- ▌ Z Paging Integration · ruan-catz-paging 分页组件与 api-migration 适配方案 - 提供 z-paging 与 useRequest 回调钩子模式的正确集成方式。 触发条件(满足任意一项即触发): - 页面包含 <z-paging> 组件 - 需要实现列表分页功能(工单列表、房屋列表、活动列表等) - 用户提及"分页"、"列表加载"、"上拉加载"、"下拉刷新"等关键词 - 从 Vue2 迁移分页列表页面 - 需要实现筛选条件 + 分页的组合功能 - 修复 z-paging 相关错误(无限循环、无法加载等) 必须协同的技能(强制组合): - api-migration(API 接口调用) - api-error-handling(错误提示处理) - beautiful-component-design(可选,列表项美化) 禁止项: - 禁止在 @query 回调中使用 try/catch - 禁止在 @query 回调中调用 refresh()/reload()(会导致无限循环) - 禁止同时使用 :query 属性和 @query 事件 - 禁止使用 @query 时设置 :auto="false" - 禁止重复配置全局已配置的 props(default-page-size、refresher-enabled 等) - 禁止忘记调用 complete() 方法 覆盖场景:维修工单列表、房屋申请列表、活动列表、投诉列表、选择器列表等所有需要分页的列表页面。
- ▌ Auth Tool Cloudbase · ruan-cat bundleCloudBase auth provider configuration and login-readiness guide. This skill should be used when users need to inspect, enable, disable, or configure auth providers, publishable-key prerequisites, login methods, SMS/email sender setup, or other provider-side readiness before implementing a client or backend auth flow.
- ▌ UI Design · ruan-cat bundleUse when users need visual direction, interface hierarchy, layout decisions, design specifications, or prototypes before implementing a Web or mini program UI.
- ▌ Backend Nitro Drizzle · ruan-cat bundleNitro v3 + Neon + Drizzle 后端开发技能。指导如何使用 Nitro v3 构建独立后端服务,配合 Neon Postgres 和 Drizzle ORM 实现类型安全的数据库操作。适用于智慧社区物业管理系统后端开发。
- ▌ Auth Nodejs Cloudbase · ruan-catCloudBase Node SDK auth guide for server-side identity, user lookup, and custom login tickets. This skill should be used when Node.js code must read caller identity, inspect end users, or bridge an existing user system into CloudBase; not when configuring providers or building client login UI.
- ▌ Auth Wechat Miniprogram · ruan-catCloudBase WeChat Mini Program native authentication guide. This skill should be used when users need mini program identity handling, OPENID/UNIONID access, or `wx.cloud` auth behavior in projects where login is native and automatic.
- ▌ AI Model Web · ruan-catUse this skill when a browser/Web app (React, Vue, Angular, Next, Nuxt, static sites, SPAs, dashboards, AI chat UI) needs AI models via @cloudbase/js-sdk. Default routing for page/页面/Web/前端/frontend/网页/H5 AI — call directly from browser, do NOT propose a Node.js proxy. Covers generateText and streamText. Models via ai.createModel with groups cloudbase, hunyuan-exp, or custom-*. Model IDs (deepseek-v4-flash, deepseek-v3.2, hunyuan-2.0-instruct-20251111, glm-5, kimi-k2.6) go in the model field. MUST run two-step preflight before code — see body. Keywords: 页面, Web, 前端, React, Vue, Next, Nuxt, SPA, AI chat UI, generateText, streamText, createModel, hunyuan-exp, Token Credits, TokenHub, Hunyuan, DeepSeek, GLM, Kimi, MiniMax. NOT for Node.js backend (use ai-model-nodejs), Mini Program (use ai-model-wechat), or image generation (Node SDK only).
- ▌ Cloudbase CLI · ruan-cat bundleCloudBase CLI (tcb, 云开发CLI, Tencent CloudBase命令行) resource management skill. This skill should be used when users need to deploy cloud functions, manage CloudRun apps, upload files to storage, query NoSQL/MySQL databases, deploy static hosting, set access permissions, or configure CORS/domains/routing via tcb commands. Also use for CI/CD pipeline scripting, batch operations, terminal-based CloudBase management, or when the user prefers CLI over SDK/MCP.
- ▌ Ops Inspector · ruan-catAIOps-style one-click inspection skill for CloudBase resources. Use this skill when users need to diagnose errors, check resource health, inspect logs, or run a comprehensive health check across cloud functions, CloudRun services, databases, and other CloudBase resources.
- ▌ Cloudbase Document Database Web Sdk · ruan-cat bundleUse CloudBase document database Web SDK only for confirmed NoSQL collection work. Query, create, update, and delete document data; if the task mentions PostgreSQL / CloudBase PG / app.rdb(), route to postgresql-development instead.
- ▌ Beautiful Component Design · ruan-cat bundle移动端 uni-app + wot-design-uni 组件美化规范 - 提供图标、文本对齐、响应式设计、表单分区标题、选择器美化、弹框交互的完整规范。 触发条件(满足任意一项即触发): - 需要添加 FormSectionTitle 组件(表单分区标题) - 需要使用 Carbon Icons 图标 - 需要实现响应式设计(rpx 单位、图片网格) - 需要美化选择器组件(wd-picker) - 需要实现弹框交互(wd-message-box、wd-popup) - 需要美化详情页卡片(通栏标题 + 色彩编码) - 用户提及"美化"、"图标"、"对齐"、"响应式"、"FormSectionTitle"等关键词 - 修复组件嵌套顺序错误(wd-picker 和 wd-cell) - 修复插槽使用错误(#value 插槽不存在) 必须协同的技能: - use-wd-form(表单页面必须协同) - api-migration(如果有接口调用) - api-error-handling(如果有接口调用) - z-paging-integration(列表页面美化) 禁止项: - 禁止使用 <view class="section-title"> 代替 FormSectionTitle - 禁止 wd-cell 包裹 wd-picker(正确:wd-picker 包裹 wd-cell) - 禁止使用不存在的 #value 插槽(wd-cell 没有此插槽) - 禁止使用 wd-popup 实现标准交互(应使用 wd-message-box) - 禁止在详情页卡片容器保留 padding(应移除以实现通栏标题) 覆盖场景:表单页面、详情页面、列表页面、选择器页面、弹框交互、图标使用、响应式布局等所有需要美化的场景。
- ▌ AI Model Nodejs · ruan-catUse this skill for Node.js backend AI via @cloudbase/node-sdk (>=3.16.0) — cloud functions, CloudRun, Express, Koa, NestJS, serverless APIs, scheduled jobs, LLM proxies. Only SDK supporting image generation (ai.createImageModel + generateImage). Text models via ai.createModel with groups cloudbase, hunyuan-exp, or custom-*. Model IDs (deepseek-v4-flash, deepseek-v3.2, hunyuan-2.0-instruct-20251111, glm-5, kimi-k2.6) go in the model field of generateText/streamText. MUST run two-step preflight before code — see body. Keywords: backend, 云函数, 云托管, serverless, LLM proxy, agent orchestration, generateText, streamText, generateImage, createModel, hunyuan-image, Token Credits, TokenHub, Hunyuan, DeepSeek, GLM, Kimi, MiniMax. NOT for browser/Web (use ai-model-web) or Mini Program (use ai-model-wechat).
- ▌ AI Model Wechat · ruan-catUse this skill for WeChat Mini Program AI via wx.cloud.extend.AI (小程序, 企业微信小程序, wx.cloud apps). Features generateText and streamText with callbacks (onText, onEvent, onFinish). Models via wx.cloud.extend.AI.createModel with groups hunyuan-exp (小程序成长计划), cloudbase (main managed), or custom-*. Model IDs (deepseek-v4-flash, deepseek-v3.2, hunyuan-2.0-instruct-20251111, glm-5, kimi-k2.6) go in the data wrapper model field. API differs from JS/Node SDK — streamText needs data wrapper, generateText returns raw response. MUST run two-step preflight before code — see body. Keywords: Mini Program AI, wx.cloud.extend.AI, 小程序成长计划, ai_miniprogram_inspire_plan, Token Credits 资源包, generateText, streamText, createModel, hunyuan-exp, TokenHub, Hunyuan, DeepSeek, GLM, Kimi, MiniMax. NOT for browser/Web (use ai-model-web), Node.js backend (use ai-model-nodejs), or image generation (use ai-model-nodejs).
- ▌ Cloud Functions · ruan-cat bundleCloudBase function runtime guide for building, deploying, and debugging your own Event Functions or HTTP Functions. This skill should be used when users need application runtime code on CloudBase, not when they are merely calling CloudBase official platform APIs.
- ▌ Cloudbase Agent · ruan-catBuild and deploy AI agents with CloudBase Agent SDK (TypeScript & Python). Implements the AG-UI protocol for streaming agent-UI communication. Use when deploying agent servers, using LangGraph/LangChain/CrewAI adapters, building custom adapters, understanding AG-UI protocol events, or building web/mini-program UI clients. Supports both TypeScript (@cloudbase/agent-server) and Python (cloudbase-agent-server via FastAPI).
- ▌ Web Development · ruan-cat bundleUse when users need to implement, integrate, debug, build, deploy, or validate a Web frontend after the product direction is already clear, especially for React, Vue, Vite, browser flows, or CloudBase Web integration.
- ▌ Wechat Cloud Mini Program Deployment · ruan-cat项目级微信云小程序部署指南。用于处理微信小程序、CloudBase、miniprogram-ci、预览、上传、合法域名和云开发环境关联相关任务。
- ▌ Cloudbase Document Database In Wechat Miniprogram · ruan-cat bundleUse CloudBase document database WeChat MiniProgram SDK to query, create, update, and delete data. Supports complex queries, pagination, aggregation, and geolocation queries.
- ▌ Cloud Storage Web · ruan-catComplete guide for CloudBase cloud storage using Web SDK (@cloudbase/js-sdk) - upload, download, temporary URLs, file management, and best practices.
- ▌ Use Uniapp Dynamic Page Title · ruan-catuni-app 动态页面标题设置专家 - 根据路由参数或业务状态动态设置页面标题,使用 uni.setNavigationBarTitle API。 触发条件(满足任意一项即触发): - 任务包含"动态标题"、"页面标题"、"navigationBarTitleText"、"setNavigationBarTitle"等关键词 - 需要根据路由参数动态设置页面标题(如显示工单编号、房屋地址) - 需要根据业务状态动态更新标题(如派单/转单显示不同标题) - 从 Vue2 迁移需要动态标题的页面 - 实现详情页、编辑页、审核页等需要显示动态信息的标题 - 页面标题需要根据数据加载后的内容变化 - 需要在不同操作模式下显示不同标题(查看/编辑/审核) 必须协同的技能: - route-migration(路由迁移时)- 确保路由参数正确传递 - code-migration(Vue2 迁移时)- Options API → Composition API - api-migration(需要从接口获取标题数据时)- API 调用规范 禁止事项: - 禁止在 pages.json 中硬编码动态标题 - 禁止使用 uni.setNavigationBarTitle 的回调形式(应使用 Promise 或直接调用) - 禁止在 onLoad 之外的生命周期钩子中设置初始标题 - 禁止不处理标题设置失败的情况 - 禁止标题过长不做截断处理 覆盖场景:几乎所有需要根据数据动态显示标题的页面,包括详情页(显示编号/名称)、编辑页(显示操作类型)、审核页(显示审核状态)、表单页(显示创建/修改模式)等。
- ▌ Cloudbase Agent Python · ruan-cat bundleBuild production-ready AI agent backends using the CloudBase Agent Python SDK — create agents with LangGraph/CrewAI/LlamaIndex, serve them via FastAPI with AG-UI protocol streaming + OpenAI-compatible endpoints, add tools (bash, filesystem, MCP, code execution), memory (in-memory, TDAI, MySQL, MongoDB), observability (OpenTelemetry/Langfuse), and middleware (auth, logging). Use this skill when the user wants to create an AI agent server, build a chatbot backend, set up human-in-the-loop workflows, integrate MCP tools, add agent observability, or deploy an agent API — even if they don't explicitly mention 'CloudBase Agent.'
- ▌ Cloudbase Platform · ruan-cat bundleCloudBase platform overview and routing guide. This skill should be used when users need high-level capability selection, platform concepts, console navigation, or cross-platform best practices before choosing a more specific implementation skill.
- ▌ Data Model Creation · ruan-catOptional advanced tool for complex data modeling. For simple MySQL table creation, use relational-database-tool directly; for PostgreSQL / CloudBase PG schema work, use postgresql-development.
- ▌ Cloudrun Development · ruan-catCloudBase Run backend development rules (Function mode/Container mode). Use this skill when deploying backend services that require long connections, multi-language support, custom environments, or AI agent development.
- ▌ Cloudbase Code Review · ruan-cat bundleCode review and validation for CloudBase projects. After writing code for Web / miniprogram / CloudRun / cloud-function projects, call this skill to check for known pitfalls — auth guard misuse, missing database tables, RLS misconfiguration, storage domain setup, and SDK API misuse. Supports automated lint scripts (regex-based) + LLM semantic review.
- ▌ Postgresql Development Cloudbase · ruan-cat bundleUse when building, debugging, or evaluating CloudBase PostgreSQL / CloudBase PG / PG mode apps, including Postgres schema setup, queryPgDatabase/managePgDatabase, JS SDK v3 app.rdb() CRUD/RPC, PG HTTP API fallback, RLS-style permissions, username-password auth, and Web CMS/admin CRUD flows backed by CloudBase PG.
- ▌ Miniprogram Development · ruan-cat bundleWeChat Mini Program development skill for building, debugging, previewing, testing, publishing, and optimizing mini program projects. This skill should be used when users ask to create, develop, modify, debug, preview, test, deploy, publish, launch, review, or optimize WeChat Mini Programs, mini program pages, components, `tabBar`, routing, navigation, icon assets, project structure, project configuration, `project.config.json`, `appid` setup, device preview, real-device validation, WeChat Developer Tools workflows, `miniprogram-ci` preview/upload flows, or mini program release processes. It should also be used when users explicitly mention CloudBase, `wx.cloud`, Tencent CloudBase, 腾讯云开发, or 云开发 in a mini program project.
- ▌ Relational Database Web Cloudbase · ruan-catUse when building frontend Web apps that talk to CloudBase Relational Database via @cloudbase/js-sdk – provides the canonical init pattern so you can then use Supabase-style queries from the browser.
- ▌ Relational Database MCP Cloudbase · ruan-catThis is the required documentation for agents operating on the CloudBase Relational Database through MCP. It defines the canonical SQL management flow with `queryMysqlDatabase`, `manageMysqlDatabase`, `queryPermissions`, and `managePermissions`, including MySQL provisioning, destroy flow, async status checks, safe query execution, schema initialization, and permission updates.
- ▌ Cloudbase Wechat Integration · ruan-cat bundleCloudBase WeChat integration guide for Mini Program WeChat Pay, Official Account JSAPI Pay, Native QR-code Pay, Official Account OAuth, openid handling, payment callbacks, and CloudBase Integration Center generated functions. This skill should be used when users ask to add, debug, or extend WeChat payment or official-account flows on CloudBase.