技能介绍
先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。
做什么
用 Docker 编译器设置多容器应用程序, 包括服务、 网络和卷
何时用
官方 description 未单独写出 Use when。按规范,代理会在用户任务与这段 description 的关键词匹配时激活本技能。
代理如何加载
按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Docker Compose Setup Skill、Purpose、Parameters、Modern Compose File (2024-2025)、Environment Management、Base + Override Pattern。
文件分析
文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。
官方 description(原文)
Set up multi-container applications with Docker Compose including services, networks, and volumes
Docker Compose Setup SkillPurposeParametersModern Compose File (2024-2025)Environment ManagementBase + Override Patterndocker-compose.yaml (base)docker-compose.override.yaml (dev - auto-loaded)docker-compose.prod.yaml (production)Development (loads override automatically)ProductionEnvironment Variables
来源分类:skills.sh agent-skill
来源与网址
namedocker-compose-setup
description- Set up multi-container applications with Docker Compose including services, networks, and volumes
- 发现技能客户端向 Agent 提供名称与描述目录。
- 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
- 按需加载按步骤读取参考文档、使用脚本与素材。
具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗
先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。
交给 Agent 安装
复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。
把 Agent Skill「docker-compose-setup」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-ea0a2c83ea86c447-Docker-%E7%BC%96%E8%AF%91%E8%AE%BE%E7%BD%AE.html
请存为 .cursor/skills/docker-compose-setup/SKILL.md 或 .claude/skills/docker-compose-setup/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
GitHub 完整包 ↗
终端安装 · Skills CLI
需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。
npx skills add 'https://github.com/pluginagentmarketplace/custom-plugin-docker' --list
npx skills add 'https://github.com/pluginagentmarketplace/custom-plugin-docker' --skill 'docker-compose-setup'
CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。
阅读排版
---
name: docker-compose-setup
description: Set up multi-container applications with Docker Compose including services, networks, and volumes
sasmp_version: "1.3.0"
bonded_agent: 05-docker-compose
bond_type: PRIMARY_BOND
---
# Docker Compose Setup Skill
Master Docker Compose for multi-container application orchestration with service dependencies, health checks, and environment management.
## Purpose
Design and configure Docker Compose files for development and production environments with proper service orchestration.
## Parameters
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| services | array | No | - | List of services to configure |
| environment | enum | No | dev | dev/staging/prod |
| include_monitoring | boolean | No | false | Add monitoring services |
## Modern Compose File (2024-2025)
**Note**: The `version` field is deprecated. Start directly with `services:`.
```yaml
services:
frontend:
build:
context: ./frontend
target: production
ports:
- "80:80"
depends_on:
backend:
condition: service_healthy
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost/health"]
interval: 30s
timeout: 10s
retries: 3
restart: unless-stopped
backend:
build: ./backend
expose:
- "3000"
environment:
DATABASE_URL: postgres://user:${DB_PASSWORD}@database:5432/app
depends_on:
database:
condition: service_healthy
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
interval: 10s
timeout: 5s
retries: 5
database:
image: postgres:16-alpine
volumes:
- db_data:/var/lib/postgresql/data
environment:
POSTGRES_PASSWORD: ${DB_PASSWORD}
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]
interval: 5s
timeout: 5s
retries: 5
volumes:
db_data:
```
## Environment Management
### Base + Override Pattern
```yaml
# docker-compose.yaml (base)
services:
app:
image: myapp:latest
# docker-compose.override.yaml (dev - auto-loaded)
services:
app:
build: .
volumes:
- ./src:/app/src
environment:
- DEBUG=true
# docker-compose.prod.yaml (production)
services:
app:
deploy:
replicas: 3
restart: always
```
```bash
# Development (loads override automatically)
docker compose up
# Production
docker compose -f docker-compose.yaml -f docker-compose.prod.yaml up -d
```
### Environment Variables
```bash
# .env file (auto-loaded)
DB_PASSWORD=secret123
APP_VERSION=1.2.3
```
```yaml
# Using in compose
environment:
- DB_PASSWORD=${DB_PASSWORD}
- VERSION=${APP_VERSION:-latest} # Default value
```
## Service Profiles
```yaml
services:
app:
image: myapp
# Only with --profile debug
debugger:
image: debug-tools
profiles:
- debug
# Only with --profile testing
test-db:
image: postgres:alpine
profiles:
- testing
```
```bash
docker compose up # app only
docker compose --profile debug up # app + debugger
```
## Common Commands
```bash
# Start services
docker compose up -d
# Rebuild and start
docker compose up -d --build
# View logs
docker compose logs -f backend
# Scale service
docker compose up -d --scale backend=3
# Stop and clean
docker compose down -v
# Validate config
docker compose config
```
## Error Handling
### Common Errors
| Error | Cause | Solution |
|-------|-------|----------|
| `undefined service` | Dependency missing | Define service |
| `yaml syntax error` | Indentation | Fix YAML |
| `port already in use` | Port conflict | Change port |
| `healthcheck failing` | Service not ready | Increase start_period |
### Fallback Strategy
1. Validate with `docker compose config`
2. Start services individually
3. Use `--no-deps` to skip dependencies
## Troubleshooting
### Debug Checklist
- [ ] Valid YAML? `docker compose config`
- [ ] Images available? `docker compose pull`
- [ ] Dependencies healthy? Check healthchecks
- [ ] Environment set? Check .env file
### Health Check Debugging
```bash
# Check health status
docker inspect --format='{{json .State.Health}}'
# View health logs
docker inspect --format='{{range .State.Health.Log}}{{.Output}}{{end}}'
```
## Usage
```
Skill("docker-compose-setup")
```
## Related Skills
- docker-networking
- docker-volumes
- docker-production
相关技能
运维与云
用于容器管理,图像操作,调试的基本道克命令和工作流程.
运维与云
从开放的代理技能生态系统中发现并安装技能. 使用时:(1)用户问"我如何做X",X可能拥有现有技能,(2)用户说"为X找到技能"或"是否为X有技能",(3)用户问"你能否做X",X是专门能力,(4)用户想扩展代理能力,(5)用户想搜索工具,模板,或工作流程,(6)用户提到他们希望…
运维与云
构建,部署,评价,优化,微调,管理微软创始代理,模型,资源最终结束. 用法:铸造、azd ai代理、azd 提供/部署、托管代理脚手架/开发/运行/部署/拖放、即时代理创建、创建代理、更新代理、添加代理工具、援引代理、代理.yaml、评估代理、批量活化、连续活化、持续监测、代理C…
运维与云
执行已有.azure/部署计划.md和基础设施文件的ALREADY-PREPARED应用程序的Azure部署。 当用户向 CREATE 请求新应用程序时, 请不要使用此技能 。 这种技能运行了 azd上行, azd 部署, trarraform 应用, 和 az 部署命令带有内置…