@harmonyos-arkts/d2h 0.1.11 → 0.1.13

package/skills/native-library-substitution/references/native-library-substitution.md

@@ -1,163 +1,163 @@
-# Native Library Substitution 单一映射表
-
-**数据版本**: 3.0.0
-**更新日期**: 2026-04-22
-
-## 数据概览
-
-| 统计项 | 数量 |
-|--------|------|
-| 总映射数 | 2678 |
-| 有安卓库的映射 | 1005 |
-| 鸿蒙原生库（无安卓库） | 1673 |
-| 唯一安卓库数 | 852 |
-| 唯一ohpm包数 | 2537 |
-
-## source_availability 分布
-
-| 状态 | 数量 | 说明 |
-|------|------|------|
-| COMMERCIAL_PUBLIC | 175 | 闭源商业SDK（来自工作簿） |
-| open_source | 2503 | 开源库 |
-| not_set | 0 | 未设置 |
-
-## source_type 分布
-
-| 来源类型 | 数量 | 说明 |
-|----------|------|------|
-| 鸿蒙原生库 | 1321 | 鸿蒙原生开发，无对应安卓库 |
-| TS/JS迁移库 | 790 | 从npm生态迁移 |
-| 安卓鸿蒙化库 | 432 | 直接从安卓库移植 |
-| C++/C鸿蒙化库 | 133 | 从C++生态迁移 |
-
-## category 分布
-
-| Category | 数量 | 说明 |
-|----------|------|------|
-| other | 1527 | 其他 |
-| ui | 370 | UI组件 |
-| utils | 213 | 工具类 |
-| network | 209 | 网络请求 |
-| media | 89 | 音视频 |
-| auth | 61 | 登录认证 |
-| notification | 60 | 推送通知 |
-| storage | 60 | 存储文件 |
-| location | 50 | 地图定位 |
-| analytics | 17 | 统计分析 |
-| payment | 16 | 支付 |
-| security | 4 | 安全加密 |
-| im | 1 | 即时通讯 |
-| social | 1 | 社交分享 |
-
-## 闭源库示例（COMMERCIAL_PUBLIC）
-
-| 安卓库 | 鸿蒙包 | install_command |
-|--------|--------|-----------------|
-| com.tencent.mm.opensdk:wechat-sdk-androi | @tencent/wechat_open_sdk | `ohpm install @tencent/wechat_open_sdk` |
-| com.sensorsdata.analytics.abtesting:Sens | @sensorsdata/analytics | `ohpm install @sensorsdata/analytics` |
-| cn.admobiletop.adsuyi.ad.adapter:tianmu | @admobile/tianmu | `ohpm install @admobile/tianmu` |
-| cn.admobiletop.adsuyi.ad:core | @admobile/tianmu | `ohpm install @admobile/tianmu` |
-| io.hyphenate:hyphenate-chat | @easemob/chatsdk | `ohpm install @easemob/chatsdk` |
-| com.aliyun.auikits.android:ARTCAICallKit | @aliyun_video_cloud/alivcsdk_artc | `ohpm install @aliyun_video_cloud/alivcsdk_artc` |
-| com.aliyun.iot.aep.sdk:push | @aliyun/push | `ohpm install @aliyun/push` |
-| com.aliyun.rum:alibabacloud-android-rum- | @alibabacloud_rum/harmony_sdk | `ohpm install @alibabacloud_rum/harmony_sdk` |
-| com.alibaba.mtl:app-monitor-sdk | @alibabacloud_rum/harmony_sdk | `ohpm install @alibabacloud_rum/harmony_sdk` |
-| com.aliyun.ams:alicloud-apm-crash-analys | @aliyun/apm | `ohpm install @aliyun/apm` |
-| com.aliyun.dpa:oss-android-sdk | @aliyun/oss | `ohpm install @aliyun/oss` |
-| afservicesdk | @cashier_alipay/cashiersdk | `ohpm install @cashier_alipay/cashiersdk` |
-| com.alipay.sdk:alipaysdk-android | @cashier_alipay/cashiersdk | `ohpm install @cashier_alipay/cashiersdk` |
-| io.github.yidun:livedetect | @yidun/alive | `ohpm install @yidun/alive` |
-| io.github.aliyun-sls:aliyun-log-android- | @aliyun/logger | `ohpm install @aliyun/logger` |
-| com.aliyun.ams:alicloud-android-push | @aliyun/push | `ohpm install @aliyun/push` |
-| com.aliyun.ams:alicloud-android-third-pu | @aliyun/push | `ohpm install @aliyun/push` |
-| com.aliyun.ams:alicloud-android-third-pu | @aliyun/push | `ohpm install @aliyun/push` |
-| com.amap.api:3dmap | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
-| com.amap.api:location | @amap/amap_lbs_location | `ohpm install @amap/amap_lbs_location` |
-| com.amap.api:search | @amap/amap_lbs_search | `ohpm install @amap/amap_lbs_search` |
-| com.amap.api:3dmap-location-search | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
-| com.amap.api:navi-3dmap | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
-| com.umeng.umsdk:analytics | @umeng/analytics | `ohpm install @umeng/analytics` |
-| com.umeng.umsdk:common | @umeng/common | `ohpm install @umeng/common` |
-| BaiduLBS_Android | @bdmap/navi_map | `ohpm install @bdmap/navi_map` |
-| com.baidubce.mediasdk:brtc | @baiduplayer/baidurtcsdk | `ohpm install @baiduplayer/baidurtcsdk` |
-| com.getui:gtsdk | @getui/push | `ohpm install @getui/push` |
-| com.bonree.sdk.jar | @bonree/agent | `ohpm install @bonree/agent` |
-| com.tencent.bugly:crashreport | bugly | `ohpm install bugly` |
-
-*共 175 条闭源库映射*
-
-## 高置信度映射示例（安卓鸿蒙化库）
-
-| 安卓库 | 鸿蒙包 | category | install_command |
-|--------|--------|----------|-----------------|
-| AJCaptcha 安卓实现版本 | @scca/verification | other | `ohpm install @scca/verification` |
-| ARouter | @ohos/arouteronactivityresult | other | `ohpm install @ohos/arouteronactivityresult` |
-| ARouter | hrouter | other | `ohpm install hrouter` |
-| Android Beacon Library (AltBea | @ohos/beacon-library | other | `ohpm install @ohos/beacon-library` |
-| Android BottomSheet | @hld/bottomsheet | other | `ohpm install @hld/bottomsheet` |
-| Android Jetpack Paging3 | @jackiehou/experimental-paging | other | `ohpm install @jackiehou/experimental-paging` |
-| Android Room | @hzzmkjyxgs/zmwlthmosdb | other | `ohpm install @hzzmkjyxgs/zmwlthmosdb` |
-| Android TabLayout（com.google.a | @zyc/tablayout | other | `ohpm install @zyc/tablayout` |
-| Android XLog | @ohos-port/xlog-ts | other | `ohpm install @ohos-port/xlog-ts` |
-| Android-Debug-Database | @hadss/debug-db | other | `ohpm install @hadss/debug-db` |
-| AndroidImageEditor | @zhongjh/image_edit | other | `ohpm install @zhongjh/image_edit` |
-| AndroidUtilCode | @android_x/utilcode | other | `ohpm install @android_x/utilcode` |
-| AndroidUtilCode | @ilye/utilcode | other | `ohpm install @ilye/utilcode` |
-| AndroidUtilCode | @ranran/utilcode | other | `ohpm install @ranran/utilcode` |
-| AndroidVideoCache | @changjing/drm | media | `ohpm install @changjing/drm` |
-| AndroidVideoCache (com.danikul | @ohos/video-cache | media | `ohpm install @ohos/video-cache` |
-| Apache Batik | @ohos/xmlgraphicsbatik | other | `ohpm install @ohos/xmlgraphicsbatik` |
-| Apache Cordova Android | @boc/cordova | other | `ohpm install @boc/cordova` |
-| AppCan Android Engine | @appcan/engine | other | `ohpm install @appcan/engine` |
-| DBFlow | @ohos/dataorm | other | `ohpm install @ohos/dataorm` |
-
-*共 340 条高置信度安卓鸿蒙化库映射*
-
-## 鸿蒙原生库示例（无安卓库）
-
-| 鸿蒙包 | 组织 | category | install_command |
-|--------|------|----------|-----------------|
-| @pura/harmony-utils | pura | notification | `ohpm install @pura/harmony-utils` |
-| @pura/harmony-dialog | pura | ui | `ohpm install @pura/harmony-dialog` |
-| @ibestservices/ibest-ui | ibestservices | ui | `ohpm install @ibestservices/ibest-ui` |
-| @abner/refresh | abner | ui | `ohpm install @abner/refresh` |
-| @hzw/zrouter | hzw | other | `ohpm install @hzw/zrouter` |
-| cjcalendar |  | ui | `ohpm install cjcalendar` |
-| @hadss/hmrouter | hadss | other | `ohpm install @hadss/hmrouter` |
-| @esky/barrage | esky | media | `ohpm install @esky/barrage` |
-| @ibestservices/ibest-ui-v2 | ibestservices | ui | `ohpm install @ibestservices/ibest-ui-v2` |
-| @ohos/pulltorefresh | ohos | ui | `ohpm install @ohos/pulltorefresh` |
-| @mcui/mccharts | mcui | utils | `ohpm install @mcui/mccharts` |
-| @maple/navigationbarview | maple | location | `ohpm install @maple/navigationbarview` |
-| @abner/dialog | abner | ui | `ohpm install @abner/dialog` |
-| @zyl/wxcommonlibhar | zyl | payment | `ohpm install @zyl/wxcommonlibhar` |
-| @ibestservices/ibest-orm | ibestservices | storage | `ohpm install @ibestservices/ibest-orm` |
-| @ohasasugar/hp-richtext | ohasasugar | ui | `ohpm install @ohasasugar/hp-richtext` |
-| @zyl/commonlibhar | zyl | media | `ohpm install @zyl/commonlibhar` |
-| @abner/datastore | abner | storage | `ohpm install @abner/datastore` |
-| @visactor/harmony-vchart | visactor | other | `ohpm install @visactor/harmony-vchart` |
-| @liushengyi/smartdb | liushengyi | storage | `ohpm install @liushengyi/smartdb` |
-
-*共 1673 条鸿蒙原生库*
-
-## 数据结构
-
-每条映射记录包含15个字段：
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| android_lib | string/null | 安卓库标识符（鸿蒙原生库为null） |
-| android_platform | string | android / ios / ohos_native |
-| android_description | string/null | 安卓库功能描述 |
-| ohpm_package | string | 鸿蒙包名 |
-| ohpm_org | string | ohpm组织名 |
-| ohpm_description | string | 鸿蒙包功能描述 |
-| ohpm_keywords | array | 鸿蒙包关键词 |
-| ohpm_repo_url | string | 鸿蒙包源码仓库 |
-| ohpm_homepage | string | 鸿蒙包文档主页 |
-| source_type | string | 安卓鸿蒙化库/TS迁移库/鸿蒙原生库 |
-| source_availability | string | COMMERCIAL_PUBLIC/open_source |
-| confidence | string | high/medium/low |
-| install_command | string | ohpm install命令 |
-| category | string | media/network/notification等 |
-| inference_reason | string | 映射关系说明 |
+# Native Library Substitution 单一映射表
+
+**数据版本**: 3.0.0
+**更新日期**: 2026-04-22
+
+## 数据概览
+
+| 统计项 | 数量 |
+|--------|------|
+| 总映射数 | 2678 |
+| 有安卓库的映射 | 1005 |
+| 鸿蒙原生库（无安卓库） | 1673 |
+| 唯一安卓库数 | 852 |
+| 唯一ohpm包数 | 2537 |
+
+## source_availability 分布
+
+| 状态 | 数量 | 说明 |
+|------|------|------|
+| COMMERCIAL_PUBLIC | 175 | 闭源商业SDK（来自工作簿） |
+| open_source | 2503 | 开源库 |
+| not_set | 0 | 未设置 |
+
+## source_type 分布
+
+| 来源类型 | 数量 | 说明 |
+|----------|------|------|
+| 鸿蒙原生库 | 1321 | 鸿蒙原生开发，无对应安卓库 |
+| TS/JS迁移库 | 790 | 从npm生态迁移 |
+| 安卓鸿蒙化库 | 432 | 直接从安卓库移植 |
+| C++/C鸿蒙化库 | 133 | 从C++生态迁移 |
+
+## category 分布
+
+| Category | 数量 | 说明 |
+|----------|------|------|
+| other | 1527 | 其他 |
+| ui | 370 | UI组件 |
+| utils | 213 | 工具类 |
+| network | 209 | 网络请求 |
+| media | 89 | 音视频 |
+| auth | 61 | 登录认证 |
+| notification | 60 | 推送通知 |
+| storage | 60 | 存储文件 |
+| location | 50 | 地图定位 |
+| analytics | 17 | 统计分析 |
+| payment | 16 | 支付 |
+| security | 4 | 安全加密 |
+| im | 1 | 即时通讯 |
+| social | 1 | 社交分享 |
+
+## 闭源库示例（COMMERCIAL_PUBLIC）
+
+| 安卓库 | 鸿蒙包 | install_command |
+|--------|--------|-----------------|
+| com.tencent.mm.opensdk:wechat-sdk-androi | @tencent/wechat_open_sdk | `ohpm install @tencent/wechat_open_sdk` |
+| com.sensorsdata.analytics.abtesting:Sens | @sensorsdata/analytics | `ohpm install @sensorsdata/analytics` |
+| cn.admobiletop.adsuyi.ad.adapter:tianmu | @admobile/tianmu | `ohpm install @admobile/tianmu` |
+| cn.admobiletop.adsuyi.ad:core | @admobile/tianmu | `ohpm install @admobile/tianmu` |
+| io.hyphenate:hyphenate-chat | @easemob/chatsdk | `ohpm install @easemob/chatsdk` |
+| com.aliyun.auikits.android:ARTCAICallKit | @aliyun_video_cloud/alivcsdk_artc | `ohpm install @aliyun_video_cloud/alivcsdk_artc` |
+| com.aliyun.iot.aep.sdk:push | @aliyun/push | `ohpm install @aliyun/push` |
+| com.aliyun.rum:alibabacloud-android-rum- | @alibabacloud_rum/harmony_sdk | `ohpm install @alibabacloud_rum/harmony_sdk` |
+| com.alibaba.mtl:app-monitor-sdk | @alibabacloud_rum/harmony_sdk | `ohpm install @alibabacloud_rum/harmony_sdk` |
+| com.aliyun.ams:alicloud-apm-crash-analys | @aliyun/apm | `ohpm install @aliyun/apm` |
+| com.aliyun.dpa:oss-android-sdk | @aliyun/oss | `ohpm install @aliyun/oss` |
+| afservicesdk | @cashier_alipay/cashiersdk | `ohpm install @cashier_alipay/cashiersdk` |
+| com.alipay.sdk:alipaysdk-android | @cashier_alipay/cashiersdk | `ohpm install @cashier_alipay/cashiersdk` |
+| io.github.yidun:livedetect | @yidun/alive | `ohpm install @yidun/alive` |
+| io.github.aliyun-sls:aliyun-log-android- | @aliyun/logger | `ohpm install @aliyun/logger` |
+| com.aliyun.ams:alicloud-android-push | @aliyun/push | `ohpm install @aliyun/push` |
+| com.aliyun.ams:alicloud-android-third-pu | @aliyun/push | `ohpm install @aliyun/push` |
+| com.aliyun.ams:alicloud-android-third-pu | @aliyun/push | `ohpm install @aliyun/push` |
+| com.amap.api:3dmap | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
+| com.amap.api:location | @amap/amap_lbs_location | `ohpm install @amap/amap_lbs_location` |
+| com.amap.api:search | @amap/amap_lbs_search | `ohpm install @amap/amap_lbs_search` |
+| com.amap.api:3dmap-location-search | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
+| com.amap.api:navi-3dmap | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
+| com.umeng.umsdk:analytics | @umeng/analytics | `ohpm install @umeng/analytics` |
+| com.umeng.umsdk:common | @umeng/common | `ohpm install @umeng/common` |
+| BaiduLBS_Android | @bdmap/navi_map | `ohpm install @bdmap/navi_map` |
+| com.baidubce.mediasdk:brtc | @baiduplayer/baidurtcsdk | `ohpm install @baiduplayer/baidurtcsdk` |
+| com.getui:gtsdk | @getui/push | `ohpm install @getui/push` |
+| com.bonree.sdk.jar | @bonree/agent | `ohpm install @bonree/agent` |
+| com.tencent.bugly:crashreport | bugly | `ohpm install bugly` |
+
+*共 175 条闭源库映射*
+
+## 高置信度映射示例（安卓鸿蒙化库）
+
+| 安卓库 | 鸿蒙包 | category | install_command |
+|--------|--------|----------|-----------------|
+| AJCaptcha 安卓实现版本 | @scca/verification | other | `ohpm install @scca/verification` |
+| ARouter | @ohos/arouteronactivityresult | other | `ohpm install @ohos/arouteronactivityresult` |
+| ARouter | hrouter | other | `ohpm install hrouter` |
+| Android Beacon Library (AltBea | @ohos/beacon-library | other | `ohpm install @ohos/beacon-library` |
+| Android BottomSheet | @hld/bottomsheet | other | `ohpm install @hld/bottomsheet` |
+| Android Jetpack Paging3 | @jackiehou/experimental-paging | other | `ohpm install @jackiehou/experimental-paging` |
+| Android Room | @hzzmkjyxgs/zmwlthmosdb | other | `ohpm install @hzzmkjyxgs/zmwlthmosdb` |
+| Android TabLayout（com.google.a | @zyc/tablayout | other | `ohpm install @zyc/tablayout` |
+| Android XLog | @ohos-port/xlog-ts | other | `ohpm install @ohos-port/xlog-ts` |
+| Android-Debug-Database | @hadss/debug-db | other | `ohpm install @hadss/debug-db` |
+| AndroidImageEditor | @zhongjh/image_edit | other | `ohpm install @zhongjh/image_edit` |
+| AndroidUtilCode | @android_x/utilcode | other | `ohpm install @android_x/utilcode` |
+| AndroidUtilCode | @ilye/utilcode | other | `ohpm install @ilye/utilcode` |
+| AndroidUtilCode | @ranran/utilcode | other | `ohpm install @ranran/utilcode` |
+| AndroidVideoCache | @changjing/drm | media | `ohpm install @changjing/drm` |
+| AndroidVideoCache (com.danikul | @ohos/video-cache | media | `ohpm install @ohos/video-cache` |
+| Apache Batik | @ohos/xmlgraphicsbatik | other | `ohpm install @ohos/xmlgraphicsbatik` |
+| Apache Cordova Android | @boc/cordova | other | `ohpm install @boc/cordova` |
+| AppCan Android Engine | @appcan/engine | other | `ohpm install @appcan/engine` |
+| DBFlow | @ohos/dataorm | other | `ohpm install @ohos/dataorm` |
+
+*共 340 条高置信度安卓鸿蒙化库映射*
+
+## 鸿蒙原生库示例（无安卓库）
+
+| 鸿蒙包 | 组织 | category | install_command |
+|--------|------|----------|-----------------|
+| @pura/harmony-utils | pura | notification | `ohpm install @pura/harmony-utils` |
+| @pura/harmony-dialog | pura | ui | `ohpm install @pura/harmony-dialog` |
+| @ibestservices/ibest-ui | ibestservices | ui | `ohpm install @ibestservices/ibest-ui` |
+| @abner/refresh | abner | ui | `ohpm install @abner/refresh` |
+| @hzw/zrouter | hzw | other | `ohpm install @hzw/zrouter` |
+| cjcalendar |  | ui | `ohpm install cjcalendar` |
+| @hadss/hmrouter | hadss | other | `ohpm install @hadss/hmrouter` |
+| @esky/barrage | esky | media | `ohpm install @esky/barrage` |
+| @ibestservices/ibest-ui-v2 | ibestservices | ui | `ohpm install @ibestservices/ibest-ui-v2` |
+| @ohos/pulltorefresh | ohos | ui | `ohpm install @ohos/pulltorefresh` |
+| @mcui/mccharts | mcui | utils | `ohpm install @mcui/mccharts` |
+| @maple/navigationbarview | maple | location | `ohpm install @maple/navigationbarview` |
+| @abner/dialog | abner | ui | `ohpm install @abner/dialog` |
+| @zyl/wxcommonlibhar | zyl | payment | `ohpm install @zyl/wxcommonlibhar` |
+| @ibestservices/ibest-orm | ibestservices | storage | `ohpm install @ibestservices/ibest-orm` |
+| @ohasasugar/hp-richtext | ohasasugar | ui | `ohpm install @ohasasugar/hp-richtext` |
+| @zyl/commonlibhar | zyl | media | `ohpm install @zyl/commonlibhar` |
+| @abner/datastore | abner | storage | `ohpm install @abner/datastore` |
+| @visactor/harmony-vchart | visactor | other | `ohpm install @visactor/harmony-vchart` |
+| @liushengyi/smartdb | liushengyi | storage | `ohpm install @liushengyi/smartdb` |
+
+*共 1673 条鸿蒙原生库*
+
+## 数据结构
+
+每条映射记录包含15个字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| android_lib | string/null | 安卓库标识符（鸿蒙原生库为null） |
+| android_platform | string | android / ios / ohos_native |
+| android_description | string/null | 安卓库功能描述 |
+| ohpm_package | string | 鸿蒙包名 |
+| ohpm_org | string | ohpm组织名 |
+| ohpm_description | string | 鸿蒙包功能描述 |
+| ohpm_keywords | array | 鸿蒙包关键词 |
+| ohpm_repo_url | string | 鸿蒙包源码仓库 |
+| ohpm_homepage | string | 鸿蒙包文档主页 |
+| source_type | string | 安卓鸿蒙化库/TS迁移库/鸿蒙原生库 |
+| source_availability | string | COMMERCIAL_PUBLIC/open_source |
+| confidence | string | high/medium/low |
+| install_command | string | ohpm install命令 |
+| category | string | media/network/notification等 |
+| inference_reason | string | 映射关系说明 |

package/skills/preparing-migration-workspace/SKILL.md

@@ -1,131 +1,131 @@
----
-name: preparing-migration-workspace
-description: 在 Android 转 HarmonyOS 迁移开始或恢复时，通过 droid2hmos 读取状态、执行 Preflight、初始化或校验配置，并采集设备与外部环境就绪度。只负责工作区准备和能力分流；不调度分析、实现、构建、测试、回归或 Git checkpoint。
----
-
-# 准备迁移工作区
-
-本 Skill 只负责回答四个问题：项目和迁移工作区是否定位正确、非设备基线是否可用、设备是否可用、哪些外部条件仍阻塞特定能力。它不决定后续状态，也不把设备失败扩大为整个迁移停止。
-
-工具安装、精确版本和升级由 `managing-d2h-toolchain` 负责。本 Skill 只消费已检查的 CLI；发现版本或能力不符时返回该 Skill 处理，不运行 npm。
-
-只调用 `droid2hmos` 的 `status`、`preflight`、`config init/validate` 和按需的 `device check`。不要直接调用 Node 脚本、Gradle、Hvigor、Hypium、ADB、HDC 或 AppGraph 分析命令，也不要在 `ohos/` 尚不存在时猜测 HarmonyOS 构建配置。
-
-迁移产物（`.migration/`）统一位于 Android 工程父目录下的 `<工程名>-migration/.migration/`，由 CLI 创建和维护，不写入 Android 工程内部。下文所有 `.migration/...` 路径均相对该迁移工作区根目录。
-
-## 输入与事实来源
-
-输入必须包含 Android Gradle 工程根目录。根目录应有 Gradle 标记，应用模块中应有 `AndroidManifest.xml`。
-
-开始或恢复时先获取只读快照：
-
-```text
-droid2hmos status <ANDROID_PROJECT>
-```
-
-以 CLI 返回的 `workspace`、`allowedActions`、`completion.unmet`、Preflight 检查项、`failedChecks` 和 `retry` 为机器事实。`phase` 只解释当前现场；不得创建或编辑 `.migration/state.json`。
-
-如果 `workspace.projectPresent=false` 且 `workspace.projectCandidates` 非空，说明传入的是包装目录。改用列出的明确候选工程，不得在包装目录初始化第二套迁移工作区或 HarmonyOS 工程。
-
-## 首次准备
-
-运行统一预检：
-
-```text
-droid2hmos preflight <ANDROID_PROJECT> [--sdk-path <PATH>] [--timeout-ms <MS>]
-```
-
-`preflight` 由 Kernel 选择并判定检查项，可能包含：
-
-- Android UI 技术栈支持性；
-- Git 仓库、分支、`HEAD` 和用户已有改动；
-- Git、Node.js、npm、Python、JDK、DevEco 和 HarmonyOS SDK（Android SDK 探测已移除，迁移不依赖 Android 编译环境）；
-- AppGraph 健康检查；
-- `.migration/config.json` 初始化和校验；
-- Android 基线状态；
-- 已有 HarmonyOS 工程复用，或在空目标中创建工程壳；
-- Preflight 自身所需的基线构建和设备检查；
-- `.migration/preflight-report.json` 原子生成。
-
-这些是 Preflight 的内部门禁，不授权本 Skill 在预检后继续调度仓库级构建、测试或分析。已有 HarmonyOS 工程不得被覆盖；只校验现有工程且不允许初始化工程壳时使用 `--no-init-harmony`。
-
-命令失败时读取 `failedChecks`、`retry` 和对应日志：
-
-- `retry.kind=transient/bounded`：只在返回的上限内原样重试；
-- `retry.kind=external`：记录为外部阻塞项并返回具体 `remediation`，不要在环境未变化时连续重跑；
-- 其他失败：返回受影响能力和补救建议，不自行推断绕过方式。
-
-不要把 `preflight` 非零退出一概解释为“迁移不能继续”。例如 HarmonyOS 设备不可用只阻止设备测试、运行态验收和依赖设备的证据采集；当 `allowedActions` 仍允许时，源码阅读、静态分析和非设备实现可以继续。反之，工程定位、配置或必要工具链缺失可能使 `allowedNonDeviceWork=false`。最终分流必须忠实反映本次 CLI 快照。
-
-## 配置
-
-需要显式提供 HarmonyOS 工程路径时使用：
-
-```text
-droid2hmos config init <ANDROID_PROJECT> [--harmony-project <PATH>]
-droid2hmos config validate <ANDROID_PROJECT>
-```
-
-配置中只保存能够确认的路径。不得保存或猜测 `harmonyBuild`、`harmonyTest`、module、product 或 target；HarmonyOS 参数由 CLI 从真实工程配置解析。
-
-`androidBuild`/`androidTest` 字段仅为兼容旧工作区保留：CLI 不再提供设置入口，也不再执行这些命令（Android 构建与测试能力已移除）。
-
-## 设备状态采集
-
-当现有 Preflight 报告缺少当前设备状态，或调用方明确需要刷新设备状态时，可运行：
-
-```text
-droid2hmos device check harmony
-```
-
-只记录设备发现、Shell 响应、目标歧义和返回的 remediation（Android 设备检测已移除，仅支持 HarmonyOS）。多个目标、认证、签名或设备离线问题进入 `externalBlockers` 或 `capabilityBlockers`，由调用方决定何时处理。本 Skill 不因设备问题暂停并要求用户作流程选择。
-
-## 恢复
-
-恢复时不得重新初始化已有 `ohos/`。运行：
-
-```text
-droid2hmos status <ANDROID_PROJECT>
-droid2hmos config validate <ANDROID_PROJECT>
-```
-
-仅当工具链、配置、工程壳或设备环境可能变化，或 CLI 明确要求刷新 Preflight 时，重新运行 `preflight`。不要在这里检查或创建 checkpoint，也不要补跑 `analyze`、`build`、`test` 或全量回归；这些属于调用方根据当前工作单元和状态决定的后续动作。
-
-不得处理、覆盖、提交或删除用户已有改动。
-
-## 结构化结果
-
-始终返回同一就绪度结构：
-
-```json
-{
-  "baselineReady": true,
-  "deviceReady": false,
-  "externalBlockers": [],
-  "capabilityBlockers": [
-    {
-      "capability": "device-validation",
-      "check": "harmony-device",
-      "reason": "no responsive target",
-      "remediation": "connect or start one HarmonyOS target"
-    }
-  ],
-  "allowedNonDeviceWork": true,
-  "allowedActions": [],
-  "evidence": [".migration/preflight-report.json"],
-  "suggestedRemediation": []
-}
-```
-
-字段语义：
-
-- `baselineReady`：工程定位、迁移配置和非设备基础能力是否足以支持 CLI 明确允许的后续工作；不能仅用 Preflight 总体退出码代替；
-- `deviceReady`：当前 HarmonyOS 目标是否满足设备类工作要求；
-- `externalBlockers`：需要用户、账号、签名、物理设备或外部环境变化的阻塞项；
-- `capabilityBlockers`：按能力说明阻塞范围，不能写成笼统的“迁移停止”；
-- `allowedNonDeviceWork`：当前是否仍可继续源码阅读、静态分析或非设备实现；
-- `allowedActions`：原样返回 CLI 快照中的允许动作；
-- `evidence`：本次读取或生成的状态、配置和 Preflight 报告；
-- `suggestedRemediation`：CLI 给出的可执行补救，不臆造成功结论。
-
-本 Skill 不推进外部状态机、不更新迁移报告、不创建 checkpoint、不调用 `complete`，也不决定定向测试或全量回归。调用方根据上述结果决定下一步。
+---
+name: preparing-migration-workspace
+description: 在 Android 转 HarmonyOS 迁移开始或恢复时，通过 droid2hmos 读取状态、执行 Preflight、初始化或校验配置，并采集设备与外部环境就绪度。只负责工作区准备和能力分流；不调度分析、实现、构建、测试、回归或 Git checkpoint。
+---
+
+# 准备迁移工作区
+
+本 Skill 只负责回答四个问题：项目和迁移工作区是否定位正确、非设备基线是否可用、设备是否可用、哪些外部条件仍阻塞特定能力。它不决定后续状态，也不把设备失败扩大为整个迁移停止。
+
+工具安装、精确版本和升级由 `managing-d2h-toolchain` 负责。本 Skill 只消费已检查的 CLI；发现版本或能力不符时返回该 Skill 处理，不运行 npm。
+
+只调用 `droid2hmos` 的 `status`、`preflight`、`config init/validate` 和按需的 `device check`。不要直接调用 Node 脚本、Gradle、Hvigor、Hypium、ADB、HDC 或 AppGraph 分析命令，也不要在 `ohos/` 尚不存在时猜测 HarmonyOS 构建配置。
+
+迁移产物（`.migration/`）统一位于 Android 工程父目录下的 `<工程名>-migration/.migration/`，由 CLI 创建和维护，不写入 Android 工程内部。下文所有 `.migration/...` 路径均相对该迁移工作区根目录。
+
+## 输入与事实来源
+
+输入必须包含 Android Gradle 工程根目录。根目录应有 Gradle 标记，应用模块中应有 `AndroidManifest.xml`。
+
+开始或恢复时先获取只读快照：
+
+```text
+droid2hmos status <ANDROID_PROJECT>
+```
+
+以 CLI 返回的 `workspace`、`allowedActions`、`completion.unmet`、Preflight 检查项、`failedChecks` 和 `retry` 为机器事实。`phase` 只解释当前现场；不得创建或编辑 `.migration/state.json`。
+
+如果 `workspace.projectPresent=false` 且 `workspace.projectCandidates` 非空，说明传入的是包装目录。改用列出的明确候选工程，不得在包装目录初始化第二套迁移工作区或 HarmonyOS 工程。
+
+## 首次准备
+
+运行统一预检：
+
+```text
+droid2hmos preflight <ANDROID_PROJECT> [--sdk-path <PATH>] [--timeout-ms <MS>]
+```
+
+`preflight` 由 Kernel 选择并判定检查项，可能包含：
+
+- Android UI 技术栈支持性；
+- Git 仓库、分支、`HEAD` 和用户已有改动；
+- Git、Node.js、npm、Python、JDK、DevEco 和 HarmonyOS SDK（Android SDK 探测已移除，迁移不依赖 Android 编译环境）；
+- AppGraph 健康检查；
+- `.migration/config.json` 初始化和校验；
+- Android 基线状态；
+- 已有 HarmonyOS 工程复用，或在空目标中创建工程壳；
+- Preflight 自身所需的基线构建和设备检查；
+- `.migration/preflight-report.json` 原子生成。
+
+这些是 Preflight 的内部门禁，不授权本 Skill 在预检后继续调度仓库级构建、测试或分析。已有 HarmonyOS 工程不得被覆盖；只校验现有工程且不允许初始化工程壳时使用 `--no-init-harmony`。
+
+命令失败时读取 `failedChecks`、`retry` 和对应日志：
+
+- `retry.kind=transient/bounded`：只在返回的上限内原样重试；
+- `retry.kind=external`：记录为外部阻塞项并返回具体 `remediation`，不要在环境未变化时连续重跑；
+- 其他失败：返回受影响能力和补救建议，不自行推断绕过方式。
+
+不要把 `preflight` 非零退出一概解释为“迁移不能继续”。例如 HarmonyOS 设备不可用只阻止设备测试、运行态验收和依赖设备的证据采集；当 `allowedActions` 仍允许时，源码阅读、静态分析和非设备实现可以继续。反之，工程定位、配置或必要工具链缺失可能使 `allowedNonDeviceWork=false`。最终分流必须忠实反映本次 CLI 快照。
+
+## 配置
+
+需要显式提供 HarmonyOS 工程路径时使用：
+
+```text
+droid2hmos config init <ANDROID_PROJECT> [--harmony-project <PATH>]
+droid2hmos config validate <ANDROID_PROJECT>
+```
+
+配置中只保存能够确认的路径。不得保存或猜测 `harmonyBuild`、`harmonyTest`、module、product 或 target；HarmonyOS 参数由 CLI 从真实工程配置解析。
+
+`androidBuild`/`androidTest` 字段仅为兼容旧工作区保留：CLI 不再提供设置入口，也不再执行这些命令（Android 构建与测试能力已移除）。
+
+## 设备状态采集
+
+当现有 Preflight 报告缺少当前设备状态，或调用方明确需要刷新设备状态时，可运行：
+
+```text
+droid2hmos device check harmony
+```
+
+只记录设备发现、Shell 响应、目标歧义和返回的 remediation（Android 设备检测已移除，仅支持 HarmonyOS）。多个目标、认证、签名或设备离线问题进入 `externalBlockers` 或 `capabilityBlockers`，由调用方决定何时处理。本 Skill 不因设备问题暂停并要求用户作流程选择。
+
+## 恢复
+
+恢复时不得重新初始化已有 `ohos/`。运行：
+
+```text
+droid2hmos status <ANDROID_PROJECT>
+droid2hmos config validate <ANDROID_PROJECT>
+```
+
+仅当工具链、配置、工程壳或设备环境可能变化，或 CLI 明确要求刷新 Preflight 时，重新运行 `preflight`。不要在这里检查或创建 checkpoint，也不要补跑 `analyze`、`build`、`test` 或全量回归；这些属于调用方根据当前工作单元和状态决定的后续动作。
+
+不得处理、覆盖、提交或删除用户已有改动。
+
+## 结构化结果
+
+始终返回同一就绪度结构：
+
+```json
+{
+  "baselineReady": true,
+  "deviceReady": false,
+  "externalBlockers": [],
+  "capabilityBlockers": [
+    {
+      "capability": "device-validation",
+      "check": "harmony-device",
+      "reason": "no responsive target",
+      "remediation": "connect or start one HarmonyOS target"
+    }
+  ],
+  "allowedNonDeviceWork": true,
+  "allowedActions": [],
+  "evidence": [".migration/preflight-report.json"],
+  "suggestedRemediation": []
+}
+```
+
+字段语义：
+
+- `baselineReady`：工程定位、迁移配置和非设备基础能力是否足以支持 CLI 明确允许的后续工作；不能仅用 Preflight 总体退出码代替；
+- `deviceReady`：当前 HarmonyOS 目标是否满足设备类工作要求；
+- `externalBlockers`：需要用户、账号、签名、物理设备或外部环境变化的阻塞项；
+- `capabilityBlockers`：按能力说明阻塞范围，不能写成笼统的“迁移停止”；
+- `allowedNonDeviceWork`：当前是否仍可继续源码阅读、静态分析或非设备实现；
+- `allowedActions`：原样返回 CLI 快照中的允许动作；
+- `evidence`：本次读取或生成的状态、配置和 Preflight 报告；
+- `suggestedRemediation`：CLI 给出的可执行补救，不臆造成功结论。
+
+本 Skill 不推进外部状态机、不更新迁移报告、不创建 checkpoint、不调用 `complete`，也不决定定向测试或全量回归。调用方根据上述结果决定下一步。