القائمة
Tauri 项目导航技能，快速定位代码、理解项目结构、找到关键文件。 触发场景： - 需要了解项目整体结构 - 需要快速找到某个功能的代码位置 - 需要理解 Rust 和 React 代码的关系 - 新加入项目需要熟悉代码 触发词：项目结构、在哪里、怎么找、代码位置、目录、文件、导航、定位
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Git 工作流与版本管理技能，规范分支策略、提交信息和发布流程。 触发场景： - 用户需要创建分支或合并代码 - 用户需要规范提交信息格式 - 用户需要管理版本发布流程 触发词：Git、分支、提交、合并、版本发布
发布 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、分支、提交、合并、版本发布
自主连续开发方法论（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、报错、不工作、调试、排查、为什么、出问题、失败、不生效、无效、找不到原因、定位问题
| name | project-navigator |
| description | Tauri 项目导航技能，快速定位代码、理解项目结构、找到关键文件。 触发场景： - 需要了解项目整体结构 - 需要快速找到某个功能的代码位置 - 需要理解 Rust 和 React 代码的关系 - 新加入项目需要熟悉代码 触发词：项目结构、在哪里、怎么找、代码位置、目录、文件、导航、定位 |
| 文件 | 用途 | 何时修改 |
|---|---|---|
src-tauri/src/lib.rs | Rust Builder 统一注册（插件/状态/Commands） | 添加新模块/插件/状态 |
src-tauri/src/commands/mod.rs | Command 模块导出 | 添加新 Command 模块 |
src-tauri/src/commands/system.rs | 系统命令（greet/get_system_info） | 添加系统级 Command |
src-tauri/src/commands/config.rs | 配置 CRUD 命令 | 添加配置相关 Command |
src-tauri/src/services/config.rs | 配置业务逻辑 | 修改业务规则 |
src-tauri/src/database/mod.rs | Database 结构体 | 修改数据库连接/操作 |
src-tauri/src/database/schema.rs | Schema 迁移 | 添加/修改数据库表 |
src-tauri/src/state.rs | AppState 定义 | 添加全局状态字段 |
src-tauri/src/error.rs | thiserror 错误类型 | 添加新错误类型 |
src-tauri/src/models/mod.rs | 数据模型 | 添加/修改数据结构 |
src-tauri/src/main.rs | Rust 进程入口 | 极少修改 |
src/main.tsx | React 入口 | 添加全局 Provider |
src/App.tsx | 根组件（ConfigProvider + Router） | 修改全局配置 |
src/Router.tsx | React Router 配置 | 添加新路由/页面 |
src/store/index.ts | Zustand 全局状态 | 添加全局状态 |
src/lib/api/index.ts | API 类型安全封装 | 添加新 Command 调用 |
src-tauri/tauri.conf.json | Tauri 核心配置 | 修改窗口/打包/安全 |
src-tauri/Cargo.toml | Rust 依赖 | 添加 Rust crate |
package.json | 前端依赖 | 添加 npm 包 |
| 目录 | 内容 | 文件类型 |
|---|---|---|
src/ | React 前端源码 | .tsx, .ts, .css |
src/components/layout/ | 主布局和侧边栏导航 | .tsx |
src/components/ui/ | 通用 UI 组件（ErrorBoundary 等） | .tsx |
src/hooks/ | 自定义 Hooks（useCommand 等） | .ts |
src/lib/api/ | API 类型安全封装 | .ts |
src/pages/ | 页面组件（home/settings/about） | .tsx |
src/store/ | Zustand 全局状态 | .ts |
src/styles/ | TailwindCSS 全局样式 | .css |
src/types/ | TypeScript 类型定义 | .ts |
src-tauri/src/ | Rust 后端源码 | .rs |
src-tauri/src/commands/ | Layer 1: IPC 入口（Command 定义） | .rs |
src-tauri/src/services/ | Layer 2: 业务逻辑 | .rs |
src-tauri/src/database/ | Layer 3: 数据访问（rusqlite） | .rs |
src-tauri/src/models/ | 数据模型 | .rs |
src-tauri/capabilities/ | Tauri 权限声明 | .json |
src-tauri/icons/ | 应用图标 | .png, .ico, .icns |
public/ | 静态资源 | .svg, .png 等 |
docs/ | 项目文档 | .md |
1. 定义数据模型 → src-tauri/src/models/mod.rs
2. 实现数据访问 → src-tauri/src/database/ (Layer 3)
3. 实现业务逻辑 → src-tauri/src/services/ (Layer 2, 新建或修改 .rs 文件)
4. 实现 Command → src-tauri/src/commands/ (Layer 1, 新建或修改 .rs 文件)
5. 注册 Command → src-tauri/src/lib.rs 的 generate_handler![]
6. 声明权限 → src-tauri/capabilities/default.json (如使用插件)
7. 定义 TS 接口 → src/types/index.ts
8. 添加 API 封装 → src/lib/api/index.ts
9. 实现页面组件 → src/pages/ 下新建页面目录
10. 添加路由 → src/Router.tsx
11. 添加导航入口 → src/components/layout/Sidebar.tsx
1. Cargo.toml 添加依赖 → src-tauri/Cargo.toml
2. package.json 添加 JS 绑定 → package.json (如有)
3. 注册插件 → src-tauri/src/lib.rs 的 Builder.plugin()
4. 声明权限 → src-tauri/capabilities/default.json
5. 前端调用 → import from "@tauri-apps/plugin-xxx"
→ src-tauri/tauri.conf.json 的 app.windows 部分
→ src-tauri/tauri.conf.json 的 bundle 部分
| 想找什么 | 搜索方法 |
|---|---|
| 某个 Command 的定义 | Grep #\[tauri::command\] in src-tauri/src/commands/ |
| 某个 Command 的调用 | Grep invoke\("command_name" in src/lib/api/ |
| 所有注册的 Command | 查看 src-tauri/src/lib.rs 的 generate_handler![] 列表 |
| 某个业务逻辑 | 查看 src-tauri/src/services/ 对应模块 |
| 数据库操作 | 查看 src-tauri/src/database/ |
| 数据模型 | 查看 src-tauri/src/models/mod.rs |
| 所有插件 | Grep .plugin( in src-tauri/src/lib.rs |
| 所有权限声明 | 读取 src-tauri/capabilities/*.json |
| 全局状态定义 | 读取 src-tauri/src/state.rs（Rust）或 src/store/index.ts（前端） |
| 错误类型定义 | 读取 src-tauri/src/error.rs |
| 路由配置 | 读取 src/Router.tsx |
| API 封装 | 读取 src/lib/api/index.ts |
| Rust 依赖 | 读取 src-tauri/Cargo.toml |
| 前端依赖 | 读取 package.json |
| 错误做法 | 正确做法 |
|---|---|
| 不知道代码在哪就开始写 | 先用导航指南定位相关文件 |
| 只改前端忘记后端 | Tauri 功能通常涉及前后端两侧 |
| 忘记注册新 Command | 添加到 generate_handler![] |
| 忘记声明权限 | 使用插件 API 前检查 Capabilities |