@buaa_smat/hometrans 0.1.13 → 0.1.15

package/env-requirements.json

@@ -1,181 +1,181 @@
-{
-  "$comment": [
-    "Declarative environment requirements for `ht init`.",
-    "`ht init` reads this file to (1) detect external tools and (2) report which",
-    "skills/agents are BLOCKED / LIMITED / OK by anything missing.",
-    "",
-    "tools[<id>]:",
-    "  source        'path'    -> locate a runnable command (where/which) trying each alias;",
-    "                'env-dir' -> a directory existence check (envVar resolved from ht config).",
-    "  aliases       command names to try in order (e.g. python, python3, py). First hit wins.",
-    "  verify        argv passed to the resolved command to print its version (existence proof too).",
-    "                Use a flag that prints-and-exits. NEVER use `python -v` (verbose REPL -> hangs);",
-    "                use `python --version`.",
-    "  versionStream 'stdout' (default) or 'stderr' (java -version prints to stderr).",
-    "  versionRegex  capture group(s) for the numeric version in the verify output.",
-    "  version       default required range for this tool, {min, max} as [min, max) — min",
-    "                inclusive, max exclusive; either may be null/omitted = unbounded. A",
-    "                requirement dependency may override this.",
-    "  fallback      when not on PATH, probe <base>/<segments>/<exe>. base is a config env key",
-    "                (DEVECO_SDK_HOME / DEVECO_PATH). Mirrors how the skills resolve hdc/java.",
-    "  hint          shown when the tool is missing.",
-    "",
-    "requirements[]: name + kind (skill|agent) + dependencies[] of",
-    "  { tool, level: 'required'|'optional', version?: {min,max} }.",
-    "  A missing 'required' tool -> BLOCKED; only 'optional' missing -> LIMITED; else OK."
-  ],
-
-  "tools": {
-    "deveco": {
-      "source": "env-dir",
-      "envVar": "DEVECO_SDK_HOME",
-      "hint": "set DEVECO_SDK_HOME via `ht init` (DevEco Studio install)"
-    },
-    "adb": {
-      "source": "path",
-      "aliases": ["adb"],
-      "verify": ["version"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "hint": "Android SDK platform-tools (needed for Android-device capture)"
-    },
-    "hdc": {
-      "source": "path",
-      "aliases": ["hdc"],
-      "verify": ["-v"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "fallback": { "base": "DEVECO_SDK_HOME", "segments": ["default", "openharmony", "toolchains"], "exe": "hdc" },
-      "hint": "ships with DevEco: <sdk>/default/openharmony/toolchains"
-    },
-    "python": {
-      "source": "path",
-      "aliases": ["python", "python3", "py"],
-      "verify": ["--version"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "version": { "min": "3.10.0", "max": null },
-      "hint": "install Python >= 3.10 and add to PATH (UI-align capture/parse scripts)"
-    },
-    "uv": {
-      "source": "path",
-      "aliases": ["uv"],
-      "verify": ["--version"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "hint": "https://docs.astral.sh/uv (AutoTest runs under uv)"
-    },
-    "java": {
-      "source": "path",
-      "aliases": ["java"],
-      "verify": ["-version"],
-      "versionStream": "stderr",
-      "versionRegex": "(\\d+(?:\\.\\d+){1,2})",
-      "fallback": { "base": "DEVECO_PATH", "segments": ["jbr", "bin"], "exe": "java" },
-      "hint": "any JDK 17+, or reuse DevEco jbr: <deveco>/jbr/bin"
-    },
-    "gitnexus": {
-      "source": "path",
-      "aliases": ["gitnexus"],
-      "verify": ["--version"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "hint": "npm i -g gitnexus && gitnexus setup"
-    }
-  },
-
-  "requirements": [
-    {
-      "name": "hmos-spec-generate",
-      "kind": "skill",
-      "dependencies": [{ "tool": "gitnexus", "level": "required" }]
-    },
-    {
-      "name": "hmos-resources-convert",
-      "kind": "skill",
-      "dependencies": [{ "tool": "java", "level": "optional" }],
-      "note": "no java -> falls back to source res/"
-    },
-    {
-      "name": "hmos-batch-ui-align",
-      "kind": "skill",
-      "dependencies": [
-        { "tool": "python", "level": "required", "version": { "min": "3.10.0", "max": null } },
-        { "tool": "adb", "level": "optional" }
-      ],
-      "note": "adb only for page exploration"
-    },
-    {
-      "name": "hmos-incremental-ui-align",
-      "kind": "skill",
-      "dependencies": [
-        { "tool": "deveco", "level": "required" },
-        { "tool": "python", "level": "required", "version": { "min": "3.10.0", "max": null } },
-        { "tool": "hdc", "level": "required" },
-        { "tool": "adb", "level": "required" }
-      ]
-    },
-    {
-      "name": "hmos-integration-test",
-      "kind": "skill",
-      "dependencies": [
-        { "tool": "deveco", "level": "required" },
-        { "tool": "uv", "level": "required" },
-        { "tool": "hdc", "level": "required" }
-      ]
-    },
-    {
-      "name": "hmos-fix-build-errors",
-      "kind": "skill",
-      "dependencies": [{ "tool": "deveco", "level": "required" }]
-    },
-    {
-      "name": "hmos-convert-pipeline",
-      "kind": "skill",
-      "dependencies": [
-        { "tool": "deveco", "level": "required" },
-        { "tool": "uv", "level": "optional" },
-        { "tool": "hdc", "level": "optional" }
-      ],
-      "note": "test stage skippable via skip-test"
-    },
-    {
-      "name": "logic-context-builder",
-      "kind": "agent",
-      "dependencies": [{ "tool": "python", "level": "optional" }]
-    },
-    {
-      "name": "logic-coder",
-      "kind": "agent",
-      "dependencies": [{ "tool": "python", "level": "optional" }]
-    },
-    {
-      "name": "spec-generator",
-      "kind": "agent",
-      "dependencies": [{ "tool": "gitnexus", "level": "required" }]
-    },
-    {
-      "name": "build-fixer",
-      "kind": "agent",
-      "dependencies": [{ "tool": "deveco", "level": "required" }]
-    },
-    {
-      "name": "code-reviewer",
-      "kind": "agent",
-      "dependencies": [{ "tool": "deveco", "level": "optional" }]
-    },
-    {
-      "name": "review-fixer",
-      "kind": "agent",
-      "dependencies": []
-    },
-    {
-      "name": "self-tester",
-      "kind": "agent",
-      "dependencies": [
-        { "tool": "uv", "level": "required" },
-        { "tool": "hdc", "level": "required" }
-      ]
-    },
-    {
-      "name": "self-test-fixer",
-      "kind": "agent",
-      "dependencies": []
-    }
-  ]
-}
+{
+  "$comment": [
+    "Declarative environment requirements for `ht init`.",
+    "`ht init` reads this file to (1) detect external tools and (2) report which",
+    "skills/agents are BLOCKED / LIMITED / OK by anything missing.",
+    "",
+    "tools[<id>]:",
+    "  source        'path'    -> locate a runnable command (where/which) trying each alias;",
+    "                'env-dir' -> a directory existence check (envVar resolved from ht config).",
+    "  aliases       command names to try in order (e.g. python, python3, py). First hit wins.",
+    "  verify        argv passed to the resolved command to print its version (existence proof too).",
+    "                Use a flag that prints-and-exits. NEVER use `python -v` (verbose REPL -> hangs);",
+    "                use `python --version`.",
+    "  versionStream 'stdout' (default) or 'stderr' (java -version prints to stderr).",
+    "  versionRegex  capture group(s) for the numeric version in the verify output.",
+    "  version       default required range for this tool, {min, max} as [min, max) — min",
+    "                inclusive, max exclusive; either may be null/omitted = unbounded. A",
+    "                requirement dependency may override this.",
+    "  fallback      when not on PATH, probe <base>/<segments>/<exe>. base is a config env key",
+    "                (DEVECO_SDK_HOME / DEVECO_HOME). Mirrors how the skills resolve hdc/java.",
+    "  hint          shown when the tool is missing.",
+    "",
+    "requirements[]: name + kind (skill|agent) + dependencies[] of",
+    "  { tool, level: 'required'|'optional', version?: {min,max} }.",
+    "  A missing 'required' tool -> BLOCKED; only 'optional' missing -> LIMITED; else OK."
+  ],
+
+  "tools": {
+    "deveco": {
+      "source": "env-dir",
+      "envVar": "DEVECO_SDK_HOME",
+      "hint": "set DEVECO_SDK_HOME via `ht init` (DevEco Studio install)"
+    },
+    "adb": {
+      "source": "path",
+      "aliases": ["adb"],
+      "verify": ["version"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "hint": "Android SDK platform-tools (needed for Android-device capture)"
+    },
+    "hdc": {
+      "source": "path",
+      "aliases": ["hdc"],
+      "verify": ["-v"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "fallback": { "base": "DEVECO_SDK_HOME", "segments": ["default", "openharmony", "toolchains"], "exe": "hdc" },
+      "hint": "ships with DevEco: <sdk>/default/openharmony/toolchains"
+    },
+    "python": {
+      "source": "path",
+      "aliases": ["python", "python3", "py"],
+      "verify": ["--version"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "version": { "min": "3.10.0", "max": null },
+      "hint": "install Python >= 3.10 and add to PATH (UI-align capture/parse scripts)"
+    },
+    "uv": {
+      "source": "path",
+      "aliases": ["uv"],
+      "verify": ["--version"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "hint": "https://docs.astral.sh/uv (AutoTest runs under uv)"
+    },
+    "java": {
+      "source": "path",
+      "aliases": ["java"],
+      "verify": ["-version"],
+      "versionStream": "stderr",
+      "versionRegex": "(\\d+(?:\\.\\d+){1,2})",
+      "fallback": { "base": "DEVECO_HOME", "segments": ["jbr", "bin"], "exe": "java" },
+      "hint": "any JDK 17+, or reuse DevEco jbr: <deveco>/jbr/bin"
+    },
+    "gitnexus": {
+      "source": "path",
+      "aliases": ["gitnexus"],
+      "verify": ["--version"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "hint": "npm i -g gitnexus && gitnexus setup"
+    }
+  },
+
+  "requirements": [
+    {
+      "name": "hmos-spec-generate",
+      "kind": "skill",
+      "dependencies": [{ "tool": "gitnexus", "level": "required" }]
+    },
+    {
+      "name": "hmos-resources-convert",
+      "kind": "skill",
+      "dependencies": [{ "tool": "java", "level": "optional" }],
+      "note": "no java -> falls back to source res/"
+    },
+    {
+      "name": "hmos-batch-ui-align",
+      "kind": "skill",
+      "dependencies": [
+        { "tool": "python", "level": "required", "version": { "min": "3.10.0", "max": null } },
+        { "tool": "adb", "level": "optional" }
+      ],
+      "note": "adb only for page exploration"
+    },
+    {
+      "name": "hmos-incremental-ui-align",
+      "kind": "skill",
+      "dependencies": [
+        { "tool": "deveco", "level": "required" },
+        { "tool": "python", "level": "required", "version": { "min": "3.10.0", "max": null } },
+        { "tool": "hdc", "level": "required" },
+        { "tool": "adb", "level": "required" }
+      ]
+    },
+    {
+      "name": "hmos-integration-test",
+      "kind": "skill",
+      "dependencies": [
+        { "tool": "deveco", "level": "required" },
+        { "tool": "uv", "level": "required" },
+        { "tool": "hdc", "level": "required" }
+      ]
+    },
+    {
+      "name": "hmos-fix-build-errors",
+      "kind": "skill",
+      "dependencies": [{ "tool": "deveco", "level": "required" }]
+    },
+    {
+      "name": "hmos-convert-pipeline",
+      "kind": "skill",
+      "dependencies": [
+        { "tool": "deveco", "level": "required" },
+        { "tool": "uv", "level": "optional" },
+        { "tool": "hdc", "level": "optional" }
+      ],
+      "note": "test stage skippable via skip_test"
+    },
+    {
+      "name": "logic-context-builder",
+      "kind": "agent",
+      "dependencies": [{ "tool": "python", "level": "optional" }]
+    },
+    {
+      "name": "logic-coder",
+      "kind": "agent",
+      "dependencies": [{ "tool": "python", "level": "optional" }]
+    },
+    {
+      "name": "spec-generator",
+      "kind": "agent",
+      "dependencies": [{ "tool": "gitnexus", "level": "required" }]
+    },
+    {
+      "name": "build-fixer",
+      "kind": "agent",
+      "dependencies": [{ "tool": "deveco", "level": "required" }]
+    },
+    {
+      "name": "code-reviewer",
+      "kind": "agent",
+      "dependencies": [{ "tool": "deveco", "level": "optional" }]
+    },
+    {
+      "name": "review-fixer",
+      "kind": "agent",
+      "dependencies": []
+    },
+    {
+      "name": "self-tester",
+      "kind": "agent",
+      "dependencies": [
+        { "tool": "uv", "level": "required" },
+        { "tool": "hdc", "level": "required" }
+      ]
+    },
+    {
+      "name": "self-test-fixer",
+      "kind": "agent",
+      "dependencies": []
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buaa_smat/hometrans",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "HomeTrans (Android-to-HarmonyOS) skill + agent installer. Run `ht init` to distribute conversion skills and subagents into AI editors.",
   "license": "MIT",
   "repository": {

package/resource/migration_process.svg

@@ -0,0 +1,94 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1120 1080" width="1120" height="1080">
+  <style>
+    text { font-family: 'Helvetica Neue', Helvetica, Arial, 'PingFang SC', 'Microsoft YaHei', 'Microsoft JhengHei', 'SimHei', sans-serif; }
+    .title { font-size: 20px; font-weight: 600; fill: #111827; }
+    .sub   { font-size: 12px; fill: #6b7280; }
+    .banner{ font-size: 12px; fill: #047857; font-weight: 600; }
+    .nt    { font-size: 14px; font-weight: 600; fill: #111827; }
+    .ns    { font-size: 11px; fill: #6b7280; }
+    .pin   { font-size: 11px; fill: #1d4ed8; }
+    .pout  { font-size: 11px; fill: #047857; }
+    .dlab  { font-size: 11px; font-weight: 600; fill: #047857; }
+    .lg    { font-size: 12px; fill: #374151; }
+  </style>
+  <defs>
+    <marker id="arrow" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#2563eb"/>
+    </marker>
+    <marker id="arrowg" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#059669"/>
+    </marker>
+  </defs>
+  <rect width="1120" height="1080" fill="#ffffff"/>
+  <text x="40" y="40" class="title">Android → HarmonyOS 迁移流程 · 含参数传递</text>
+  <text x="40" y="62" class="sub">蓝箭头=执行顺序；绿色=参数/产物传递；橙色框=人工介入</text>
+  <rect x="280" y="70" width="560" height="44" rx="8" fill="#ecfdf5" stroke="#10b981" stroke-width="1.4" stroke-dasharray="6,4"/>
+  <text x="560" y="90" text-anchor="middle" class="banner">公共入参（所有步骤共享）：android_project_dir · harmony_project_dir</text>
+  <text x="560" y="106" text-anchor="middle" class="banner">步骤2 产物写入 harmony_project_dir，步骤4 据此构建</text>
+  <rect x="340" y="140" width="440" height="50" rx="25.0" fill="#f0fdf4" stroke="#16a34a" stroke-width="1.6"/>
+  <text x="560" y="170" text-anchor="middle" class="nt">开始：准备 Android 源项目 + 鸿蒙目标项目</text>
+  <rect x="100" y="292" width="440" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="320" y="310" text-anchor="middle" class="nt">步骤1.1 UI 迁移</text>
+  <text x="320" y="328" text-anchor="middle" class="ns">skill:hmos-batch-ui-align</text>
+  <text x="320" y="348" text-anchor="middle" class="pin">入参: 公共入参 + [ui_info_root, pages]</text>
+  <text x="320" y="367" text-anchor="middle" class="pout">出参: ArkTS页面 + 资源(含资源转换) + 批量报告</text>
+  <rect x="580" y="292" width="440" height="96" rx="9" fill="#f5f9ff" stroke="#2563eb" stroke-width="1.6" stroke-dasharray="6,4"/>
+  <text x="800" y="310" text-anchor="middle" class="nt">步骤1.2 UI 对齐</text>
+  <text x="800" y="328" text-anchor="middle" class="ns">skill:hmos-incremental-ui-align</text>
+  <text x="800" y="348" text-anchor="middle" class="pin">入参: 公共入参 + [capture_output_dir]</text>
+  <text x="800" y="367" text-anchor="middle" class="pout">出参: 修改后ArkTS页面 + 双端截图/视图树 + 对齐报告</text>
+  <rect x="330" y="448" width="460" height="64" rx="9" fill="#fff7ed" stroke="#ea580c" stroke-width="1.6"/>
+  <circle cx="354.0" cy="473" r="4.5" fill="#ea580c"/>
+  <path d="M 347.0,488 Q 354.0,479 361.0,488" fill="none" stroke="#ea580c" stroke-width="2.2" stroke-linecap="round"/>
+  <text x="574" y="472" text-anchor="middle" class="nt">编写 REQ.txt（需求描述）</text>
+  <text x="574" y="492" text-anchor="middle" class="ns">使用自然语言描述原始需求，用空行分隔多个需求</text>
+  <text x="574" y="509" text-anchor="middle" class="pout">产出: REQ.txt</text>
+  <rect x="310" y="562" width="500" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="560" y="580" text-anchor="middle" class="nt">步骤2 生成需求规格</text>
+  <text x="560" y="598" text-anchor="middle" class="ns">skill:hmos-spec-generate</text>
+  <text x="560" y="618" text-anchor="middle" class="pin">入参: 公共入参 + requirement_description_file(=REQ.txt) + spec_output_dir</text>
+  <text x="560" y="637" text-anchor="middle" class="pout">出参: 〈feature〉-SPEC.md + .trace/〈feature〉.md</text>
+  <rect x="310" y="710" width="500" height="80" rx="9" fill="#fff7ed" stroke="#ea580c" stroke-width="1.6"/>
+  <circle cx="334.0" cy="743" r="4.5" fill="#ea580c"/>
+  <path d="M 327.0,758 Q 334.0,749 341.0,758" fill="none" stroke="#ea580c" stroke-width="2.2" stroke-linecap="round"/>
+  <text x="574" y="734" text-anchor="middle" class="nt">编写测试用例 + 连鸿蒙真机 / 配置签名</text>
+  <text x="574" y="754" text-anchor="middle" class="ns">如果不执行步骤4中的集成测试（skip_test=true）可跳过此步骤</text>
+  <text x="574" y="771" text-anchor="middle" class="pout">产出: test_case.md / pre_test_case.md</text>
+  <rect x="300" y="842" width="520" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="560" y="860" text-anchor="middle" class="nt">步骤3 逻辑代码转换流水线</text>
+  <text x="560" y="878" text-anchor="middle" class="ns">skill:hmos-convert-pipeline</text>
+  <text x="560" y="898" text-anchor="middle" class="pin">入参: 公共入参 + spec_file_path(=SPEC.md) + [test_case_path, pre_test_case_path, skip_test …]</text>
+  <text x="560" y="917" text-anchor="middle" class="pout">出参: 已签名HAP + pipeline-manifest.md + 各阶段报告</text>
+  <rect x="400" y="983" width="320" height="54" rx="9" fill="#ede9fe" stroke="#7c3aed" stroke-width="1.6"/>
+  <text x="560" y="1015" text-anchor="middle" class="nt">产物：已签名 HAP</text>
+  <path d="M560,190 V250 H320 V292" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,190 V250 H800 V292" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M320,388 V418 H558 V448" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M800,388 V418 H562 V448" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,512 V562" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,658 V710" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,790 V842" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,938 V983" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M810,610 H865 V890 H822" fill="none" stroke="#059669" stroke-width="1.6" stroke-dasharray="6,4" marker-end="url(#arrowg)"/>
+  <rect x="415" y="528" width="290" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="540" text-anchor="middle" class="dlab">REQ.txt ⇒ requirement_description_file</text>
+  <rect x="445" y="797" width="230" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="809" text-anchor="middle" class="dlab">test_case.md ⇒ test_case_path</text>
+  <rect x="415" y="815" width="290" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="827" text-anchor="middle" class="dlab">pre_test_case.md ⇒ pre_test_case_path</text>
+  <rect x="440" y="949" width="240" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="961" text-anchor="middle" class="dlab">已签名HAP · pipeline-manifest.md</text>
+  <text x="872" y="745" class="dlab">〈feature〉-SPEC.md ⇒ spec_file_path</text>
+  <g transform="translate(40,920)">
+    <line x1="0" y1="6" x2="26" y2="6" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+    <text x="34" y="10" class="lg">执行顺序</text>
+    <line x1="0" y1="26" x2="26" y2="26" stroke="#059669" stroke-width="1.6" stroke-dasharray="6,4" marker-end="url(#arrowg)"/>
+    <text x="34" y="30" class="lg">参数 / 产物传递</text>
+    <rect x="0" y="42" width="20" height="14" rx="3" fill="#eff6ff" stroke="#2563eb" stroke-width="1.4"/>
+    <text x="34" y="53" class="lg">自动化步骤（skill）</text>
+    <rect x="0" y="64" width="20" height="14" rx="3" fill="#fff7ed" stroke="#ea580c" stroke-width="1.4"/>
+    <text x="34" y="75" class="lg">人工介入</text>
+    <rect x="0" y="86" width="20" height="14" rx="3" fill="#f5f9ff" stroke="#2563eb" stroke-width="1.4" stroke-dasharray="6,4"/>
+    <text x="34" y="97" class="lg">可选 / 按需</text>
+  </g>
+</svg>

package/resource/migration_process_transparent.svg

@@ -0,0 +1,93 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1120 1080" width="1120" height="1080">
+  <style>
+    text { font-family: 'Helvetica Neue', Helvetica, Arial, 'PingFang SC', 'Microsoft YaHei', 'Microsoft JhengHei', 'SimHei', sans-serif; }
+    .title { font-size: 20px; font-weight: 600; fill: #111827; }
+    .sub   { font-size: 12px; fill: #6b7280; }
+    .banner{ font-size: 12px; fill: #047857; font-weight: 600; }
+    .nt    { font-size: 14px; font-weight: 600; fill: #111827; }
+    .ns    { font-size: 11px; fill: #6b7280; }
+    .pin   { font-size: 11px; fill: #1d4ed8; }
+    .pout  { font-size: 11px; fill: #047857; }
+    .dlab  { font-size: 11px; font-weight: 600; fill: #047857; }
+    .lg    { font-size: 12px; fill: #374151; }
+  </style>
+  <defs>
+    <marker id="arrow" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#2563eb"/>
+    </marker>
+    <marker id="arrowg" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#059669"/>
+    </marker>
+  </defs>
+  <text x="40" y="40" class="title">Android → HarmonyOS 迁移流程 · 含参数传递</text>
+  <text x="40" y="62" class="sub">蓝箭头=执行顺序；绿色=参数/产物传递；橙色框=人工介入</text>
+  <rect x="280" y="70" width="560" height="44" rx="8" fill="#ecfdf5" stroke="#10b981" stroke-width="1.4" stroke-dasharray="6,4"/>
+  <text x="560" y="90" text-anchor="middle" class="banner">公共入参（所有步骤共享）：android_project_dir · harmony_project_dir</text>
+  <text x="560" y="106" text-anchor="middle" class="banner">步骤2 产物写入 harmony_project_dir，步骤4 据此构建</text>
+  <rect x="340" y="140" width="440" height="50" rx="25.0" fill="#f0fdf4" stroke="#16a34a" stroke-width="1.6"/>
+  <text x="560" y="170" text-anchor="middle" class="nt">开始：准备 Android 源项目 + 鸿蒙目标项目</text>
+  <rect x="100" y="292" width="440" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="320" y="310" text-anchor="middle" class="nt">步骤1.1 UI 迁移</text>
+  <text x="320" y="328" text-anchor="middle" class="ns">skill:hmos-batch-ui-align</text>
+  <text x="320" y="348" text-anchor="middle" class="pin">入参: 公共入参 + [ui_info_root, pages]</text>
+  <text x="320" y="367" text-anchor="middle" class="pout">出参: ArkTS页面 + 资源(含资源转换) + 批量报告</text>
+  <rect x="580" y="292" width="440" height="96" rx="9" fill="#f5f9ff" stroke="#2563eb" stroke-width="1.6" stroke-dasharray="6,4"/>
+  <text x="800" y="310" text-anchor="middle" class="nt">步骤1.2 UI 对齐</text>
+  <text x="800" y="328" text-anchor="middle" class="ns">skill:hmos-incremental-ui-align</text>
+  <text x="800" y="348" text-anchor="middle" class="pin">入参: 公共入参 + [capture_output_dir]</text>
+  <text x="800" y="367" text-anchor="middle" class="pout">出参: 修改后ArkTS页面 + 双端截图/视图树 + 对齐报告</text>
+  <rect x="330" y="448" width="460" height="64" rx="9" fill="#fff7ed" stroke="#ea580c" stroke-width="1.6"/>
+  <circle cx="354.0" cy="473" r="4.5" fill="#ea580c"/>
+  <path d="M 347.0,488 Q 354.0,479 361.0,488" fill="none" stroke="#ea580c" stroke-width="2.2" stroke-linecap="round"/>
+  <text x="574" y="472" text-anchor="middle" class="nt">编写 REQ.txt（需求描述）</text>
+  <text x="574" y="492" text-anchor="middle" class="ns">使用自然语言描述原始需求，用空行分隔多个需求</text>
+  <text x="574" y="509" text-anchor="middle" class="pout">产出: REQ.txt</text>
+  <rect x="310" y="562" width="500" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="560" y="580" text-anchor="middle" class="nt">步骤2 生成需求规格</text>
+  <text x="560" y="598" text-anchor="middle" class="ns">skill:hmos-spec-generate</text>
+  <text x="560" y="618" text-anchor="middle" class="pin">入参: 公共入参 + requirement_description_file(=REQ.txt) + spec_output_dir</text>
+  <text x="560" y="637" text-anchor="middle" class="pout">出参: 〈feature〉-SPEC.md + .trace/〈feature〉.md</text>
+  <rect x="310" y="710" width="500" height="80" rx="9" fill="#fff7ed" stroke="#ea580c" stroke-width="1.6"/>
+  <circle cx="334.0" cy="743" r="4.5" fill="#ea580c"/>
+  <path d="M 327.0,758 Q 334.0,749 341.0,758" fill="none" stroke="#ea580c" stroke-width="2.2" stroke-linecap="round"/>
+  <text x="574" y="734" text-anchor="middle" class="nt">编写测试用例 + 连鸿蒙真机 / 配置签名</text>
+  <text x="574" y="754" text-anchor="middle" class="ns">如果不执行步骤4中的集成测试（skip_test=true）可跳过此步骤</text>
+  <text x="574" y="771" text-anchor="middle" class="pout">产出: test_case.md / pre_test_case.md</text>
+  <rect x="300" y="842" width="520" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="560" y="860" text-anchor="middle" class="nt">步骤3 逻辑代码转换流水线</text>
+  <text x="560" y="878" text-anchor="middle" class="ns">skill:hmos-convert-pipeline</text>
+  <text x="560" y="898" text-anchor="middle" class="pin">入参: 公共入参 + spec_file_path(=SPEC.md) + [test_case_path, pre_test_case_path, skip_test …]</text>
+  <text x="560" y="917" text-anchor="middle" class="pout">出参: 已签名HAP + pipeline-manifest.md + 各阶段报告</text>
+  <rect x="400" y="983" width="320" height="54" rx="9" fill="#ede9fe" stroke="#7c3aed" stroke-width="1.6"/>
+  <text x="560" y="1015" text-anchor="middle" class="nt">产物：已签名 HAP</text>
+  <path d="M560,190 V250 H320 V292" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,190 V250 H800 V292" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M320,388 V418 H558 V448" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M800,388 V418 H562 V448" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,512 V562" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,658 V710" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,790 V842" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,938 V983" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M810,610 H865 V890 H822" fill="none" stroke="#059669" stroke-width="1.6" stroke-dasharray="6,4" marker-end="url(#arrowg)"/>
+  <rect x="415" y="528" width="290" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="540" text-anchor="middle" class="dlab">REQ.txt ⇒ requirement_description_file</text>
+  <rect x="445" y="797" width="230" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="809" text-anchor="middle" class="dlab">test_case.md ⇒ test_case_path</text>
+  <rect x="415" y="815" width="290" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="827" text-anchor="middle" class="dlab">pre_test_case.md ⇒ pre_test_case_path</text>
+  <rect x="440" y="949" width="240" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="961" text-anchor="middle" class="dlab">已签名HAP · pipeline-manifest.md</text>
+  <text x="872" y="745" class="dlab">〈feature〉-SPEC.md ⇒ spec_file_path</text>
+  <g transform="translate(40,920)">
+    <line x1="0" y1="6" x2="26" y2="6" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+    <text x="34" y="10" class="lg">执行顺序</text>
+    <line x1="0" y1="26" x2="26" y2="26" stroke="#059669" stroke-width="1.6" stroke-dasharray="6,4" marker-end="url(#arrowg)"/>
+    <text x="34" y="30" class="lg">参数 / 产物传递</text>
+    <rect x="0" y="42" width="20" height="14" rx="3" fill="#eff6ff" stroke="#2563eb" stroke-width="1.4"/>
+    <text x="34" y="53" class="lg">自动化步骤（skill）</text>
+    <rect x="0" y="64" width="20" height="14" rx="3" fill="#fff7ed" stroke="#ea580c" stroke-width="1.4"/>
+    <text x="34" y="75" class="lg">人工介入</text>
+    <rect x="0" y="86" width="20" height="14" rx="3" fill="#f5f9ff" stroke="#2563eb" stroke-width="1.4" stroke-dasharray="6,4"/>
+    <text x="34" y="97" class="lg">可选 / 按需</text>
+  </g>
+</svg>

package/skills/hmos-batch-ui-align/SKILL.md

@@ -7,6 +7,16 @@ description: Batch-convert multiple Android Activity UI snapshots to HarmonyOS A
 
 Batch-convert a set of Android page snapshots (each snapshot is a `page_NNNN_ActivityName/` directory containing `meta.json` + `view.xml` + optional `screenshot.png`) into HarmonyOS ArkTS pages following MVVM architecture.
 
+## Step 0 — Environment Variables Check (run first)
+
+The final build (Step 6, via `hmos_fix_build_errors`) reads the DevEco location **directly from the OS environment variables** (`echo "$VAR"` on macOS/Linux; `$env:VAR` in PowerShell on Windows):
+
+| Variable | Needed for | Valid when |
+|---|---|---|
+| `DEVECO_HOME` *(or `DEVECO_SDK_HOME`)* | Step 6 unified build | resolves to a valid DevEco install |
+
+If neither `DEVECO_HOME` nor `DEVECO_SDK_HOME` is set, **ask the user** for the DevEco Studio install path before proceeding (suggest running `ht init` to persist it as a machine environment variable).
+
 ## Step 1 — Parse User Request
 
 Extract 4 paths from the user's message (natural language, no fixed format):