@harmonyos-arkts/d2h 0.0.0-stage → 0.1.1

package/schemas/spec-fact-corrections-shard.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harmonyos-ai.dev/schemas/spec-fact-corrections-shard.schema.json",
+  "title": "SPEC Semantic Corrections",
+  "type": "object",
+  "required": ["shardVersion", "factCorrections", "exclusions"],
+  "properties": { "shardVersion": { "const": "2.0.0" }, "factCorrections": { "type": "array", "items": { "$ref": "#/$defs/correction" } }, "exclusions": { "type": "array" } },
+  "$defs": { "correction": { "type": "object", "required": ["id", "entityKind", "operation", "targetRef", "factValue", "semanticValue", "reason", "sourceEvidence"], "properties": {
+    "id": { "type": "string", "minLength": 1 }, "entityKind": { "enum": ["surface", "control", "entry", "interaction"] }, "operation": { "enum": ["add", "update", "remove"] }, "targetRef": { "type": "string", "minLength": 1 },
+    "factValue": { "type": ["object", "null"] }, "semanticValue": { "type": ["object", "null"] }, "reason": { "type": "string", "minLength": 1 },
+    "sourceEvidence": { "type": "array", "minItems": 1, "items": { "type": "object", "required": ["file"], "properties": { "file": { "type": "string", "minLength": 1 }, "symbol": { "type": ["string", "null"] }, "line": { "type": ["integer", "null"] }, "endLine": { "type": ["integer", "null"] } }, "additionalProperties": false } }
+  }, "additionalProperties": false } }, "additionalProperties": false
+}

package/schemas/spec-features-shard.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harmonyos-ai.dev/schemas/spec-features-shard.schema.json",
+  "title": "SPEC Business Features Shard",
+  "type": "object",
+  "required": ["shardVersion", "domains", "features"],
+  "properties": {
+    "shardVersion": { "const": "2.0.0" },
+    "domains": { "type": "array", "items": { "$ref": "#/$defs/domain" } },
+    "features": { "type": "array", "items": { "$ref": "#/$defs/feature" } }
+  },
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "type": ["string", "null"], "minLength": 1 },
+    "refs": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "domain": {
+      "type": "object",
+      "required": ["id", "parentDomainRef", "name", "description", "featureRefs"],
+      "properties": {
+        "id": { "$ref": "#/$defs/text" },
+        "parentDomainRef": { "$ref": "#/$defs/nullableText" },
+        "name": { "$ref": "#/$defs/text" },
+        "description": { "$ref": "#/$defs/text" },
+        "featureRefs": { "$ref": "#/$defs/refs" }
+      },
+      "additionalProperties": false
+    },
+    "feature": {
+      "type": "object",
+      "required": ["id", "domainRef", "parentFeatureRef", "name", "description", "entryRefs"],
+      "properties": {
+        "id": { "$ref": "#/$defs/text" },
+        "domainRef": { "$ref": "#/$defs/text" },
+        "parentFeatureRef": { "$ref": "#/$defs/nullableText" },
+        "name": { "$ref": "#/$defs/text" },
+        "description": { "$ref": "#/$defs/text" },
+        "entryRefs": { "$ref": "#/$defs/refs" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/spec-index.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harmonyos-ai.dev/schemas/spec-index.schema.json",
+  "title": "Sharded SPEC Index",
+  "type": "object",
+  "required": ["specVersion", "shardFormatVersion", "language", "generation", "files", "counts", "factsSha256", "specSha256"],
+  "properties": {
+    "specVersion": { "const": "2.0.0" },
+    "shardFormatVersion": { "const": "2.0.0" },
+    "language": { "const": "zh-CN" },
+    "generation": { "type": "object" },
+    "files": {
+      "type": "object",
+      "required": ["facts", "semantics"],
+      "properties": {
+        "facts": { "type": "object", "required": ["app", "pages", "interactions", "unresolved"], "additionalProperties": { "type": "string", "minLength": 1 } },
+        "semantics": { "type": "object", "required": ["app", "pages", "interactions", "features", "unresolved", "corrections"], "additionalProperties": { "type": "string", "minLength": 1 } }
+      },
+      "additionalProperties": false
+    },
+    "counts": { "type": "object" },
+    "factsSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "specSha256": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }
+  },
+  "additionalProperties": false
+}

package/schemas/spec-interactions-shard.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harmonyos-ai.dev/schemas/spec-interactions-shard.schema.json",
+  "title": "SPEC 2.0.0 Interaction Facts Shard",
+  "type": "object",
+  "required": ["shardVersion", "interactions"],
+  "properties": {
+    "shardVersion": { "const": "2.0.0" },
+    "interactions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "relation", "fromRef", "toRef", "confidence", "sourceEvidence"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "relation": { "enum": ["opens", "navigates-to", "launches-for-result"] },
+          "fromRef": { "type": "string", "minLength": 1 },
+          "toRef": { "type": "string", "minLength": 1 },
+          "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+          "sourceEvidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["file", "symbol", "line", "endLine"],
+              "properties": {
+                "file": { "type": "string", "minLength": 1 },
+                "symbol": { "type": ["string", "null"] },
+                "line": { "type": ["integer", "null"], "minimum": 1 },
+                "endLine": { "type": ["integer", "null"], "minimum": 1 }
+              },
+              "additionalProperties": false
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/spec-page.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harmonyos-ai.dev/schemas/spec-page.schema.json",
+  "title": "SPEC 2.0.0 Surface Facts Shard",
+  "type": "object",
+  "required": ["shardVersion", "kind", "surface", "controls", "entries"],
+  "properties": {
+    "shardVersion": { "const": "2.0.0" },
+    "kind": { "const": "surface-facts" },
+    "surface": {
+      "type": "object",
+      "required": ["surfaceRef", "surfaceName", "surfaceType", "parentSurfaceRefs", "relation", "status", "sourceEvidence"],
+      "properties": {
+        "surfaceRef": { "type": "string", "minLength": 1 },
+        "surfaceName": { "type": "string", "minLength": 1 },
+        "surfaceType": { "type": "string", "minLength": 1 },
+        "parentSurfaceRefs": { "$ref": "#/$defs/refs" },
+        "relation": { "const": "hosts" },
+        "status": { "enum": ["root", "determined", "multiple", "unresolved"] },
+        "sourceEvidence": { "$ref": "#/$defs/evidenceList" }
+      },
+      "additionalProperties": false
+    },
+    "controls": { "type": "array", "items": { "$ref": "#/$defs/control" } },
+    "entries": { "type": "array", "items": { "$ref": "#/$defs/entry" } }
+  },
+  "$defs": {
+    "refs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "evidence": {
+      "type": "object",
+      "required": ["file", "symbol", "line", "endLine"],
+      "properties": {
+        "file": { "type": "string", "minLength": 1 },
+        "symbol": { "type": ["string", "null"] },
+        "line": { "type": ["integer", "null"], "minimum": 1 },
+        "endLine": { "type": ["integer", "null"], "minimum": 1 }
+      },
+      "additionalProperties": false
+    },
+    "evidenceList": { "type": "array", "items": { "$ref": "#/$defs/evidence" } },
+    "control": {
+      "type": "object",
+      "required": ["controlRef", "sourceCarrierRef", "name", "surfaceRef", "status", "sourceEvidence"],
+      "properties": {
+        "controlRef": { "type": "string", "minLength": 1 },
+        "sourceCarrierRef": { "type": "string", "minLength": 1 },
+        "name": { "type": "string", "minLength": 1 },
+        "surfaceRef": { "type": "string", "minLength": 1 },
+        "status": { "const": "determined" },
+        "sourceEvidence": { "$ref": "#/$defs/evidenceList" }
+      },
+      "additionalProperties": false
+    },
+    "entry": {
+      "type": "object",
+      "required": ["entryRef", "triggerCategory", "componentType", "ownershipStatus", "surfaceRef", "surfaceName", "surfaceType", "carrierRef", "carrierName", "carrierStatus", "event", "displayLabel", "handlerNames", "callTrace", "sourceEvidence", "warnings"],
+      "properties": {
+        "entryRef": { "type": "string", "minLength": 1 },
+        "triggerCategory": { "enum": ["user", "system", "application"] },
+        "componentType": { "enum": ["activity", "fragment", "dialog", "service", "receiver", "provider", "control", "custom-view", "unknown"] },
+        "ownershipStatus": { "enum": ["determined", "ambiguous", "unresolved"] },
+        "surfaceRef": { "type": ["string", "null"] },
+        "surfaceName": { "type": "string" },
+        "surfaceType": { "type": "string" },
+        "carrierRef": { "type": ["string", "null"] },
+        "carrierName": { "type": "string" },
+        "carrierStatus": { "enum": ["determined", "category-only", "not-applicable", "unknown"] },
+        "event": { "type": "string", "minLength": 1 },
+        "displayLabel": { "type": "string", "minLength": 1 },
+        "handlerNames": { "$ref": "#/$defs/refs" },
+        "callTrace": {
+          "type": "object",
+          "required": ["handlerRefs", "codeRefs", "callEdges", "truncated", "coverageWarnings"],
+          "properties": {
+            "handlerRefs": { "$ref": "#/$defs/refs" },
+            "codeRefs": { "type": "array", "items": { "type": "object" } },
+            "callEdges": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["from", "to"],
+                "properties": { "from": { "type": "string", "minLength": 1 }, "to": { "type": "string", "minLength": 1 } },
+                "additionalProperties": false
+              }
+            },
+            "truncated": { "type": "boolean" },
+            "coverageWarnings": { "type": "array", "items": { "type": "string" } }
+          },
+          "additionalProperties": false
+        },
+        "sourceEvidence": { "$ref": "#/$defs/evidenceList" },
+        "warnings": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/spec-pages-index.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://harmonyos-ai.dev/schemas/spec-pages-index.schema.json","title":"SPEC Facts or Semantics Pages Index","type":"object","required":["indexVersion","pages","unassignedEntriesFile"],"properties":{"indexVersion":{"const":"2.0.0"},"pages":{"type":"array","items":{"type":"object","required":["surfaceRef","file"],"properties":{"surfaceRef":{"type":"string","minLength":1},"surfaceType":{"type":"string","minLength":1},"file":{"type":"string","pattern":"^(facts|semantics)/pages/.+\\.json$"}},"additionalProperties":false}},"unassignedEntriesFile":{"type":["string","null"]}},"additionalProperties":false}

package/schemas/spec-unresolved-shard.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://harmonyos-ai.dev/schemas/spec-unresolved-shard.schema.json","title":"SPEC Unresolved Semantics Shard","type":"object","required":["shardVersion","reviews"],"properties":{"shardVersion":{"const":"2.0.0"},"reviews":{"type":"array","items":{"type":"object","required":["unresolvedRef","decision","featureRef","reason"],"properties":{"unresolvedRef":{"type":"string","minLength":1},"decision":{"enum":["pending","covered-by-feature","excluded","accepted-unknown"]},"featureRef":{"type":["string","null"]},"reason":{"type":["string","null"]}},"additionalProperties":false}}},"additionalProperties":false}

package/schemas/task-envelope.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harmonyos-ai.dev/schemas/task-envelope.schema.json",
+  "title": "Android to HarmonyOS Task Envelope Page",
+  "type": "object",
+  "required": ["taskEnvelopeVersion", "taskPlanSha256", "task", "brief", "coreFacts", "sourceContext", "continuation"],
+  "properties": {
+    "taskEnvelopeVersion": { "const": "1.0.0" },
+    "taskPlanSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "task": { "type": "object" },
+    "brief": { "type": "string", "minLength": 1 },
+    "coreFacts": { "type": "array" },
+    "sourceContext": {
+      "description": "Bounded source location indexes only. Source text/snippets are forbidden.",
+      "type": "array",
+      "maxItems": 200,
+      "items": { "$ref": "#/$defs/sourceIndex" }
+    },
+    "continuation": {
+      "type": "object",
+      "required": ["cursor", "remainingSourceContext"],
+      "properties": {
+        "cursor": { "type": ["string", "null"] },
+        "remainingSourceContext": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "sourceIndex": {
+      "type": "object",
+      "required": ["kind", "value"],
+      "properties": {
+        "kind": { "enum": ["source-evidence", "code-ref"] },
+        "value": {
+          "type": "object",
+          "properties": {
+            "id": { "type": "string" },
+            "file": { "type": "string", "minLength": 1 },
+            "name": { "type": "string" },
+            "symbol": { "type": ["string", "null"] },
+            "kind": { "type": "string" },
+            "type": { "type": "string" },
+            "line": { "type": ["integer", "null"], "minimum": 1 },
+            "startLine": { "type": "integer", "minimum": 1 },
+            "endLine": { "type": ["integer", "null"], "minimum": 1 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/task-plan.schema.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harmonyos-ai.dev/schemas/task-plan.schema.json",
+  "title": "Android to HarmonyOS Task Plan",
+  "type": "object",
+  "required": ["taskPlanVersion", "planningModelVersion", "factsAdapterVersion", "plannerPolicyVersion", "baseline", "entryResolution", "tasks", "ownership", "planningWarnings"],
+  "properties": {
+    "taskPlanVersion": { "const": "1.0.0" },
+    "planningModelVersion": { "const": "1.0.0" },
+    "factsAdapterVersion": { "const": "1.0.0" },
+    "plannerPolicyVersion": { "const": "1.1.0" },
+    "baseline": {
+      "type": "object",
+      "required": ["factsSha256", "planningInputSha256", "androidFingerprint", "specVersion", "factsWireVersion"],
+      "properties": {
+        "factsSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "planningInputSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "androidFingerprint": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+        "specVersion": { "type": "string", "minLength": 1 },
+        "factsWireVersion": { "const": "2.0.0" }
+      },
+      "additionalProperties": false
+    },
+    "entryResolution": {
+      "type": "object",
+      "required": ["launcherSurfaceRefs", "launcherEntryRefs", "origin"],
+      "properties": {
+        "launcherSurfaceRefs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "launcherEntryRefs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "origin": { "enum": ["explicit-fact", "launch-entry-fact", "unresolved"] }
+      },
+      "additionalProperties": false
+    },
+    "tasks": { "type": "array", "items": { "$ref": "#/$defs/task" } },
+    "ownership": {
+      "type": "object",
+      "required": ["primaryOwnerByFactRef", "supportingTaskIdsByFactRef"],
+      "properties": {
+        "primaryOwnerByFactRef": { "type": "object", "additionalProperties": { "type": "string", "minLength": 1 } },
+        "supportingTaskIdsByFactRef": { "type": "object", "additionalProperties": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } } }
+      },
+      "additionalProperties": false
+    },
+    "planningWarnings": { "type": "array", "items": { "$ref": "#/$defs/warning" } }
+  },
+  "$defs": {
+    "warning": {
+      "type": "object",
+      "required": ["code", "message", "relatedRefs"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 },
+        "relatedRefs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      },
+      "additionalProperties": false
+    },
+    "evidence": {
+      "type": "object",
+      "required": ["file", "symbol", "line", "endLine"],
+      "properties": {
+        "file": { "type": "string", "minLength": 1 },
+        "symbol": { "type": ["string", "null"] },
+        "line": { "type": ["integer", "null"], "minimum": 1 },
+        "endLine": { "type": ["integer", "null"], "minimum": 1 }
+      },
+      "additionalProperties": false
+    },
+    "task": {
+      "type": "object",
+      "required": ["id", "type", "title", "primaryFactRefs", "supportingFactRefs", "dependsOnTaskIds", "closure", "acceptance", "estimate"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^task:[a-f0-9]{16}$" },
+        "type": { "enum": ["resolution", "bootstrap", "capability", "journey", "assembly", "regression"] },
+        "title": { "type": "string", "minLength": 1 },
+        "primaryFactRefs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "supportingFactRefs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "dependsOnTaskIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^task:[a-f0-9]{16}$" } },
+        "closure": {
+          "type": "object",
+          "required": ["entryRefs", "surfaceRefs", "controlRefs", "interactionRefs", "sourceEvidence", "codeRefs", "unresolvedRefs", "warningRefs", "requiresSourceReview"],
+          "properties": {
+            "entryRefs": { "$ref": "#/$defs/refs" },
+            "surfaceRefs": { "$ref": "#/$defs/refs" },
+            "controlRefs": { "$ref": "#/$defs/refs" },
+            "interactionRefs": { "$ref": "#/$defs/refs" },
+            "sourceEvidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } },
+            "codeRefs": { "type": "array", "items": { "type": "object" } },
+            "unresolvedRefs": { "$ref": "#/$defs/refs" },
+            "warningRefs": { "$ref": "#/$defs/refs" },
+            "requiresSourceReview": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        },
+        "acceptance": {
+          "type": "object",
+          "required": ["observableOutcome", "requiredFactRefs", "verificationRequirements", "reportRefs"],
+          "properties": {
+            "observableOutcome": { "type": "string", "minLength": 1 },
+            "requiredFactRefs": { "$ref": "#/$defs/refs" },
+            "verificationRequirements": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+            "reportRefs": { "$ref": "#/$defs/refs" }
+          },
+          "additionalProperties": false
+        },
+        "estimate": {
+          "type": "object",
+          "required": ["factCount", "sourceFileCount", "traceNodeCount", "estimatedFactTokens", "downstreamUnlockCount"],
+          "properties": {
+            "factCount": { "type": "integer", "minimum": 0 },
+            "sourceFileCount": { "type": "integer", "minimum": 0 },
+            "traceNodeCount": { "type": "integer", "minimum": 0 },
+            "estimatedFactTokens": { "type": "integer", "minimum": 0 },
+            "downstreamUnlockCount": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "refs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+  },
+  "additionalProperties": false
+}

package/skills/android2hmos_resources_convert/SKILL.md

@@ -0,0 +1,162 @@
+---
+name: android2hmos_resources_convert
+description: >-
+  Android 图片资源迁移到 HarmonyOS：位图（png/jpg/webp/gif/bmp）、nine-patch（.9.png）、mipmap 启动图标、
+  自适应图标（adaptive-icon → layered_image.json）以及 XML drawable（vector/shape/layer-list/selector → SVG）。
+  当用户要求把 Android 项目的图标、图片、drawable 资产迁移/转换到鸿蒙工程（res/ → resources/…/media/），
+  处理限定符目录映射（drawable-hdpi、drawable-night、mipmap-anydpi-v26 等），或修复迁移后图片在鸿蒙上
+  显示空白/错误时触发。即使只说「迁移图标」「图片没迁移」「矢量图转 SVG」也应触发。
+  不处理 values 资源（strings/colors/dimens 的迁移归 arkts-i18n）、布局、Lottie 和字体。
+type: domain
+domain: migration
+tags: [migration, resources, android, images, svg, drawable]
+---
+
+# Android → HarmonyOS 图片资源转换
+
+本 skill 只转换**图片类资源**：位图文件（png/jpg/webp/gif/bmp）、nine-patch 图片、启动图标（mipmap、自适应图标），
+以及作为图片渲染的 XML drawable（`<vector>`、`<shape>`、`<layer-list>`、`<selector>`）→ SVG。
+values 资源（strings/colors/dimens 的迁移）、布局、Lottie、字体明确不在范围内；`values*/colors.xml` 和
+`values*/dimens.xml` 只作为解析 drawable 内 `@color:`/`@dimen:` 引用的查找来源被读取。
+
+## 参考文档
+
+| 要做什么 | 读什么 |
+|---|---|
+| 拷贝/转换位图、nine-patch、mipmap、自适应图标；限定符目录映射 | `references/image-conversion-rules.md` |
+| Android XML Drawable（vector/shape/layer-list/selector）转 SVG | `references/xml-drawable-to-svg-rules.md` |
+| 修复 SVG 显示问题（空白/不可见/尺寸错误/残留 Android 语法） | `references/svg-fix-patterns.md` |
+
+## 输入
+
+1. **Android 工程路径** — Android Gradle 工程根目录（含 `build.gradle` 或 `build.gradle.kts`）。
+2. **HarmonyOS 工程路径** — 由 Preflight 创建或复用的工程（见 `preparing-migration-workspace`），通常是迁移工作区下的 `ohos/`，或 `.migration/config.json` 中 `--harmony-project` 配置的路径。图片写入 `<harmony>/entry/src/main/resources/`。本 skill 不创建工程壳；`ohos/` 尚不存在时先运行 Preflight。
+
+## 工作流
+
+### 第 1 步：校验输入
+
+1. 确认 Android 工程路径存在且含 `build.gradle` 或 `build.gradle.kts`。
+2. 通过 `droid2hmos status <ANDROID_PROJECT>` 或 `.migration/config.json` 确认 HarmonyOS 工程位置，并确认 `entry/src/main/resources/` 存在；不存在时停止并先补 Preflight，不要猜测工程结构。
+
+### 第 2 步：确定资源来源
+
+使用工程源码 `res/` 目录：
+
+- 首选 `<android_project>/app/src/main/res/`
+- 多模块工程同时检查其它模块目录
+- 使用 flavor source set 时一并纳入（如 `app/src/debug/res/`、`app/src/flavor/res/`）
+
+恒定从源码 `res/` 转换：仅由库依赖（AAR）提供的图片不在源码 `res/` 中，这类引用在报告中记为 unresolved，不尝试回收。
+
+### 第 3 步：清点与分类
+
+扫描资源来源中的每个 `drawable*/` 和 `mipmap*/` 目录。对每个文件按**内容**分类（`.xml` 文件读根元素判断，绝不只按目录名分类）：
+
+| 分类 | 判定 | 路由 |
+|---|---|---|
+| 位图 | `.png`、`.jpg`、`.jpeg`、`.gif`、`.webp`、`.bmp` | 直接拷贝（第 4.1 步） |
+| Nine-patch | `.9.png` | 拷贝 + 重命名（第 4.1 步） |
+| XML drawable：vector/shape/layer-list | `.xml`，根 `<vector>` / `<shape>` / `<layer-list>` | 转 SVG（第 4.2 步） |
+| XML drawable：selector | `.xml`，根 `<selector>` | 提取默认状态 → SVG（第 4.2 步） |
+| 自适应图标 | `.xml`，根 `<adaptive-icon>` | 转 layered-image JSON（第 4.3 步） |
+| ripple/animated-vector/animated-selector/transition/level-list 等 | `.xml`，对应根元素 | 不可映射 — 记入报告 |
+
+忽略 `values*/`、`layout*/`、`menu/`、`raw/`、`font/`、`xml/`、`anim*/`、`color/` — 超出范围。只有 `values*/colors.xml` 和 `values*/dimens.xml` 被读取，用于解析 drawable 内的 `@color:`/`@dimen:` 引用（第 4.4 步）。
+
+### 第 4 步：转换
+
+转换前先读 `references/image-conversion-rules.md`。四条路由概要：
+
+**4.1 位图与 nine-patch → `media/`**
+- 拷贝到限定符映射后的 `media/` 目录（完整限定符算法见 image-conversion-rules.md）
+- `.9.png` → 重命名为 `<name>_9.png`（HarmonyOS 禁止资源文件名中含 `.`，仅允许最后扩展名分隔符）。nine-patch 拉伸语义丢失 — 报告中记录
+
+**4.2 XML drawable → `media/` 中的 `.svg`**
+- 严格按 `references/xml-drawable-to-svg-rules.md` 执行 — 尤其是强制保留 `clip-path`、三分支 `fill` 规则和渐变处理
+- 每生成一个 SVG 后，执行该文档中的自检（clip-path 数量、fill 规则、viewBox 匹配）
+
+**4.3 自适应图标 → layered-image JSON**
+- `<adaptive-icon>` → `<name>_layered_image.json`，只含 `background`/`foreground` 键
+- `@drawable/xxx`、`@mipmap/xxx` → `$media:xxx`；`@color/xxx` → 生成纯色 PNG（`<color_name>_bg.png`）— layered-image 不接受 `$color:` 引用
+- `monochrome` 不写入 JSON，但其引用的 drawable 仍按普通图片转换
+
+**4.4 解析 drawable 内引用**
+- SVG 填充/描边中的 `@color/name` → 从 `values*/colors.xml` 解析（沿引用链；兜底 `#000000` + 记录）
+- SVG 尺寸中的 `@dimen/name` → 从 `values*/dimens.xml` 解析（兜底：合理默认值 + 记录）
+- 未解析引用（库专属资源不在源码 `res/`）记入报告，绝不静默丢弃
+
+### 第 5 步：完整性校验
+
+1. 第 3 步发现的每个文件都有且只有一个结局：已转换，或在报告中列为 unmappable/unmapped
+2. 每个转换产物都实际存在于 HarmonyOS 工程
+3. 生成的 layered-image JSON 中每个 `$media:xxx` 引用都指向 `media/` 中存在的文件
+4. 每个转换后的 SVG 通过 `references/xml-drawable-to-svg-rules.md` 的自检
+5. HarmonyOS 工程已有 `.ets` 文件时，扫描 `$r('app.media.xxx')` 并核对每个引用的图片存在（已有 media 文件**不覆盖** — 合并，冲突记录）
+
+### 第 6 步：生成报告
+
+按 `maintaining-migration-report` 的轻量原则，把转换报告落盘到迁移工作区（如 `.migration/` 下）或直接向用户呈现，结构如下：
+
+```
+# Android to HarmonyOS Image Conversion Report
+
+## Resource Source
+- Resource source: source res/ (library-only images not included)
+- Resource source path: <path>
+
+## Summary
+- Image files found (bitmap/9-patch/XML drawable/adaptive icon): <count per class>
+- Successfully converted: <count>
+- Unmappable (ripple/animated-vector/etc.): <count>
+- Unmapped (unsupported qualifiers): <count>
+- Unresolved color/dimen references: <count>
+
+## Converted Images
+| Android Source | HarmonyOS Target | Type | Notes |
+|---|---|---|---|
+
+## Qualifier Mappings Applied
+| Android Qualifier Dir | HarmonyOS Qualifier Dir | Files Converted |
+|---|---|---|---|
+
+## Unmappable Resources
+| Android Source | Reason |
+|---|---|
+
+## Unresolved References
+| Resource File | Reference | Reason | Likely Source |
+|---|---|---|---|
+
+## Verification Results
+- All image files accounted for: Yes/No
+- All $media references satisfied: Yes/No
+- SVG self-checks passed: Yes/No
+```
+
+影响行为的结论（不可映射资源、丢失的 nine-patch 语义、未解析引用）必须回流到对应报告分片的说明，或按 orchestrator 约定写入 `discoveries.json`；不要只留在一次性报告里。
+
+### 第 7 步：Git 检查点
+
+一个连贯、已校验的转换批次完成后，按仓库约定创建检查点（只纳入 HarmonyOS 工程内的资源文件）：
+
+```text
+droid2hmos checkpoint create <ANDROID_PROJECT> --message <MESSAGE> --include <harmony>/entry/src/main/resources
+```
+
+## 重要说明
+
+- **XML drawable 转换是关键**：vector/shape/layer-list/selector 必须转成 SVG，不能跳过。转换前务必读 `references/xml-drawable-to-svg-rules.md` — 其中的属性映射表就是规范。
+- **SVG 渲染问题**（空白、不可见、尺寸错误、残留 `android:` 语法）按 `references/svg-fix-patterns.md` 处理，不做临时猜测。
+- **限定符目录是映射，不是保留**：`drawable-hdpi` → `ldpi/media/`（两平台 DPI 标签不同）；`night` → `dark`；`land` → `horizontal`；`v<N>` 剥离；`sw<N>dp`/`w<N>dp`/屏幕尺寸限定符整目录跳过。完整算法见 `references/image-conversion-rules.md`。
+- **转换恒定从源码 `res/` 出发**：仅库依赖（AAR）提供的图片不在其中；对它们的引用按 unresolved 报告，不做恢复。
+- 资源名保持 Android 原拼写 — 它们是标识符。
+- 解析 Android XML 时正确处理命名空间、注释和 CDATA；按 local name 匹配属性。
+
+## 与其他 skill 的关系
+
+- **preparing-migration-workspace**：⭐ 前置依赖。本 skill 需要 Preflight 已创建或复用的 HarmonyOS 工程（`ohos/`）。
+- **arkts-app-identity**：它处理 App 级身份资源（app.json5 图标字段、版本号、包名）；本 skill 负责 res/ 全量图片资产进 `media/`。启动器图标的位图/分层资产由本 skill 转换，app.json5 的接线归它。
+- **arkts-icon-sizing**：图片资产就位后，它修 `.ets` 消费侧丢失的 `.width()/.height()`；本 skill 只管资源侧。
+- **arkts-i18n**：values 资源（string.json 等）的迁移归它；本 skill 只把 colors.xml/dimens.xml 当查找源。
+- **maintaining-migration-report**：转换结论回流报告分片的轻量约定。