harmonyos-ai-workspace

把鸿蒙 AI 协作装进你的 app：规则、Skills、钩子、脚手架和调试闭环一起交给 Claude / Codex / Cursor / Copilot，让 AI 写出的 ArkTS 更接近"能编译、能运行、能上架"。

这个项目是什么？

HarmonyOS AI Workspace 是一个面向鸿蒙应用开发的 AI 编码工作区安装器。

它不是新的 IDE，也不是业务模板，更不是运行时依赖。它做的是把鸿蒙开发里 AI 最容易踩错的知识、规则和校验工具，安装到你的真实 HarmonyOS app 项目里：

项目目标很直接：让 AI 成为可控的鸿蒙开发搭档，而不是只会生成"看起来像 TypeScript、实际过不了 ArkTS 编译"的代码补全器。

目标客户

前置要求：你在用 Claude Code / Codex CLI / Cursor / GitHub Copilot 中至少一个；本仓库不是独立 IDE，是给它们装的"鸿蒙领域规则包"。

没装过 AI 助手 / DevEco Studio？看 docs/SETUP-FROM-SCRATCH.md（macOS 干净状态到 hello world，30-60 分钟）。

它应该怎么用？

最常见的使用方式是：不要在本仓库里写你的业务 app；把规则安装进你自己的鸿蒙 app 根目录。

• 在真实 app 根目录运行 npx -y harmonyos-ai-workspace。
• 从同一个 app 根目录启动 claude / codex，或用 Cursor / Copilot 打开这个项目。
• 直接让 AI 改 .ets / .ts / module.json5 / oh-package.json5，不需要每次重复粘贴鸿蒙规则。
• AI 编辑后，Claude Code 会触发 PostToolUse 钩子；其他工具可手动或通过 pre-commit 跑 tools/hooks/lib/scan-arkts.sh。
• 功能完成后跑 bash tools/harmony-dev-cycle.sh quick-check，需要真编译时跑 build-check 或 cycle-once。
• 团队场景把扫描脚本接到 pre-commit / CI，让所有 AI 工具和所有人共享同一套底线。

如果你只是想学习、贡献或维护这套规则，再 git clone 本仓库；如果你的 HarmonyOS shell 在大 monorepo 子目录里，用 samples/integrations/monorepo-consumer/ 的 wrapper 模式。

使用方式 1：装进已有鸿蒙 app（推荐，30 秒）

安装位置必须是你的 app 根目录，也就是能看到 entry/、oh-package.json5、build-profile.json5 的地方。安装器默认写入 Claude + Codex 规则；Cursor / Copilot 需要时用 --targets 打开。