@hmos-library-adapter/sdk

鸿蒙三方库适配 / Android SDK 分支 — 把**原生 Android SDK（Java/Kotlin 库 + 可选 .so）整体迁移/重写成 HarmonyOS HAR（ArkTS + 可选 native）**的多阶段 Agent 流水线，安装到 OpenCode / Claude Code 两个宿主。

这是「鸿蒙三方库适配」系列的第三个平台分支（前两者为 Flutter、RN）。与 Flutter/RN 的「包一层桥接」不同，SDK 分支是源码级迁移：识别 Android 源码布局、抽取平台无关能力契约、按能力切片重写为 ArkTS HAR，并交叉编译 native。

本仓库本身不执行适配 —— 它只生产 Agent 资源（prompts、skills、scaffold 工程模板、stub agent、CLI 工具）并把入口接到用户机器，由用户在目标 Android SDK 仓库根触发宿主里的 agent 执行。

安装

# 两个宿主都装（默认）
bunx @hmos-library-adapter/sdk install
# 只装 OpenCode / Claude Code
bunx @hmos-library-adapter/sdk install --target opencode
bunx @hmos-library-adapter/sdk install --target claudecode
# 自检
bunx @hmos-library-adapter/sdk doctor

开发路径 5 阶段

analysis → planning → implementation → har-demo → evaluation

| # | Claude agent | marker JSON | 手写富产物 | |---|---|---|---| | 1 analysis | hmos-sdk-analysis | 01-analysis.json | 01-analysis-prd.md + work_unit_prd/ + 01-analysis-report.md | | 2 planning | hmos-sdk-planning | 02-planning.json | work_unit_plan/ + 02-planning-report.md | | 3 implementation | hmos-sdk-coding | 03-implementation.json | HAR 代码（.ets）+ 03-implementation-report.md | | 4 har-demo | hmos-sdk-har-demo | 04-har-demo.json | Demo 工程 + 04-har-demo-report.md | | 5 evaluation | hmos-sdk-evaluation | 05-evaluation.json | 05-evaluation-report.md |

产物写入 SDK 仓库根的 .ohos-adaptation/。Claude Code 对外入口是 hmos-library-adapter-sdk（orchestrator）。

产物模型（Markdown 驱动）

marker JSON 字段少，仅做 marker / 索引；真正富产物（PRD、work_unit_plan、HAR 代码、报告）由 agent 手写 Markdown / 代码。门禁 advance 用 requireArtifact 读 marker 的路径字段校验所指手写产物真实存在；PostWrite Hook 做 schema 校验（evaluation 阶段还跑跨阶段一致性）。

许可证

MIT