AI 驱动开发
灵动桌面框架的核心差异化优势:内置完整的 AI 技能体系,让 AI 真正理解框架的每一个角落,实现"说需求就能写代码"的开发体验。
为什么需要 AI 技能体系
传统开发中,即使使用 AI 编码助手,你仍然需要:
- 反复解释项目架构和规范
- 手动纠正 AI 生成的不规范代码
- 自己把控分层、错误处理等最佳实践
灵动桌面框架通过预置 44 个专业技能 + 15 个快捷命令 + 自动化 Hook,让 AI 深度理解框架的架构规范、编码约定和最佳实践,从根本上解决这个问题。
支持的 AI 工具
框架为两款 AI 编码 CLI 提供了开箱即用的项目级配置,克隆即生效:
| AI 工具 | 入口文件 | 配置目录 | 内容 |
|---|---|---|---|
| Claude Code | CLAUDE.md | .claude/ | skills/(44 个技能)、commands/(15 个命令)、hooks/(2 个 Hook)、settings.json(Hook 注册) |
| Codex CLI | AGENTS.md | .codex/ | skills/(63 个技能)、hooks/(4 个 Hook)、hooks.json(Hook 注册)、config.toml(开启 hooks 特性) |
- Codex 没有独立的命令目录:15 个快捷命令在
.codex/skills/里以同名技能提供,用$skill-name(如$dev)或/skills选择器调用。所以 Codex 的 63 个技能 = 44 个镜像技能 + 15 个命令 + 4 个 Codex 专属技能(autonomous-dev、doc-generation、sync、update-status)。 .codex/config.toml只在.codex/被 Codex 标记为受信任时生效(首次启动 Codex 会询问)。
此外,Gemini CLI、Antigravity CLI(agy)以及 Codex CLI 本身,还可以作为外部协作者被 Claude Code 调用——但只在你点名时才会发生,详见 多模型协作。
整体结构
┌─────────────────────────────────────────────────────────┐
│ 灵动桌面框架 AI 体系 │
│ │
│ ┌─────────────────────────┐ ┌─────────────────────────┐│
│ │ Claude Code │ │ Codex CLI ││
│ │ CLAUDE.md + .claude/ │ │ AGENTS.md + .codex/ ││
│ │ │ │ ││
│ │ 44 技能 + 15 命令 │ │ 63 技能(含命令) ││
│ │ 2 个 Hook │ │ 4 个 Hook ││
│ └────────────┬────────────┘ └────────────┬────────────┘│
│ └─────────────┬─────────────┘ │
│ ↓ │
│ ┌─────────────────────────────┐ │
│ │ 同一套框架知识 + 开发规范 │ │
│ └─────────────────────────────┘ │
│ │
│ 点名时的外部协作:Codex CLI / Gemini CLI / agy │
└─────────────────────────────────────────────────────────┘
Hook 自动化
Hook 在 AI 执行过程的固定时机自动运行,不需要你手动触发。
| Hook | Claude Code | Codex CLI | 作用 |
|---|---|---|---|
| 强制技能评估(UserPromptSubmit) | 每次提问时注入「评估 → 激活 → 实现」流程,要求 AI 先列出匹配的技能并加载,再动手写代码;斜杠命令、恢复会话会跳过 | ||
| 命令安全检查(PreToolUse) | 拦截危险命令,提醒敏感操作(见下表) | ||
| 加载经验摘要(SessionStart) | 新会话启动时把 .claude/docs/experience/ 下最新的 *-exp-summary.md 注入上下文 | ||
| 收尾清理(Stop) | 每轮结束清理误生成的 nul 文件;若存在 .claude/audio/completed.wav 则播放完成提示音 |
两边的技能评估 Hook 写法不同:Claude Code 版会把技能清单(按 L1 通用 / L3 深度定制 / L4 框架专属分组)一并注入;Codex 启动时已自动加载全部技能的 description,所以 Codex 版只注入约 500 字的流程指令,避免重复占用上下文。
命令安全检查的规则(两边共有的部分):
| 类型 | 命令 / 文件 | 处理 |
|---|---|---|
| 直接阻止 | > nul 重定向(Windows 下会创建名为 nul 的文件) | 拦截,提示改用 > /dev/null 2>&1 |
| 直接阻止 | rm -rf /、rm -rf *、DROP DATABASE、TRUNCATE TABLE、强推 main / master、git reset --hard HEAD~N、写磁盘设备、mkfs、fork 炸弹 | 拦截,需要你手动在终端执行 |
| 只提醒 | 普通 git push --force | 放行并给出提示 |
| 只提醒 | 写入 .env.production、credentials.json、secrets.json | 放行并提示不要把密钥提交到 Git |
两边各自多出的规则:
- Claude Code(检查
Bash、Write):额外阻止cargo publish(非--dry-run);额外提醒tauri signer generate、cargo clean、删除src-tauri/target、cargo update、非--debug的tauri build、pnpm install --force、npm install --legacy-peer-deps,以及写入.env.local、tauri.conf.json(5)。 - Codex CLI(检查
Bash、shell、apply_patch、Edit、Write):额外阻止rm -rfWindows 绝对路径或系统目录、按名字杀node进程(会杀掉 Codex 自身)、PowerShell-EncodedCommand、格式化 / 清盘 / 删分区、强制关机重启、irm | iex远程执行,以及带 Windows 绝对路径的Remove-Item/rd /s/del /f等删除;额外提醒npm publish、docker system prune,以及写入application-prod.yml、.gitee_token。
AI 开发效率
| 传统开发 | AI 驱动开发 |
|---|---|
| 手写 Command + Service + Database 三层代码 | 一句话描述需求,/dev 生成完整三层代码 |
| 手动配置权限声明 | 自动识别所需权限并写入 Capabilities |
| 查文档写前端组件 | 描述交互需求,自动生成 React 组件 |
| 逐个排查 Bug | AI 分析错误链路,定位根因 |
| 手动写测试用例 | 自动生成 Rust 单元测试和 React 组件测试 |
| 每次会话从零摸索 | /exp 沉淀经验,下次会话自动复用 |