docker/skills

面向 AI 编码代理的 Docker Skills

这是什么 – 一组 Agent Skills，教 AI 编码助手（Claude Code、OpenAI Codex、GitHub Copilot、Gemini CLI、Cursor 等）如何处理 Docker。每个 skill 都位于自己的 SKILL.md 文件夹中，并遵循开源 Agent Skills 规范。

为何重要 – 通过安装这些 skills，AI 助手可获得具体、Docker 专属的护栏、最佳实践建议与命令模板。这让模型在建议或执行 Dockerfile 变更、Compose 文件、沙箱生命周期命令或 Docker-Agent 配置时，能大幅减少幻觉或不安全操作。

主要部分

• Skill 目录 – catalog.yaml 定义产品分组（Dockerfile & Build、Compose、Sandboxes、Docker Agent、跨产品护栏）以及各个 skill ID。
• Skill 文件夹 – 在 skills/ 下，每个文件夹（例如 docker-compose-patterns）都包含一个 SKILL.md，其中有描述、输入、输出与验证规则。
• 安装 – 一个 skills CLI（npx skills add docker/skills …）或各受支持代理的原生 marketplace 插件，会将所选 skills 安装到代理的 skill 目录中。也有手动复制与沙箱原生选项。
• 护栏 – docker-destructive-guardrails skill 会在任何不可逆的 Docker 操作前强制要求确认。
• 实验性功能 – 部分与沙箱相关的 skills（docker-sandboxes-env、docker-sandboxes-kits）标记为实验性，可能发生变化。

如何使用

1. 运行 skills CLI，或通过代理的 marketplace 安装。
2. 选择你需要的 skill（例如 docker-compose-patterns）。
3. 代理会自动加载该 skill，为你提供情境感知建议或安全执行该 Docker 任务的命令。

开发 – 该 repo 使用 Taskfile.yml 进行 CI、验证与目录重新生成。贡献时必须保持 skill 目录与版本号同步。

许可证 – Apache 2.0。