HCompass

外观

AI 辅助开发（Claude Code Skills） ​

HCompass 项目配置了12个框架专属 Claude Code Skill，覆盖功能包开发的完整工作流，帮助开发者快速完成符合框架规范的代码编写。

前提 ​

使用前需安装 Claude Code，并在项目根目录启动会话。所有 Skill 通过斜杠命令（如 /hcompass-package-create）触发。

Skill 列表 ​

开发流程类 ​

Skill用途
/hcompass-package-create创建新功能包的完整向导，生成标准目录结构、配置文件、Module 文件，并自动完成 Entry 注册步骤
/hcompass-contract-define在 shared/contracts 层定义跨包服务接口（Interface + DI Key + 路由常量），并完成 Index.ets 导出
/hcompass-viewmodel-create根据需求选择三种基类（BaseViewModel / BaseNetWorkViewModel / BaseNetWorkListViewModel），生成完整 ViewModel 文件
/hcompass-navigation-register创建 WrappedBuilder 路由构建器，在 Module 中注册路由，以及实现 RouteGuard 路由守卫
/hcompass-network-service实现标准化网络服务分层（NetworkDataSource + ServiceImpl），对接 NetworkResult 统一返回类型
/hcompass-di-registerDI 容器服务注册（container.register）、解析（resolve/tryResolve）、生命周期管理
/hcompass-ui-develop按框架规范编写 View 层页面和组件（designsystem 组件优先、V2 状态、布局约束）

架构规范类 ​

Skill用途
/hcompass-mvvm-patternMVVM 分层设计和整改向导，包含状态变量归属决策树、新建工作流和存量代码整改流程
/hcompass-statemgt-v2V2 状态管理规范（@ObservedV2/@Trace/@Local/@Param）+ V1→V2 完整迁移映射表

质量保障类 ​

Skill用途
/hcompass-syntax-checker静态语法检查 → 修复错误 → hvigorw 构建，最多5轮自动循环直到构建成功
/hcompass-build-fix针对多模块结构的构建错误速查，优先排查依赖路径、Index.ets 导出遗漏、V2 装饰器错误
/hcompass-code-review按 CRITICAL/HIGH/MEDIUM/LOW 四级输出框架规范审查报告（V2合规/MVVM分层/布局约束/不可变性）

推荐工作流 ​

开发新功能包 ​

/hcompass-package-create          创建包骨架
  → /hcompass-contract-define     定义对外契约（需跨包通信时）
  → /hcompass-network-service     实现网络服务（有 HTTP 请求时）
  → /hcompass-viewmodel-create    创建 ViewModel
  → /hcompass-navigation-register 注册路由和守卫
  → /hcompass-ui-develop          编写 View 层
  → /hcompass-syntax-checker      构建验证
  → /hcompass-code-review         提交前审查

已有包中新增功能 ​

/hcompass-viewmodel-create        创建新 ViewModel
  → /hcompass-navigation-register 注册新页面路由（有新页面时）
  → /hcompass-ui-develop          编写 View 层
  → /hcompass-syntax-checker      构建验证
  → /hcompass-code-review         提交前审查

存量代码整改（V1→V2 / MVVM 合规） ​

/hcompass-code-review             审查找出问题
  → /hcompass-statemgt-v2         迁移 V1 → V2
  → /hcompass-mvvm-pattern        重新分层整改
  → /hcompass-syntax-checker      验证构建
  → /hcompass-code-review         复审确认

问题排查 ​

构建失败   → /hcompass-build-fix
静态错误   → /hcompass-syntax-checker
V2 迁移    → /hcompass-statemgt-v2