我第一次申请小艺开发者资质，卡在实名认证这一步前后耗了快一周。不是材料难，是我没想清楚"个人还是企业"就点了提交，后面要做 Skill 关联应用市场应用时才发现个人账号的边界，只能推倒重来。
当时我的心态是急着写代码，觉得资质这种东西就是走过场。后来才明白，它走的是"过场"，但卡的是"发布"------你写得再好，这一步没备齐，最后一步就出不去。
这一篇把动工前那些最容易劝退人的前置一次性说清，你照着备，能省掉我踩过的坑。
一、实名认证：个人还是企业，先定下来
华为开发者联盟的实名认证分个人和企业两种。个人认证门槛低、审核快；企业认证要营业执照、法人信息这些材料，慢一点，但能解锁商业能力------后面要接数字商品支付、走商业变现，必须企业账号。
我的建议很直接：只是试水做个工具类智能体练手，个人够用；如果规划里包含"Skill 随应用发布""接支付变现"，一开始就走企业。别像我，个人做完发现路被堵，再转企业重新走一遍实名，材料重交、审核重排，一周就没了。
选的时候问自己一个问题就够了：这个东西将来要不要收钱？ 要，就企业。
二、版本配对：DevEco 和 SDK 别装错
HarmonyOS 7 对应的开发基线，是 DevEco Studio 5.0 以上、鸿蒙 SDK 的 API 26.0.0 及以上。这两个是绑定的------SDK 版本决定了你能用哪些 API，装错一个，新建工程就编译报错。
我踩过一个很典型的坑：电脑上残留着旧的 DevEco 4.x，新建工程时它默认用了旧 SDK，跑起来一片红，而报错信息指向的是完全不相干的地方。后来我养成习惯，每次新建工程先看两处：工程的 compileSdkVersion 是不是 26.0.0，DevEco 主版本是不是 5.0+。确认这两项只要十秒，能省掉半天的无效排查。
另外，要做真机调试和端插件开发，设备系统得是 HarmonyOS 5.1.0 Release 及以上------这是平台文档里写的硬要求，低于它连调试入口都进不去。
三、真机与 ROM：老设备会卡住你
测试设备的 ROM 要在 6.0.0 及以上，小艺 App 版本要在 11.3.8.300 及以上。这俩不是随便凑的，端侧 Skill 的很多能力依赖新版本的小艺运行时，旧版本跑不出来，而且失败得很安静------不报错，就是没反应。
我当初借了台老设备想省钱，结果 ROM 锁在旧版本升不上去，端侧 Skill 怎么测都是失败。我一度怀疑是自己代码写错了，反复改了两轮，最后换机器才正常。那两轮改动全是白做。
所以动工前先确认手里的真机满足条件，别等写到一半才发现测不了。调试不通的时候先怀疑版本，再怀疑代码------这个顺序我后来一直保留着。
四、Skill 那个 AGC 硬前置，最容易卡人
这是最多人栽跟头的地方，我得重点说。
传统手写 Skill（跟着应用包一起发布那种）有个硬前置：它必须关联一个已经在 AppGallery Connect 上架的应用。没有已上架应用，Skill 根本发不出去。哪怕你用 VibeCoding 生成的 Skill 是平台托管，只要涉及端插件、要调应用内能力，最终还是要绑定 AGC 应用。
而 AGC 上架应用本身也要审核、也要时间。我第一次就是兴冲冲把 Skill 写完，点提交时才被提示"请先关联已上架应用"，而我的应用还卡在审核里------Skill 等着应用，应用等着审核，我干等了一周。
所以正确的顺序是：动工第一天就去 AGC 把应用建好、推进到上架流程，让它先跑起来。你写 Skill 的时间，正好够应用把审核走完。
五、我的动工清单
把上面几节压成一张清单，动工前逐项打勾：
- 实名认证定好个人还是企业（想不想收钱），并完成认证；
- 装 DevEco Studio 5.0+，新建工程确认 SDK API 26.0.0；
- 准备真机：ROM ≥ 6.0.0、小艺 App ≥ 11.3.8.300，且系统 ≥ HarmonyOS 5.1.0 Release；
- 去 AppGallery Connect 建好并推进应用上架（Skill 硬前置，最早启动）；
- 注册并登录小艺开放平台账号；
- 想清楚第一个智能体或 Skill，它的触发意图用一句话能说清。
这些前置加起来大概占掉一天，但一次性备齐，后面八篇就能顺滑走完。真正磨人的往往不是写代码，而是这种"不在代码线上、却卡在发布节骨眼"的关联依赖------AGC 那个前置就是典型，它唯一的要求是：比写代码更早开始。
下一篇，我们正式进小艺开放平台，把第一个智能体的骨架立起来，顺便把 LLM、工作流、A2A 三种模式一次讲透，帮你选对路。