# @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 执行。

## 安装

```bash
# 两个宿主都装（默认）
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
