它负责什么
skill 会识别 deploy、observe、recover、configure 等意图，并映射到 Appaloft operation catalog。部署请求会落到已有 CLI、API 或 Web 操作。
AI skill
让 AI 使用 Appaloft 部署协议和 MCP 工具边界。
Appaloft skill 面向 AI agent。它把“部署这个仓库”转换成 Appaloft 已有的 CLI、HTTP/API、Web 操作；MCP/tool gateway 负责工具传输、授权、策略和审计。
入口
AI agent
状态 owner
CLI / API / Web
MCP
public tools + Cloud gateway
秘密处理
引用名称，不打印值
结果
URL + logs + diagnostics
安装命令只负责安装 skill
部署前安全读取项目结构，并选择最小可用入口
MCP 工具必须映射 operation catalog 并走 CommandBus/QueryBus
结果必须返回 live URL、日志、诊断和恢复命令
MCP 的位置
MCP 是 Appaloft operation catalog 的工具传输：tool descriptor、handler 和 server 属于 public Appaloft；Cloud 在 hosted gateway 上补授权、策略、审计和团队治理。
安全边界
AI 不能读取 .env、私钥、token、cookie 或未脱敏 secret；需要凭据时引用 Appaloft secret、GitHub Secrets 或运行时环境变量名。
部署协议
标准流程是安全检查源码、选择入口、调用现有 CLI/API/Web 操作，并输出 URL、部署 id、资源 id、状态、日志、诊断和 recovery-readiness。
部署流程
1
安装
把 Appaloft skill 安装到支持 skill 的 AI host。
2
询问 AI
让 AI 使用 Appaloft skill 部署当前仓库，并要求返回 URL、日志、诊断和恢复命令。
3
确认结果
失败时读取结构化状态和恢复建议，不让 AI 猜测下一步。