菜单
Full-access DeployerPHP operator for provisioning, deployment, DNS, services, cron, supervisor, and debugging. Use when an agent must execute infrastructure changes through explicit non-interactive CLI commands with complete option values and safety confirmations.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Design and update DeployerPHP BATS integration tests across VM and cloud suites, including non-interactive command execution, inventory isolation, run-suffix resource isolation, cleanup contracts, and helper usage. Use when editing tests/bats/*, bats.sh, or cloud janitor flows.
Author and modify DeployerPHP Symfony Console commands and Traits, including prompt-to-option parity, early conflict validation, validator usage, command replay behavior, and registration in SymfonyApp. Use when editing app/Console/*, app/Traits/*, command wiring, or command-focused tests.
Apply DeployerPHP documentation policy for docs/* updates, including master index maintenance, command replay documentation approach, option-doc restrictions, TOC conventions, and formatting workflow. Use when editing documentation files.
Author and maintain DeployerPHP GitHub Actions workflows and CI contracts, including setup-php-composer usage, timeout/concurrency patterns, matrix configuration, cloud-test environment wiring, cleanup backstops, and permissions/trigger constraints. Use when editing .github/workflows/* or related CI automation.
Author and update DeployerPHP playbooks with idempotent bash, DEPLOYER_* environment validation, helper usage, YAML output contracts, credential patterns, and logging/logrotate conventions. Use when editing playbooks/* or playbook-adjacent command behavior.
Read-focused DeployerPHP debugger for production triage. Use when an agent must inspect inventory, logs, service status, and filesystem/runtime state via non-interactive commands without changing infrastructure. Supports `server:info`, `server:logs`, and safe `server:run` diagnostics only.
| name | deployerphp-admin |
| description | Full-access DeployerPHP operator for provisioning, deployment, DNS, services, cron, supervisor, and debugging. Use when an agent must execute infrastructure changes through explicit non-interactive CLI commands with complete option values and safety confirmations. |
Use this skill for full lifecycle operations.
.deployer/inventory.yml before changes.deployer help <command> before first use in a session.--yes, --force) for destructive commands.server:ssh, site:ssh) from AI agents.Set concrete values before running commands:
PROJECT_ROOT="/path/to/project"
ENV_FILE="$PROJECT_ROOT/.env"
INVENTORY_FILE="$PROJECT_ROOT/.deployer/inventory.yml"
SERVER="production"
HOST="203.0.113.50"
SSH_USER="root"
SSH_PORT="22"
SSH_PRIVATE_KEY="~/.ssh/id_rsa"
SSH_PUBLIC_KEY="~/.ssh/id_rsa.pub"
DOMAIN="example.com"
REPO="git@github.com:acme/app.git"
BRANCH="main"
PHP_VERSION="8.3"
WWW_MODE="redirect-to-root"
WEB_ROOT="public"
CRON_SCRIPT=".deployer/scripts/cron.sh"
CRON_SCHEDULE="*/5 * * * *"
SUPERVISOR_PROGRAM="queue-worker"
SUPERVISOR_SCRIPT=".deployer/scripts/supervisor.sh"
AWS_KEY_PAIR="deployer"
AWS_ZONE="example.com"
AWS_INSTANCE_TYPE="t3.micro"
AWS_IMAGE="ubuntu-24.04"
AWS_VPC="vpc-xxxxxxxx"
AWS_SUBNET="subnet-xxxxxxxx"
DO_REGION="nyc3"
DO_IMAGE="ubuntu-24-04-x64"
DO_SIZE="s-1vcpu-1gb"
DO_KEY_NAME="deployer"
DO_SSH_KEY_ID="123456"
DO_VPC_UUID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
DO_ZONE="example.com"
CF_ZONE="example.com"
CRON_SCRIPT and SUPERVISOR_SCRIPT must be paths relative to project root.
.deployer/inventory.ymldeployer list --rawdeployer help <command>| Command | Reference | Complete non-interactive example |
|---|---|---|
scaffold:scripts | deployer help scaffold:scripts | deployer scaffold:scripts --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --destination="$PROJECT_ROOT" --force |
scaffold:ai | deployer help scaffold:ai | deployer scaffold:ai --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --destination="$PROJECT_ROOT" --agent=".agents" --tier="admin" --force |
| Command | Reference | Complete non-interactive example |
|---|---|---|
server:add | deployer help server:add | deployer server:add --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --name="$SERVER" --host="$HOST" --port="$SSH_PORT" --username="$SSH_USER" --private-key-path="$SSH_PRIVATE_KEY" |
server:info | deployer help server:info | deployer server:info --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
server:install | deployer help server:install | deployer server:install --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --generate-deploy-key --php-version="$PHP_VERSION" --php-default --php-extensions="bcmath,ctype,curl,dom,fileinfo,mbstring,openssl,pcntl,pdo,tokenizer,xml" --timezone="UTC" |
server:firewall | deployer help server:firewall | deployer server:firewall --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --allow="22,80,443" --yes |
server:logs | deployer help server:logs | deployer server:logs --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --service="system,nginx,php8.3-fpm" --lines=200 |
server:run | deployer help server:run | deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="systemctl status nginx --no-pager" |
server:delete | deployer help server:delete | deployer server:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --force --yes --no-destroy-cloud |
server:ssh | deployer help server:ssh | Not supported for AI agents (interactive terminal). Use server:run. |
| Command | Reference | Complete non-interactive example |
|---|---|---|
site:create | deployer help site:create | deployer site:create --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --server="$SERVER" --php-version="$PHP_VERSION" --www-mode="$WWW_MODE" --web-root="$WEB_ROOT" |
site:deploy | deployer help site:deploy | deployer site:deploy --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --repo="$REPO" --branch="$BRANCH" --keep-releases=5 --yes --force |
site:https | deployer help site:https | deployer site:https --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" |
site:dns:check | deployer help site:dns:check | deployer site:dns:check --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" |
site:shared:list | deployer help site:shared:list | deployer site:shared:list --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" |
site:shared:push | deployer help site:shared:push | deployer site:shared:push --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --local="$PROJECT_ROOT/.env.production" --remote=".env" --force --yes |
site:shared:pull | deployer help site:shared:pull | deployer site:shared:pull --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --remote=".env" --local="$PROJECT_ROOT/.env.backup" --yes |
site:rollback | deployer help site:rollback | deployer site:rollback --env="$ENV_FILE" --inventory="$INVENTORY_FILE" |
site:delete | deployer help site:delete | deployer site:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --force --yes |
site:ssh | deployer help site:ssh | Not supported for AI agents (interactive terminal). Use server:run. |
| Command | Reference | Complete non-interactive example |
|---|---|---|
mariadb:install | deployer help mariadb:install | deployer mariadb:install --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --display-credentials --save-credentials="$PROJECT_ROOT/.secrets/mariadb.txt" |
postgresql:install | deployer help postgresql:install | deployer postgresql:install --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --display-credentials --save-credentials="$PROJECT_ROOT/.secrets/postgresql.txt" |
redis:install | deployer help redis:install | deployer redis:install --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --display-credentials --save-credentials="$PROJECT_ROOT/.secrets/redis.txt" |
memcached:install | deployer help memcached:install | deployer memcached:install --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
| Command | Reference | Complete non-interactive example |
|---|---|---|
nginx:start | deployer help nginx:start | deployer nginx:start --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
nginx:stop | deployer help nginx:stop | deployer nginx:stop --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
nginx:restart | deployer help nginx:restart | deployer nginx:restart --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
php:start | deployer help php:start | deployer php:start --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --php-version="$PHP_VERSION" |
php:stop | deployer help php:stop | deployer php:stop --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --php-version="$PHP_VERSION" |
php:restart | deployer help php:restart | deployer php:restart --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --php-version="$PHP_VERSION" |
mariadb:start | deployer help mariadb:start | deployer mariadb:start --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
mariadb:stop | deployer help mariadb:stop | deployer mariadb:stop --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
mariadb:restart | deployer help mariadb:restart | deployer mariadb:restart --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
postgresql:start | deployer help postgresql:start | deployer postgresql:start --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
postgresql:stop | deployer help postgresql:stop | deployer postgresql:stop --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
postgresql:restart | deployer help postgresql:restart | deployer postgresql:restart --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
redis:start | deployer help redis:start | deployer redis:start --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
redis:stop | deployer help redis:stop | deployer redis:stop --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
redis:restart | deployer help redis:restart | deployer redis:restart --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
memcached:start | deployer help memcached:start | deployer memcached:start --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
memcached:stop | deployer help memcached:stop | deployer memcached:stop --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
memcached:restart | deployer help memcached:restart | deployer memcached:restart --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
supervisor:start | deployer help supervisor:start | deployer supervisor:start --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
supervisor:stop | deployer help supervisor:stop | deployer supervisor:stop --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
supervisor:restart | deployer help supervisor:restart | deployer supervisor:restart --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
| Command | Reference | Complete non-interactive example |
|---|---|---|
cron:create | deployer help cron:create | deployer cron:create --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --script="$CRON_SCRIPT" --schedule="$CRON_SCHEDULE" |
cron:delete | deployer help cron:delete | deployer cron:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --script="$CRON_SCRIPT" --force --yes |
cron:sync | deployer help cron:sync | deployer cron:sync --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" |
| Command | Reference | Complete non-interactive example |
|---|---|---|
supervisor:create | deployer help supervisor:create | deployer supervisor:create --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --program="$SUPERVISOR_PROGRAM" --script="$SUPERVISOR_SCRIPT" --autostart --autorestart --stopwaitsecs=3600 --numprocs=1 |
supervisor:delete | deployer help supervisor:delete | deployer supervisor:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" --program="$SUPERVISOR_PROGRAM" --force --yes |
supervisor:sync | deployer help supervisor:sync | deployer supervisor:sync --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --domain="$DOMAIN" |
| Command | Reference | Complete non-interactive example |
|---|---|---|
aws:key:add | deployer help aws:key:add | deployer aws:key:add --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --name="$AWS_KEY_PAIR" --public-key-path="$SSH_PUBLIC_KEY" |
aws:key:list | deployer help aws:key:list | deployer aws:key:list --env="$ENV_FILE" --inventory="$INVENTORY_FILE" |
aws:key:delete | deployer help aws:key:delete | deployer aws:key:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --key="$AWS_KEY_PAIR" --force --yes |
aws:provision | deployer help aws:provision | deployer aws:provision --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --name="$SERVER" --instance-type="$AWS_INSTANCE_TYPE" --image="$AWS_IMAGE" --key-pair="$AWS_KEY_PAIR" --private-key-path="$SSH_PRIVATE_KEY" --vpc="$AWS_VPC" --subnet="$AWS_SUBNET" --disk-size=20 --no-monitoring |
aws:dns:set | deployer help aws:dns:set | deployer aws:dns:set --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$AWS_ZONE" --type="A" --name="@" --value="$HOST" --ttl=300 |
aws:dns:list | deployer help aws:dns:list | deployer aws:dns:list --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$AWS_ZONE" --type="A" |
aws:dns:delete | deployer help aws:dns:delete | deployer aws:dns:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$AWS_ZONE" --type="A" --name="@" --force --yes |
| Command | Reference | Complete non-interactive example |
|---|---|---|
do:key:add | deployer help do:key:add | deployer do:key:add --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --name="$DO_KEY_NAME" --public-key-path="$SSH_PUBLIC_KEY" |
do:key:list | deployer help do:key:list | deployer do:key:list --env="$ENV_FILE" --inventory="$INVENTORY_FILE" |
do:key:delete | deployer help do:key:delete | deployer do:key:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --key="$DO_SSH_KEY_ID" --force --yes |
do:provision | deployer help do:provision | deployer do:provision --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --name="$SERVER" --region="$DO_REGION" --image="$DO_IMAGE" --private-key-path="$SSH_PRIVATE_KEY" --size="$DO_SIZE" --ssh-key-id="$DO_SSH_KEY_ID" --vpc-uuid="$DO_VPC_UUID" --no-backups --ipv6 --monitoring |
do:dns:set | deployer help do:dns:set | deployer do:dns:set --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$DO_ZONE" --type="A" --name="@" --value="$HOST" --ttl=300 |
do:dns:list | deployer help do:dns:list | deployer do:dns:list --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$DO_ZONE" --type="A" |
do:dns:delete | deployer help do:dns:delete | deployer do:dns:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$DO_ZONE" --type="A" --name="@" --force --yes |
| Command | Reference | Complete non-interactive example |
|---|---|---|
cf:dns:set | deployer help cf:dns:set | deployer cf:dns:set --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$CF_ZONE" --type="A" --name="@" --value="$HOST" --ttl=300 --proxied |
cf:dns:list | deployer help cf:dns:list | deployer cf:dns:list --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$CF_ZONE" --type="A" |
cf:dns:delete | deployer help cf:dns:delete | deployer cf:dns:delete --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --zone="$CF_ZONE" --type="A" --name="@" --force --yes |
Use server:run for diagnostics while staying non-interactive:
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="systemctl status nginx --no-pager"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="df -h"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="tail -n 200 /home/deployer/$DOMAIN/shared/storage/logs/laravel.log"
scaffold:scriptsserver:addserver:installsite:createsite:deploysite:httpssite:shared:pushcron:create + cron:sync (if needed)supervisor:create + supervisor:sync (if needed)