AiriLab Skill

目标

• - 将 AiriLab SaaS 的多接口流程封装为可对话调用的单一技能。
• 在调用图像能力前，自动保证登录态与项目上下文有效。
• 通过后台 worker 追踪异步任务并主动回推结果。

能力范围

• - 鉴权：手机号 + 验证码登录，持久化 token。
• 项目管理：拉取团队/项目、选择项目、持久化项目上下文。
• 图像工作流：

• - 异步任务：提交后轮询状态，完成后拉取记录并通知用户。

触发规则

• - MJ 创意渲染：文生图、概念图、效果图、参考图生成、多图出图。
• 创意放大：清晰度增强、超分辨率、长边 4K 放大、细节/纹理增强。
• 氛围转换：天气/季节/昼夜切换，提升画面氛围、故事感和视觉张力。
• AiriLab 流程操作：登录、验证码、选择项目、切换项目、查询任务状态、拉取任务结果。

强触发关键词（任一命中即可）：

• - MJ/渲染类：mj、midjourney、文生图、渲染、概念图、效果图、参考图出图、INLINECODE10
• 放大类：创意放大、放大、高清、超分、4k、长边4k、细节增强、INLINECODE18
• 氛围类：氛围转换、atmosphere、天气切换、季节切换、白天转夜景、晴天、雨天、INLINECODE26
• 流程类：airilab登录、验证码登录、选择项目、切换项目、projectId、jobId、任务状态、INLINECODE34

高置信触发语句示例：

• - “用 MJ 生成 4 张现代建筑外立面概念图。”
• “把这张图做创意放大，长边 4K，细节和质感增强。”
• “把这张白天街景转成雨夜氛围，保留构图。”
• “帮我登录 AiriLab，然后列出项目让我选一个。”
• “这个 jobId 帮我查下状态，完成后把结果发我。”

触发优先级：

1. 1. 用户上传图像且包含“放大/氛围转换/改图”语义 -> 优先匹配 workflowId=16 或 workflowId=13。
2. 无上传图像但包含“生成/渲染/MJ”语义 -> 匹配 workflowId=0。
3. 包含“登录/项目/job 状态/结果”语义 -> 进入鉴权、项目或异步任务查询流程。

不触发条件（避免误触发）：

• - 用户仅讨论通用设计理论、审美评价，不要求生成/改图/放大/状态查询。
• 用户请求与 AiriLab 无关的纯文本任务（翻译、总结、写作）且未提及图像工作流。

前置条件（强约束）

1. 1. 调用任何 AiriLab 接口前必须检查登录态。
2. 提交图像任务前必须存在已选项目（teamId/projectId/projectName）。
3. 登录失效时必须引导手机号验证码登录，不要求用户提供 token。

工作流参数约束

1) MJ 创意渲染（workflowId=0）

• - 必填：INLINECODE40
• 可选：referenceImage（最多 3 张）、imageCount（1-4）

2) 创意放大（workflowId=16）

• - 必填：INLINECODE44
• 可选：width、INLINECODE46

3) 氛围转换（workflowId=13）

• - 必填：INLINECODE48
• 可选：prompt、referenceImage（最多 1 张）、INLINECODE51

多语言文案规范

1) MJ 创意渲染（workflowId=0）

2) 创意放大（workflowId=16）

3) 氛围转换（workflowId=13）

异步任务处理（强约束）

• - 轮询状态接口：INLINECODE56

• - 记录查询接口：INLINECODE58

脚本职责：

• - scripts/check_status.py：只做状态轮询，输出 status:<value>。
• INLINECODE62：只做记录查询，返回生成 URL 列表等结果。
• INLINECODE63：负责任务生命周期与通知。
• 任务提交成功后必须立即结束本轮对话，并明确告知用户“后台完成后会自动通知”。

本地持久化

• - 运行根目录：优先使用环境变量 AIRILAB_HOME，未设置时默认 ~/.openclaw/skills/airilab。
• INLINECODE66：token 与登录相关信息。
• INLINECODE67：当前项目上下文。
• INLINECODE68：异步任务状态。
• INLINECODE69：worker 运行日志。
• INLINECODE70：worker 单实例锁文件。

运行命令

故障处理

• - missing_token：引导用户登录。
• INLINECODE72：引导用户选择项目。
• INLINECODE73 / 轮询超时：任务标记失败并通知用户重试。
• 记录查询 success=false：按失败处理，不得误判成功。

相关文件

• - INLINECODE75
• INLINECODE76
• INLINECODE77
• INLINECODE78
• INLINECODE79
• INLINECODE80
• INLINECODE81
• INLINECODE82
• INLINECODE83

Agent 执行约束（强约束）

1) 执行责任

• - Agent 必须直接执行可执行步骤，不得把可执行命令转嫁给用户。
• 禁止输出“你可以手动执行…/请你在终端执行…”这类兜底话术，除非明确出现权限/环境阻塞且无法由 Agent 代执行。
• 登录场景下，Agent 只向用户索取最小必要输入：phone、code；拿到后立即自行执行登录命令。

2) 路径解析与工作目录

• - skill_root：以当前 SKILL.md 所在目录为准，不依赖对话中的硬编码路径。
• INLINECODE88：优先 AIRILAB_HOME，未设置时使用 ~/.openclaw/skills/airilab。
• Agent 执行命令时必须使用绝对路径，且 cwd 设置为 skill_root，避免 cd 到错误目录。

3) 命令调用规范

• - 登录：python core/auth.py login --phone <phone> --code <code>（由 Agent 执行）
• 状态：python core/config.py status（由 Agent 执行）
• 健康：python core/config.py health 或 scripts/health.sh（由 Agent 执行）
• 启动 worker：scripts/start-worker.sh（由 Agent 执行）

4) 对话输出规范

• - 当缺少参数时，只提问缺失参数，不提供“手动执行命令”替代方案。
• 执行后返回结果摘要（成功/失败、关键字段、下一步），不要只返回命令文本。
• 若必须让用户介入，只允许两类：输入验证码、确认业务选择（例如项目选择）。