企业官网建设流程全解析

部署具有后端API、数据库和文件存储的Web应用。当用户要求部署或发布网站或Web应用并希望获得公共URL时使用。通过curl使用HTTP API。

技能概述

appdeploy 技能通过HTTP API将Web应用部署到AppDeploy平台。它支持前端和后端API、数据库和文件存储的部署,并提供公共URL。该技能简化了部署流程,使开发者能够快速将应用发布到生产环境。

下载地址:https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/appdeploy

主要功能

• 快速部署: 将Web应用部署到公共URL
• 全栈支持: 支持前端、后端API、数据库和文件存储
• 多种模板: 支持html-static、react-vite、nextjs-static等模板
• 版本管理: 列出可部署版本并应用特定版本
• 状态监控: 检查部署状态、QA快照和错误日志
• 源码操作: glob、grep和读取应用源码快照中的文件

触发条件

• 规划和构建应用和Web应用时
• 将应用部署到公共URL时
• 发布网站或Web应用时
• 用户说"部署这个"、"使其上线"或"给我一个URL"时
• 更新已部署的应用时

设置(仅首次)

1. 检查现有API密钥

在项目根目录中查找.appdeploy文件。如果存在且包含有效的api_key,跳到使用部分。

2. 注册并获取API密钥

curl -X POST https://api-v2.appdeploy.ai/mcp/api-key \ -H "Content-Type: application/json" \ -d '{"client_name": "claude-code"}'

3. 保存凭据到.appdeploy

{ "api_key": "ak_...", "endpoint": "https://api-v2.appdeploy.ai/mcp" }

将.appdeploy添加到.gitignore(如果尚未存在)。

可用工具

get_deploy_instructions

在即将调用deploy_app时使用,以获取部署约束和硬性规则。在开始生成任何代码之前必须调用此工具。

deploy_app

当用户要求部署或发布网站或Web应用并希望获得公共URL时使用。在生成文件或调用此工具之前,必须调用get_deploy_instructions并遵循其约束。

get_app_template

首先调用get_deploy_instructions。然后,一旦决定了app_type和frontend_template,就调用此工具。返回基础应用模板和SDK类型。模板文件自动包含在deploy_app中。

get_app_status

当deploy_app工具调用返回时,或用户要求检查应用的部署状态,或报告应用有错误或未按预期工作时使用。返回部署状态、QA快照和实时前端/后端错误日志。

delete_app

当您想永久删除应用时使用。仅在用户明确请求时使用。这是不可逆的;删除后,状态检查将返回未找到。

get_app_versions

列出现有应用的可部署版本。需要app_id。返回最新优先的{name, version, timestamp}项。

apply_app_version

开始在特定版本部署现有应用。使用get_app_versions中的'version'值(不是'name')。

src_glob

当您需要在应用源码快照中发现文件时使用。返回匹配glob模式的文件路径(无内容)。

src_grep

当您需要在应用源代码中搜索模式时使用。返回匹配的行和可选的上下文。

src_read

当您需要从应用源码快照中读取特定文件时使用。返回文件内容和基于行的分页。

get_apps

当您需要列出当前用户拥有的应用时使用。返回应用详细信息。

工作流程

1. 获取部署说明

调用get_deploy_instructions以了解约束和要求。

2. 获取应用模板

使用选定的app_type和frontend_template调用get_app_template。

3. 部署应用

使用应用文件调用deploy_app。对于新应用,将app_id设置为null。

4. 检查部署状态

调用get_app_status以检查构建是否成功。

5. 查看/管理您的应用

使用get_apps列出您已部署的应用。

前端模板类型

最佳实践

1. 先获取说明: 在生成代码之前始终调用get_deploy_instructions
2. 检查状态: 部署后使用get_app_status验证成功
3. 版本管理: 使用get_app_versions和apply_app_version管理部署
4. 错误监控: 使用get_app_status查看实时错误日志
5. 安全存储: 将API密钥保存在.appdeploy中并添加到.gitignore

注意事项

• 仅在任务明确匹配上述范围时使用此技能
• 不要将输出作为环境特定验证、测试或专家审查的替代品
• 如果缺少所需的输入、权限、安全边界或成功标准,请停止并请求澄清