---
name: deploy-env
description: 通用部署环境概念规范——部署环境定义、通用生命周期、环境类型、验证标准、发布门禁。agent 处理部署/环境时据此操作。产线可用同名 skill 覆盖。触发：配置/验证部署环境，或提到环境、部署、发布、上线。
capability: deploy_capability
tools: [configure_env, verify_env, fail_env, list_envs, set_env_state]
---

# 部署环境（通用概念）

## 一、概念定义

部署环境 = 软件运行的**宿主环境**（服务器、数据库、连接配置），是发布/上线的目标。
环境是部署动作（deploy）的可追踪实体；发布本体（执行部署）复用任务状态机。

## 二、通用生命周期（状态）

| 状态 | 语义 |
|---|---|
| configured | 已配置 |
| verified | 已验证 |
| failed | 验证失败 |

通用流转：configured → verified / failed。

## 三、与其他概念的关系

- 环境挂项目（project_id）。
- 环境类型（env_type）：test / staging / production。
- 环境含 SSH 连接信息 + 数据库连接（db_* 字段）+ 部署目录（deploy_path）。
- 部署动作（deploy）目标 = 某环境；发布门禁 = 环境 verified。

## 四、门禁（通用）

- 上线（production）前：环境 verified（连接/权限/依赖可用）。
- 回滚方案：每个环境应有可回滚的部署方案（deploy-guide）。

## 五、配套能力（工具）

已固化的 deploy-env 能力（deploy_capability）：
`configure_env` / `verify_env` / `fail_env` / `list_envs` / `set_env_state`（CAS 兜底）。
状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

## 六、分层覆盖

本 skill 是**通用**部署环境概念规范；产线可用同名 deploy-env skill 覆盖具体发布流程与门禁。