AI 驱动开发:先读规范再写代码
预置 44 个 AI 专业技能 + 15 个快捷命令 + 自动化 Hook,让 AI 深度理解框架的架构规范、编码约定和最佳实践。Claude Code 与 Codex CLI 两套项目级配置,克隆即生效。
.claude/skills/<技能名>/SKILL.md | # | 技能 | 目录名 | 能力 | 落在哪一层 |
|---|---|---|---|---|
| 核心开发 · 14日常开发中最常用,覆盖前后端全栈;「落在哪一层」按技能说明归纳 | ||||
| 01 | 项目导航 | project-navigator | 快速定位代码、理解项目结构、理清 Rust 与 React 代码的对应关系 | ReactinvokeRust |
| 02 | API 开发 | api-development | 设计和实现供前端 invoke 调用的 Rust Command(参数、返回值、异步) | invokeCommand |
| 03 | 高级命令 | tauri-commands | Command 高级模式:异步、状态注入、访问 AppHandle / Window、进度回报与流式传输 | Command |
| 04 | Rust 基础 | rust-fundamentals | 所有权、借用、生命周期、trait、异步等,专治 Rust 编译错误 | Rust |
| 05 | 前端 UI | ui-frontend | React 页面与组件开发:表单、表格、弹窗、布局 | React |
| 06 | 主题系统 | theme-system | 设计令牌、CSS 变量、Ant Design 主题定制、暗色 / 亮色切换 | React |
| 07 | 状态管理 | store-management | React 前端共享状态(Zustand / Context)、Rust 后端状态、tauri-plugin-store 持久化 | ZustandState |
| 08 | 数据库操作 | database-ops | 用 rusqlite 操作本地 SQLite:表结构设计、CRUD | DatabaseSQLite |
| 09 | 代码模式 | code-patterns | Tauri 项目常用设计模式与编码规范 | ReactinvokeRust |
| 10 | 错误处理 | error-handler | Rust 侧错误处理与 React 错误边界、前端 invoke 失败处理、全局错误处理 | ReactinvokeCommand |
| 11 | JSON 序列化 | json-serialization | serde 序列化 / 反序列化、Rust 与 TypeScript 数据类型对齐 | TS 类型serdeRust |
| 12 | 测试开发 | test-development | Rust 单元测试与 React 组件测试、测试策略 | ReactRust |
| 13 | 架构设计 | architecture-design | 双进程架构下的模块拆分,判断功能放 Rust 还是 React 侧 | ReactIPCRust |
| 14 | 工具函数 | utils-toolkit | Rust / TypeScript 常用工具函数与 crate 选型(日期、文件、字符串) | TSRust |
| 高级功能 · 15框架进阶能力;标「按需」的是多数项目用不到、需要时再接入的 | ||||
| 15 | 插件开发 | tauri-plugins | 集成 Tauri 官方插件、开发自定义插件、排查插件不可用 | — |
| 16 | 事件系统 | tauri-events | 前后端双向事件通信(emit / listen):Rust 推送、实时更新、窗口间通信 | — |
| 17 | 权限声明 | tauri-capabilities | Capabilities 深度配置:作用域(scope)控制、多窗口差异化权限、自定义权限组 | — |
| 18 | 窗口管理 | tauri-window-management | 多窗口、无边框窗口、自定义标题栏、系统托盘、窗口大小 / 位置控制 | — |
| 19 | 系统通知 | notification-system | 用 tauri-plugin-notification 发原生系统通知,处理通知点击 | — |
| 20 | 文件系统 | file-storage | std::fs 与 FS 插件读写文件、文件 / 目录选择对话框、应用数据目录、文件拖放 | — |
| 21 | 国际化 | i18n-development | 用 react-i18next 做多语言、翻译资源管理、语言切换、日期 / 数字格式化 | — |
| 22 | 自动更新 | tauri-updater | 用 tauri-plugin-updater 实现在线更新:更新服务器、更新 UI、更新签名 | — |
| 23 | 安全权限 | security-permissions | Tauri 安全模型、Capabilities 基础配置、CSP 内容安全策略 | — |
| 24 | 环境隔离 | env-isolation | 开发 / 生产环境的数据、日志级别、窗口标题互不干扰 | — |
| 25 | 后台对接 | admin-backend-client | 按需对接若依 RuoYi-Plus / Sa-Token 类 Java 后台(登录会话、R<T> 解包、分页、按钮权限、字典缓存) | — |
| 26 | AI 模型服务 | ai-profile-onboarding | 按需首次接入 ai-profile —— 服务商预置、获取模型、测试连接、ai.profile 粘贴导入 | — |
| 27 | 移动端架构 | mobile-app-architecture | 按需桌面应用扩展移动端伴侣(PWA 优先,可选 Tauri Mobile 壳)、双 vite 构建 | — |
| 28 | 远程网关 | remote-gateway | 按需axum 远程访问网关,Token 鉴权 + 失败追踪 + WebSocket,供移动端使用 | — |
| 29 | Android 打包 | tauri-mobile-android | 按需Tauri Mobile Android 打包(NDK 中文路径、minSdkVersion、versionCode、APK / AAB、keystore 签名) | — |
| 工程与发布 · 11从开发到上线的完整工程支持 | ||||
| 30 | 打包分发 | tauri-packaging | 跨平台安装包构建(exe / dmg / deb 等)、代码签名、图标与元数据、减小体积 | — |
| 31 | Git 工作流 | git-workflow | 分支策略、提交信息规范 | — |
| 32 | 版本发布 | release-publish | 发布流程:版本号、签名构建、打 Tag、update.json、推送 Gitee、R2 CDN | — |
| 33 | 性能诊断 | performance-doctor | 启动速度、运行卡顿、Rust 编译时间、安装包体积、前端渲染性能 | — |
| 34 | Bug 排查 | bug-detective | 定位已发生问题的原因:报错、Command 返回错误、日志分析 | — |
| 35 | 项目初始化 | project-init | 基于本框架模板创建新项目:信息收集、标识符替换、建 Git 仓库、生成签名密钥 | — |
| 36 | 任务跟踪 | task-tracker | 用 docs/tasks/ 下的 Markdown 跟踪多步骤任务,支持跨会话恢复 | — |
| 37 | 技术决策 | tech-decision | 技术选型评估、记录架构决策(ADR) | — |
| 38 | 头脑风暴 | brainstorm | 方案探索、架构讨论、功能规划 | — |
| 39 | 文档站管理 | docs-management | VitePress 文档站初始化与增量同步(.docs-meta.json 追踪同步状态) | — |
| 40 | 经验沉淀 | exp-sediment | /exp 的执行指南:把会话与最近提交中的经验沉淀为技能、CLAUDE.md、Memory、docs | — |
| 多模型协作 · 4三个协同技能只在你点名对应工具时激活 | ||||
| 41 | Codex 协同 | collaborating-with-codex | 点名 Codex 时,经桥接脚本把指定任务委托给 OpenAI Codex CLI 并整合结果 | — |
| 42 | Gemini 协同 | collaborating-with-gemini | 点名 Gemini 时,经桥接脚本把指定任务委托给 Google Gemini CLI 并整合结果 | — |
| 43 | Antigravity 协同 | collaborating-with-antigravity | 点名 Antigravity / agy 时,直接调用 Google Antigravity CLI,支持 JSON Schema 结构化输出 | — |
| 44 | 技能管理 | add-skill | 新增 / 修改 / 重命名 / 删除技能,并同步到 Claude Code 与 Codex 两套技能目录 | — |
$技能名 或 /skills 调用。技能的便捷入口,一个斜杠就开工
放在 .claude/commands/*.md;Codex CLI 里以同名技能提供,改用 $ 前缀调用(如 $dev)。
日常开发
/start新开会话时快速掌握项目现状(结构、进度、未完成的事)
/dev开发新功能:按 Command → Service → Database 三层架构生成全栈代码
前端页面invokeCommandServiceDatabase/command快速创建一个 Rust Command(同步 / 异步 / 带状态 / 带窗口 / 进度回报)+ 类型定义与前端 API 封装,按需补 Service、错误类型、Capabilities
xxxApiinvokeCommand/check按全栈规范检查代码:/check 全量、/check rust 只查后端、/check react 只查前端
/next综合项目全貌,推荐一个最优下一步和备选
/progress输出结构化的项目进度与待办
发布与文档
/release改版本号 → 更新 README → 推送并打 Tag 触发 CI → 等 CI 构建签名 → 下载产物推送到 release 仓库;本地不需要 pnpm tauri build
/update-docsVitePress 文档站管理:无参数自动判断初始化或增量;init / update / full / status / diff;只 commit 不 push
自主开发
/kickoff一句话起项目:联网调研需求 → 命名与 Logo → 出原型 → 孵化新项目 → 进入自主循环
/dev-loop配合 /loop:写好需求文档与原型后,一轮一个最小可提交单元,跑到完成
/loop-gen按当次意图(还原原型、修一批 bug、补测试、重构…)现生成一条 /loop 提示词
/dev-orchestrate在智码 AICoder 里跑长任务:本会话只做总控,按批派实现子会话跑 /dev-loop,再派异构验收子会话(默认 Codex)审提交
经验与框架同步
/exp把会话与最近提交里的踩坑、反复纠正沉淀进技能、CLAUDE.md、Memory、docs
/exp-to-framework从派生项目里抽出通用经验,建议同步回原框架;先 analyze 再 apply <ids>,不自动提交
/sync-from-framework对比原框架,找出本项目缺少或落后的技能、命令、配置,每条差异都让你确认;不自动提交
点名才委托,结果由主控核对后落地
内置三个协同技能,可以把指定任务交给 Codex CLI、Gemini CLI 或 Antigravity CLI(agy)执行,再由 Claude Code 整合结果。
一次委托走四步
- 强制技能评估:识别到点名 → 激活对应协同技能
- 前置检查:CLI 已安装、已认证;不通过就停下告诉你
- 用英文写委托提示词,调用外部 CLI
- 解析 JSON 结果 → 整合、落地、质量把控
Codex CLIcollaborating-with-codex
需 OpenAI API Key桥接脚本返回 success / SESSION_ID / agent_messages;默认 read-only 沙箱,保存 SESSION_ID 可多轮续聊。
python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py --cd . --PROMPT "..."Gemini CLIcollaborating-with-gemini
需 GEMINI_API_KEY 或 gemini auth login返回格式同 Codex 桥接,默认只读沙箱。技能里写明:后端逻辑任务 Gemini 理解有缺陷,此类任务优先点名 Codex。
python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py --cd . --PROMPT "..."Antigravity CLIcollaborating-with-antigravity
agy models 能列出模型即已认证原生非交互,无需桥接脚本;一个入口调多家厂商模型,--json-schema 强制结构化输出。
agy -p '...' --output-format json/dev-orchestrate 的验收子会话默认交给 Codex 做异构验收,那是编排命令自己的机制,不需要逐次点名。两套项目级配置,同一套框架知识
Claude CodeCLAUDE.md + .claude/
skills/、commands/、hooks/(2 个 Hook)、settings.json(Hook 注册)。
Codex CLIAGENTS.md + .codex/
44 个镜像技能 + 15 个命令 + 4 个 Codex 专属技能(autonomous-dev、doc-generation、sync、update-status),4 个 Hook。
| Hook | Claude Code | Codex CLI | 作用 |
|---|---|---|---|
强制技能评估 UserPromptSubmit | 每次提问注入「评估 → 激活 → 实现」流程,先列出匹配技能并加载再动手;斜杠命令、恢复会话会跳过 | ||
命令安全检查 PreToolUse | 拦截 rm -rf /、DROP DATABASE、强推 main / master 等危险命令,提醒敏感操作 | ||
加载经验摘要 SessionStart | 新会话启动时注入 .claude/docs/experience/ 下最新的经验摘要 | ||
收尾清理 Stop | 每轮结束清理误生成的 nul 文件,可播放完成提示音 |