knowledge-base

发布 Tauri 桌面应用新版本，处理版本号同步、Git tag、GitHub Actions 构建、Release 仓库产物同步、Cloudflare R2 上传、update.json 生成、自动更新发布和文档站重建。 触发场景： - 需要发布新版本或 release - 需要打 tag、推送发布分支或触发 CI 构建 - 需要生成或更新 update.json - 需要处理 Tauri updater 签名产物 - 需要同步 R2 CDN、GitHub/Gitee release 仓库或发布安装包 触发词：发布、release、版本发布、推送、打Tag、update.json、签名构建、安装包、自动更新、R2、CDN

Git 工作流与版本管理技能，规范分支策略、提交信息和发布流程。 触发场景： - 用户需要创建分支或合并代码 - 用户需要规范提交信息格式 - 用户需要管理版本发布流程 触发词：Git、分支、提交、合并、版本发布

Git 工作流与版本管理技能，规范分支策略、提交信息和发布流程。 触发场景： - 用户需要创建分支或合并代码 - 用户需要规范提交信息格式 - 用户需要管理版本发布流程 触发词：Git、分支、提交、合并、版本发布

自主连续开发方法论（Codex 版）。把一个项目按「每轮一个最小可提交单元」的方式推进到完成： 每轮读真相源 → 选下一个未做项 → 做一个最小单元 → 过验证门 → 记录勾选 → 最小提交 → 报进度。 适用于"按需求/台账建功能、还原原型、修一批 bug、补测试、重构、迁移、清理"等需要反复同构推进的任务。 与 Claude Code 的关系：Claude Code 有内置 `/loop` 自动续期（`/loop /dev-loop`），Codex 没有—— 所以 Codex 端由你（或脚本 / cron）反复触发"继续下一轮"，方法论本身一致。 触发场景： - 想让 Codex 把某个项目/某个意图"一轮轮推进到完成" - 还原原型图、修一批 warning、补单测、重构模块等同构重复任务 - 需要"每步可编译、可回退、可恢复"的稳健推进方式 触发词：自主开发、连续开发、循环开发、一轮一提交、还原原型、批量修复、autonomous dev、continuous dev

Tauri 打包与分发技能,指导桌面端（Windows/macOS/Linux）与移动端（Android/iOS）的构建、签名和分发。 触发场景: - 需要构建生产安装包（exe/dmg/deb/apk/aab/ipa） - 需要配置各平台打包参数 - 需要代码签名（Windows 证书 / Android keystore / iOS 描述文件） - 需要减小安装包体积 - 需要设置应用图标和元数据 - 需要打包 Android / iOS App 触发词: 打包、构建、build、发布、安装包、exe、dmg、deb、apk、aab、ipa、签名、分发、release、android build、ios build、移动端打包

排查已发生的问题、定位 Bug 原因。 触发场景： - 代码运行报错，需要定位原因 - 功能不正常，需要排查 - Tauri Command 返回错误，需要分析 - 日志分析、调试代码 触发词：Bug、报错、不工作、调试、排查、为什么、出问题、失败、不生效、无效、找不到原因、定位问题

排查已发生的问题、定位 Bug 原因。 触发场景： - 代码运行报错，需要定位原因 - 功能不正常，需要排查 - Tauri Command 返回错误，需要分析 - 日志分析、调试代码 触发词：Bug、报错、不工作、调试、排查、为什么、出问题、失败、不生效、无效、找不到原因、定位问题

Tauri 打包与分发技能,指导跨平台安装包构建、签名和分发。 触发场景: - 需要构建生产安装包 - 需要配置各平台打包参数 - 需要代码签名 - 需要减小安装包体积 - 需要设置应用图标和元数据 触发词: 打包、构建、build、发布、安装包、exe、dmg、deb、签名、分发、release

Tauri Command (IPC API) 开发技能，指导如何设计和实现 Rust Command 供前端调用。 触发场景： - 需要创建新的 Tauri Command - 需要设计前后端通信接口 - 需要处理 Command 的参数和返回值 - 需要实现异步 Command 触发词：Command、API、invoke、IPC、接口、通信、前后端

Tauri 架构设计技能，指导双进程架构下的模块拆分和代码组织。 触发场景： - 需要设计新模块的架构 - 需要重构现有代码结构 - 需要决定功能放在 Rust 还是 React 侧 - 需要设计插件集成方案 触发词：架构、设计、模块、拆分、重构、组织、结构

当需要探索方案、头脑风暴、创意思维时自动使用此 Skill。 触发场景： - 不知道怎么设计 - 需要多种方案 - 架构讨论 - 功能规划 触发词：头脑风暴、方案、怎么设计、有什么办法、创意、讨论、探索、建议、怎么做、如何实现

代码模式与最佳实践技能，提供 Tauri 项目中常用的设计模式和编码规范。 触发场景： - 用户需要了解项目的编码规范 - 用户需要应用设计模式解决问题 - 用户需要重构代码以符合最佳实践 触发词：设计模式、编码规范、最佳实践、代码风格、重构

与 OpenAI Codex CLI 协同开发。将编码任务委托给 Codex 进行原型开发、调试分析和代码审查。 触发场景： - 需要算法实现或复杂逻辑分析 - 需要代码审查和 Bug 分析 - 需要生成 Unified Diff 补丁 - 用户明确要求使用 Codex 协作 - 复杂后端逻辑的原型设计 触发词：Codex、协作、多模型、原型、Diff、算法分析、代码审查、codex协同 前置要求： - 已安装 Codex CLI (npm install -g @openai/codex) - 已配置 OpenAI API Key

与 Google Gemini CLI 协同开发。将编码任务委托给 Gemini 进行前端原型、UI设计和代码审查。 触发场景： - 需要前端/UI/样式原型设计 - 需要 CSS/React/Vue 组件设计 - 需要代码审查和 Bug 分析 - 用户明确要求使用 Gemini 协作 - 复杂前端逻辑的原型设计 触发词：Gemini、协作、多模型、前端原型、UI设计、CSS、样式、gemini协同 前置要求： - 已安装 Gemini CLI (npm install -g @google/gemini-cli) - 已配置 Google API Key (GEMINI_API_KEY 环境变量或 gemini auth login) 注意：Gemini 对后端逻辑理解有缺陷，后端任务优先使用 Codex。

Tauri 本地数据库操作技能，使用 rusqlite 进行 SQLite 数据库操作。 触发场景： - 需要在桌面应用中持久化数据 - 需要使用 SQLite 数据库 - 需要设计本地数据表结构 - 需要执行 CRUD 数据库操作 触发词：数据库、SQLite、SQL、持久化、存储、表、查询、CRUD、数据

VitePress 文档站点管理技能。负责初始化文档站点、增量同步代码变更到文档、追踪同步元数据（.docs-meta.json），生成的文档风格模仿同目录 tauri-docs / tauri-cc-docs / knowledge-base-docs。 触发场景： - 需要为项目生成对外文档站点（VitePress） - 需要基于代码变更增量更新已有文档 - 需要从零初始化独立 docs 仓库（同级目录） - 需要在本项目内部生成 ./website/ 文档 - 需要检查文档同步状态（.docs-meta.json） 触发词：文档站点、VitePress、docs 站点、用户手册、更新文档、文档同步、docs-management、.docs-meta.json、website 目录、文档仓库

Tauri 异常处理技能，覆盖 Rust 错误处理和 React 错误边界。 触发场景： - 需要设计错误处理策略 - 需要处理 Rust Command 中的错误 - 需要处理前端 invoke 调用失败 - 需要实现全局错误处理 触发词：异常、错误处理、Error、Result、try-catch、panic、崩溃、错误边界

Tauri 文件操作技能,覆盖 Rust std::fs 和 Tauri FS Plugin 的文件读写。 触发场景: - 需要读写本地文件 - 需要选择文件/目录(对话框) - 需要管理应用数据目录 - 需要处理文件拖放 触发词: 文件、读写、保存、打开、目录、文件系统、fs、拖放、导入、导出

Tauri 国际化开发技能，使用 react-i18next 实现多语言支持。 触发场景： - 需要为应用添加多语言支持 - 需要管理翻译资源文件 - 需要实现语言切换功能 - 需要格式化日期/数字/货币 触发词：国际化、i18n、多语言、翻译、语言切换、本地化、l10n

Tauri 项目中 JSON 序列化/反序列化技能，覆盖 Rust serde 和 TypeScript 类型系统。 触发场景： - 需要定义 Rust 和 TypeScript 之间的数据传输类型 - 需要处理 JSON 序列化/反序列化 - 需要处理复杂嵌套数据结构 - serde 配置和自定义序列化 触发词：JSON、序列化、serde、类型转换、数据传输、Serialize、Deserialize

Tauri 系统通知技能，使用 tauri-plugin-notification 发送原生系统通知。 触发场景： - 需要发送系统级通知 - 需要在后台任务完成时提醒用户 - 需要实现消息提示功能 - 需要处理通知的点击和交互 触发词：通知、notification、提醒、消息、toast、系统通知、桌面通知

Tauri 性能诊断技能，覆盖 Rust 编译优化、前端性能和应用体积优化。 触发场景： - 应用启动慢或运行卡顿 - 需要优化 Rust 编译时间 - 需要减小安装包体积 - 需要分析前端渲染性能 触发词：性能、优化、慢、卡顿、编译时间、体积、内存、CPU、profiling、启动速度

当用户需要基于本 Tauri 框架创建新项目时自动使用此 Skill。提供完整的交互式项目初始化流程：模板更新检测、项目信息收集、目录创建、标识符替换、Git 仓库创建、签名密钥生成、启动引导。 触发场景： - 用户说"我要开发一个新项目"或"创建一个新项目" - 需要基于 Tauri 框架模板初始化新的桌面应用 - 需要修改项目标识符、名称和配置 - 需要为新项目创建 Git 仓库并推送代码 触发词：新项目、创建项目、初始化项目、开新项目、项目初始化、new project、init project、新建项目、开发新项目

Tauri 项目导航技能，快速定位代码、理解项目结构、找到关键文件。 触发场景： - 需要了解项目整体结构 - 需要快速找到某个功能的代码位置 - 需要理解 Rust 和 React 代码的关系 - 新加入项目需要熟悉代码 触发词：项目结构、在哪里、怎么找、代码位置、目录、文件、导航、定位

Rust 语言基础技能,覆盖 Tauri 开发中常用的 Rust 核心概念。 触发场景: - 遇到 Rust 编译错误(所有权/借用/生命周期) - 需要理解 Rust 语法和概念 - 需要编写 Rust 数据结构和函数 - 需要使用 Rust 异步编程 触发词: Rust、所有权、借用、生命周期、编译错误、borrow、move、lifetime、async、trait

Tauri 安全与权限管理技能,指导 Capabilities 配置和安全最佳实践。 触发场景: - 需要配置 Capabilities 权限 - 需要理解 Tauri 安全模型 - 需要处理 CSP(内容安全策略) - 功能不可用可能是权限问题 触发词: 权限、Capabilities、安全、CSP、permission、安全策略、sandbox

Tauri 状态管理技能,覆盖 React 前端状态和 Rust 后端状态管理。 触发场景: - 需要管理前端组件间共享状态 - 需要在 Rust 后端管理应用状态 - 需要持久化存储(tauri-plugin-store) - 需要设计全局状态架构 触发词: 状态管理、state、store、全局状态、共享状态、Zustand、Context、持久化

任务跟踪与进度管理技能，管理开发任务的创建、分解、状态更新和归档。 触发场景： - 用户需要创建或查看开发任务 - 用户需要更新任务进度或状态 - 用户需要归档已完成的任务 触发词：任务、进度、待办、TODO、跟踪

Tauri Capabilities 深度配置技能，指导高级权限管理、作用域控制和多窗口权限差异化。 触发场景： - 需要精确控制 API 访问权限 - 需要限制文件访问作用域 - 需要为不同窗口配置不同权限 - 需要自定义 Capability 权限组 触发词：Capabilities、权限配置、作用域、scope、精细权限、安全配置

Tauri Command 高级开发技能，覆盖异步 Command、状态注入、流式传输、事件通知等高级模式。 触发场景： - 需要开发复杂的 Tauri Command - 需要 Command 中访问 AppHandle/Window - 需要实现进度回报/流式数据 - 需要 Command 之间共享逻辑 触发词：Command、tauri::command、invoke、高级Command、async command、进度、stream

Tauri 事件系统技能,实现前后端双向事件通信。 触发场景: - 需要从 Rust 向前端推送数据 - 需要实现实时数据更新 - 需要窗口间通信 - 需要监听系统事件 触发词: 事件、event、emit、listen、推送、实时更新、通知、窗口通信

Tauri 插件开发与集成技能，指导如何使用官方插件和开发自定义插件。 触发场景： - 需要集成 Tauri 官方插件 - 需要开发自定义 Tauri 插件 - 需要理解插件的安装和配置流程 - 需要排查插件不可用的问题 触发词：插件、plugin、tauri-plugin、集成、扩展、第三方

Tauri 应用自动更新技能,使用 tauri-plugin-updater 实现版本更新。 触发场景: - 需要实现应用自动更新 - 需要配置更新服务器 - 需要处理更新 UI 和流程 - 需要管理更新签名和安全 触发词: 更新、update、自动更新、版本更新、升级、updater、OTA

Tauri 窗口管理技能，覆盖多窗口、无边框窗口、系统托盘等桌面应用窗口功能。 触发场景： - 需要创建多窗口应用 - 需要自定义窗口标题栏 - 需要实现无边框窗口 - 需要使用系统托盘 - 需要控制窗口大小/位置 触发词：窗口、window、多窗口、无边框、标题栏、托盘、tray、最小化、最大化

技术决策记录技能，记录和管理项目中的技术选型与架构决策。 触发场景： - 用户需要进行技术选型评估 - 用户需要记录架构决策及其原因 - 用户需要回顾历史技术决策 触发词：技术选型、架构决策、ADR、方案对比、技术评估

Tauri 项目测试开发技能，覆盖 Rust 单元测试和 React 组件测试。 触发场景： - 需要为 Rust Command 编写测试 - 需要为 React 组件编写测试 - 需要设计测试策略 - 需要运行和调试测试 触发词：测试、test、单元测试、集成测试、TDD、测试用例

React 前端 UI 组件开发技能,指导 Tauri 桌面应用的界面开发。 触发场景: - 需要开发 React 页面或组件 - 需要选择和使用 UI 组件库 - 需要处理表单、表格、弹窗等常见 UI - 需要实现响应式布局 触发词: UI、组件、页面、前端、界面、表单、表格、弹窗、布局、样式、React

Tauri 项目工具函数和常用 crate 技能，提供 Rust 和 TypeScript 的实用工具集。 触发场景： - 需要常用工具函数 - 需要选择合适的 Rust crate - 需要封装通用功能 - 需要日期/文件/字符串处理工具 触发词：工具、工具函数、crate、工具类、日期处理、文件处理、字符串处理、通用