从一句话到一个上线作品：AI Agent 在 CodeArts 里的完整交付链路

一、先说结论

我用一句话描述需求，让 CodeArts 码道 Agent 在沙箱里自己搭环境、写代码、跑自检、修 bug，最后通过一个 Skill 把作品发布到了开发者作品展馆，从输入需求到作品页可访问，全程大约 10 分钟。

这篇文章不复述"AI 好厉害"，而是把这条链路拆开，讲清楚哪一步是人该负责的、哪一步可以放心交给 Agent、以及哪些地方一定会卡住。

二、第一步：把需求写成 Agent 能执行的样子

很多人抱怨"AI 写出来的东西不是我想要的"，问题往往出在需求描述上。「做一个好看的主页」这种话，Agent 只能靠猜。

一个可执行的描述模板，我总结成四个要素：

作品用途是【做什么用的】
主要用户是【谁在用】
需要包含【核心功能 1、2、3】
界面风格希望是【视觉与交互调性】
完成后请启动项目供我预览

我这次的原文是：

请帮我创建一个可以运行的作品。作品用途是展示个人主页，主要用户是开发者，需要包含标题和一段自我介绍，界面风格希望是简约深色。完成后请启动项目供我预览。

关键在最后一句 “完成后请启动项目供我预览”。不加这句，Agent 可能写完文件就结束了；加了这句，它会把"能跑起来"当作验收标准，行为完全不同。

四要素里，"核心功能"要给可验证的名词，别给形容词。写"深色主题"没用，写"包含标题、自我介绍、项目列表、联系方式四个区块"才有约束力。

三、Agent 在沙箱里到底做了什么

这次执行过程我没有干预，观察下来它的动作序列是这样的：

1. ls 查看工作区，确认是空目录
2. 检查 Python / Node 是否可用，扫 8000 端口是否被占用
3. 写入 index.html、styles.css、script.js 三个文件
4. 主动装了 Playwright，写脚本把页面渲染出来截图自检
5. 做交互测试：检查控制台报错、按钮点击、移动端是否横向溢出
6. 发现两个问题——代码卡片内有一行溢出 44px、锚点跳转被固定导航遮住
7. 修掉这两个问题，重新验证
8. 启动本地服务并给出预览地址

第 4 步值得单独说。它愿意花时间装浏览器做离屏渲染验证，说明 Agent 的自我验收是有实际动作支撑的，不是"我觉得写完了"。这一步比多写两百行代码有价值得多。

顺带一提，它自己在总结里写了一句挺实在的话：“布局与交互均通过（无控制台错误、复制成功、移动端无横向滚动）”。这种把验收条件列清楚的输出方式，比"已完成，请查看"要有用。

四、发布链路：为什么值得做成 Skill

作品写完只是本地文件，要变成"展馆里的一个作品"，还差一串固定动作：

• 解析华为云账号身份，换取 STS 临时凭证
• 本地跑起项目并建立预览隧道
• 读 Git 信息、提取作品名、生成封面图
• 生成一句话简介和详情文章
• 选择投稿活动、提交、领取积分

这套流程每次都一样，正是 Skill 适合承载的东西——把"怎么做"固化下来，让 Agent 每次只关心"这次做什么"。

安装就一行：

npx skills add <skill-repo> --skill huawei-cloud-publish-work-to-gallery -y

装完之后 Agent 会自动识别到场景并调用，不用每次重复交代步骤。

五、三个必然会卡住的地方

这部分是踩出来的，比前面都值钱。

1. 作品目录本身必须是 Git 仓库根

Skill 需要读 Git 信息（仓库地址、分支、提交号），如果 /workspace 只是个普通目录，流程直接断在这一步。事前 git init 一下，或者准备好远端地址。

2. 凭证与授权是两个独立的门槛

• 凭证：发布需要一对永久访问密钥（AK/SK），会话里的临时 Token 不够用。密钥要走安全通道配置，不要贴在对话里——我这次就踩了这个坑，密钥进了聊天记录，事后只能轮换。
• 授权：GitCode 的 OAuth 必须本人扫码，Agent 替不了。

这两步是人工介入点，规划时间时要把它们算进去。

3. Agent 沙箱和你的终端不是同一台机器

这是一个容易误判的地方。Agent 说"你在本地终端执行某某命令"，但它其实运行在云端沙箱里，你在自己电脑上配好也没用。配置必须发生在它那台机器上。如果界面上没有暴露终端入口，就只能通过对话把参数交给它。

六、值得记住的几点

1. 需求描述的质量，决定 Agent 的上限。 四个要素 + 一句"跑起来给我看"，效果立竿见影。

2. 让 Agent 自己验证，比让它多写代码重要。 愿意装工具做离屏渲染、跑交互测试的 Agent，交付质量明显不同。

3. 固定流程就该 Skill 化。 发布、部署、打包这类"步骤永远一样、参数每次不同"的事，写成 Skill 能省掉大量重复交代。

4. 人工介入点要提前识别。 扫码、密钥、审批这类事，Agent 做不了也不该做，提前留出时间。

5. 密钥永远不要进对话。 这条我用自己的失误换来的——临时图省事，事后就得轮换。

七、最后

这一轮下来，我对"AI 编程"的实际感受是：它已经把"写代码"这件事的门槛降得很低了，但把需求讲清楚、把验收标准定下来、把不可外包的环节（授权、密钥、决策）自己守住，仍然是人该干的活。

工具越强，这几件事越是分水岭。