动手：做第一个应用

准备：装好 aidc，登录一次

这一课做一个最小的应用：只有一条 Skill，教智能体用现成的视觉能力检查现场照片——通道有没有堵、物料有没有乱放、有没有人没戴安全帽。你需要 Node 18 以上，和一个有 developer 权限的 AIDC 账号。

curl -fsSL https://www.ai-dc.ai/developer/cli/install.sh | sh
aidc login

登录时在终端里输入账号和密码。密码只由你本人输入，不交给智能体。也可以把 Developer 的上手说明交给智能体，让它替你装好、做完；登录那一步，仍然是你自己来。

建应用，写一条 Skill

aidc app init site-check --template skills --title "现场巡检"

它生成两个文件：清单 aidc.app.json，写应用的名字、一句话介绍和两三句示例说法（"entry": null 表示没有界面）；还有 skills/site-check/SKILL.md，就是那条 Skill。一条 Skill 分五段来写：

1. description

   写用户的目标和触发的场合，例如「用户发来现场照片、问有没有问题时使用」。智能体靠它决定什么时候想起这条 Skill。

2. 输入

   一张或几张照片；看不清就请人重拍，不硬判。

3. 步骤

   每张照片调一次 aidc vision inspect，再按结论排序：不合格、拿不准、合格。

4. 输出

   每张照片一行：结论，加上最要紧的一处问题；拿不准的写「需要人复核」。

5. 不要

   编造照片里没有的东西；把拿不准说成没问题。

部署，复制给智能体，试五句话

aidc app check site-check
aidc app deploy site-check

check 在本地校验清单和 Skill，规则和服务端是同一份；deploy 把它放进 test 通道。打开它的应用页，点「复制给智能体」，贴给你的智能体，再用五类说法各试一次：

不该用的时候被用上了，改 description；用对了但结果不稳，改正文。改完把版本号升一级，再部署一次。同样的文件重复部署不会产生新版本，重试是安全的。

发布到 Nexus

aidc app publish site-check

发布的就是刚才测过的那个版本，不重新打包。发布之后，它出现在公司的应用目录里：同事打开应用页，复制给自己的智能体就能用。发现问题，aidc app rollback site-check --version 0.1.0 一条命令退回更早的已测版本。

下一步是往上加：公司的语义层里有数据时，给应用导出几个 API，智能体和程序都能调；人需要看、比较、确认时，再加一个界面。怎么加、用哪些 SDK，在下一门课「用 AIDC Developer 做应用」里。