阿里云 AI Staff 建站助手

要解决什么问题

把「口头需求」变成可访问的网站，中间通常要拆 PRD、选型、写页面和部署预览。阿里云 Zero2Staff / AI Staff 把这条链路放在云端对话里完成，但接口是异步的：chat 会立刻返回，真实进度要靠 SSE 事件 和轮询才能对齐。若代理不按阶段轮询、或在多轮 HITL 表单前反复打断用户，体验会拖得很长，也容易在鉴权或 chatStatus 失败时误重试。

本技能描述的是代理应如何驱动整条生命周期，而不是替你手写前端代码。

技能如何工作

鉴权走阿里云默认凭证链（环境变量、~/.alibabacloud/credentials、ECS/RAM 角色），不要在技能里硬编码 AK/SK；区域默认 cn-hangzhou。RAM 子账号需具备 zero2staff:CreateAIStaffConversation、CreateAIStaffChat、ListAIStaffChatEvents、ListAIStaffChatMessages、GetAIStaffPreviewUrl 等最小权限。

流程分三段，必须顺序执行：

1. create-conversation：拿到 ConversationId、SiteId、ChatId 等扁平 JSON，后续命令都依赖这些 ID。
2. 需求与 PRD（Phase 2）：先 chat 发起需求采集，再由代理每约 5 秒调用 poll，并向用户展示 phase / progressDetail 对应文案。仅第一轮 AskUserQuestion 需要向用户收集（应用名、业务描述、目标用户、参考站等）；后续 HITL 必须用事件里 answers 默认值自动填表并 resume，且首轮 resume 要带 --phase generate_prd --user-navigation generate_prd，--text 的 JSON 键需与表单表头一致。summary.hasPrd == true 且 chatStatus == success 后进入下一阶段。
3. 代码生成与预览（Phase 3）：触发生成后先给出站点链接，再约每 10 秒 poll，用 latestFile.semantic、filesWrittenCount 等拼进度。chatStatus == success 后必须调用 get-preview-url（沙箱冷启动可空 URL，间隔 10 秒最多重试 3 次）；改站后用同一 conversation-id 走 chat + poll，预览需 --restart。

poll 为单次拉取，需把上次返回的 lastEventId 传回；长时间无进展可用 list-messages 核对最后一条消息状态。

适用边界与注意点

• chatStatus == fail 或 hasError：应询问用户是否重试，不要自动重试。
• 每轮新 chat 可能清空旧 SSE；chat 会在发送前 drain 旧事件，轮询时别丢游标。
• 代码生成阶段平台可能自动触发多轮「magic fix」，poll 的 summary / 事件摘要会反映这一点。
• 验证通过标准：相关命令退出码为 0，且生成 output/alibabacloud-wxz-website-builder/validate.txt；过程证据与输出应落在 output/alibabacloud-wxz-website-builder/ 下。