atomic-service-dev

开发、审查、打包与上架 HarmonyOS 元服务（Atomic Service，免安装轻量应用形态）。核心方法：先核对"元服务与传统应用的差异红线"，确认需求在元服务能力边界内，再按场景加载离线参考文档执行。元服务只支持 Stage 模型 + ArkTS 接口 + 「元服务API集」，单 Ability、单包 ≤2MB、总包 ≤10MB、不支持 so/native——这些红线直接决定技术方案能否成立，必须先核对再动手。

When to Use

• 用户明确提出要开发元服务 / 原子化服务 / Atomic Service / 万能卡片
• 判断某个需求（native 模块、多 Ability、feature 模块、后台长时任务、超大包体）能否用元服务实现
• 元服务工程创建、包名（com.atomicservice.[appid]）与 APP ID 关联问题
• 分包设计、打包失败提示单包超 2MB、上架失败提示总包超 10MB、预加载 atomicService.preloads 配置
• 判断某个 API / 三方库是否属于「元服务API集」（API 文档「元服务API」标记）
• 开发或调试服务卡片（数量上限、ArkTS 卡片、postCardAction、卡片跳转限制）
• 实现元服务更新（静默/异步/阻断式）、拉起其他元服务（openAtomicService / App Linking）
• 元服务上架合规：命名规范、核准（备案）、AGC 云测试预检、AppAnalyzer 体检
• 评估元服务 vs 传统应用的技术路线选型（含 ASCF 路线辨析）

不适用：传统应用工程脚手架（create-hmos-project）、ArkTS 编译报错修复（arkts-debug）、运行期崩溃诊断（arkts-crash-diagnosis）、NDK/C++ 开发（arkts-ndk-dev）、轻量穿戴仿真调试（lite-simulator-debug）。

Boundary with Other Skills

Workflow (Follow Strictly)

1. 读入口索引与速查表

先读 references/INDEX.md（唯一入口），第一站读 references/13-atomic-vs-app-matrix.md（差异与限制红线速查，逐条标注官方来源）。

2. 确认目标形态与技术路线

核对 13 号第 1、4 节，确认用户目标是元服务、传统应用还是 ASCF 路线（两者无法混合开发）。若需求踩红线（references/13 第 2 节：so/native、多 Ability、feature 模块、总包 >10MB、非音频长时任务、穿戴设备等），明确告知限制并给出替代方案（如转传统应用路线），不要硬做。

3. 工程与包结构任务

创建工程/包名问题按 references/07-atomic-service-create-project.md；分包设计与超限处理按 references/04-atomic-subcontract.md；预加载配置按 references/05-atomic-preloading.md；配置文件写法参考 assets/atomic-module-config.json5。

4. 写码前核对 API 可用性

元服务只能使用「元服务API集」。按 references/06-atomic-apis-intro.md 与 13 号第 7 节的核对方法（API 文档「元服务API」标记、DevEco 高级筛选）逐个确认所写 API 可用；不可用时给出集内替代。服务卡片开发按 references/08-atomic-widget-development.md，跨元服务跳转按 references/10-start-other-atomicservices.md，版本更新按 references/09-atomic-service-update.md。

5. 上架与合规任务

上架前自检、命名、预检、体检按 references/12-atomic-service-release-check.md，并核对 13 号第 4 节（备案、测试方式）。

6. 引用来源

回答中引用所依据的参考文档，例如：

依据 references/04-atomic-subcontract.md（上游《分包》）：单包 ≤2MB 超限打包失败，总包 ≤10MB 超限上架失败。

7. 升级路径

本技能离线文档无法覆盖时（Kit 级开发指导、元服务API集新增、ASCF 指南、大屏适配细节），用 harmony-fetch 在线拉取华为官网 atomic-guides / atomic-references 对应文档后再继续，并引用来源。

Directory Structure

atomic-service-dev/
├── SKILL.md                                    # 本文件
├── references/
│   ├── INDEX.md                                # 唯一入口，必读
│   ├── 01-atomic-service-definition.md         # 官方：什么是元服务（含传统应用对比表）
│   ├── 02-atomic-service-features.md           # 官方：元服务特征及使用场景
│   ├── 03-atomic-service-package-basics.md     # 官方：程序包基础知识（免安装/老化）
│   ├── 04-atomic-subcontract.md                # 官方：分包（2MB/10MB/单Ability/shared）
│   ├── 05-atomic-preloading.md                 # 官方：预加载（atomicService.preloads）
│   ├── 06-atomic-apis-intro.md                 # 官方：元服务API说明（API集/不支持so）
│   ├── 07-atomic-service-create-project.md     # 官方：创建元服务工程
│   ├── 08-atomic-widget-development.md         # 官方：服务卡片开发 + 新建元服务卡片（聚合）
│   ├── 09-atomic-service-update.md             # 官方：元服务更新
│   ├── 10-start-other-atomicservices.md        # 官方：拉起其他元服务
│   ├── 11-atomic-backgroundtask.md             # 官方：长时任务（元服务限制）
│   ├── 12-atomic-service-release-check.md      # 官方：上架预检 + 体检工具 + 命名规范（聚合）
│   └── 13-atomic-vs-app-matrix.md              # 原创：元服务 vs 传统应用差异与限制速查
├── assets/
│   ├── atomic-module-config.json5              # 元服务 module.json5 关键配置（BAD/GOOD 注释）
│   └── atomic-widget-card.ets                  # 服务卡片 BAD/GOOD 示例
└── evals/
    └── evals.json                              # 触发/行为评测用例

Documentation Source & Maintenance

• 官方快照（01-12）抓取自华为开发者官网 atomic-guides / atomic-references 目录，经 harmony-fetch 的 MCP 与 REST 双通道核实，抓取/核实于 2026-09-01，来源头见各文档头部。13 号为原创整理，逐条标注上游链接，修订时须同步核对对应官方页面。
• 更新方式：重跑 harmony-fetch 抓取流程覆盖对应文件并更新来源头核实时间；「元服务API集」与包大小等红线属于易变约束，定期（建议每月）核对 04/06 两篇上游是否更新。