container-debug

Container Debug 是一款专注于 Docker 容器与 Compose 服务调试的纯文档型技能，为开发者和运维人员提供了覆盖全场景的故障排查命令手册。其核心用法涵盖六大维度：通过 docker logs 进行日志流式追踪与过滤，利用 docker exec 进入运行中容器执行交互式诊断，借助网络 inspection 和连通性测试解决容器间通信问题，使用 docker stats 和 cgroup 接口监控资源消耗，针对多阶段构建提供镜像层分析与构建缓存调试，以及通过健康检查配置和 Compose 依赖管理确保服务正确启动顺序。

该技能的显著优势在于内容的全面性与实用性。它不仅收录了从基础日志查看到高级网络抓包的 50+ 条实用命令，还针对无 shell 的 distroless 镜像、已崩溃容器等特殊场景提供了专门的调试技巧（如 nsenter 和 sidecar 模式）。作为纯 Markdown 文档，它天然免疫代码执行风险，所有命令均需用户手动复制执行，透明度高且可审计。此外，文档对危险操作（如 docker system prune）明确标注警告，体现了良好的安全设计。

然而，该技能也存在一定局限性。首先，作为 T3 级社区来源项目，其维护稳定性不如官方文档或企业级工具。其次，它要求用户具备本地 Docker 环境，且部分高级命令（如网络命名空间操作）需要 root 权限或 Linux 环境支持。此外，纯文档形式意味着无法提供自动化诊断流程，所有操作依赖用户手动执行，对新手的学习成本较高。

该技能特别适合 DevOps 工程师、后端开发者、SRE 站点可靠性工程师以及容器化应用的运维人员。对于频繁处理容器启动失败、网络连通异常、内存泄漏或构建缓存问题的技术团队，这是一份随时可查的实战手册。但需要注意的是，在生产环境执行调试命令（尤其是涉及 docker cp 提取文件或修改运行中容器状态的操作）前，建议先在测试环境验证，避免因误操作导致服务中断或数据丢失。

Container Debug：综合评估文章

Container Debug 是一款专注于 Docker 容器及 Compose 服务调试的纯文档型技能。该 Skill 本身不包含任何可执行脚本，而是提供了一整套结构清晰、覆盖全面的调试命令与排障指南，可直接嵌入到支持上下文学习的 AI Agent 中使用。

1. 核心用法

该 Skill 的核心用法涵盖容器排障的完整流程。从最基础的“如何查看和分析容器日志（docker logs）”开始，到通过 docker exec 进入运行中的容器进行交互式排查，再到检查崩溃容器的退出码、从已停止的容器中拷贝文件，甚至为无 Shell 的精简镜像（如 distroless）提供了 nsenter 和 docker debug 等高级调试方法。在网络调试方面，它包含了 IP 地址查看、容器间连通性测试、DNS 解析检查以及使用 nicolaka/netshoot 抓包分析。此外，Skill 还详细介绍了资源占用（CPU/内存/OOM 排查）、多阶段 Dockerfile 构建调试、健康检查配置与诊断，以及 Docker Compose 中服务依赖与启动顺序的常见故障模式。

2. 显著优点

• 实战性强：Skill 内容直击开发者日常遭遇的痛点，如“容器立即退出”、“容器间无法通信”和“退出码 137 是 OOM”，提供了立即可执行的解决方案。
• 覆盖全面且结构化：从日志、执行、网络、资源到构建，形成了一个完整的调试知识体系，循序渐进，便于 Agent 根据问题类型快速检索对应的命令。
• 安全性极高：经 CLS-Certify 全扫描，该 Skill 零依赖、无可执行代码，不存在运行时安全隐患，所有 URL 也仅为 localhost 或内部网络的文档示例。
• 工具链集成：不仅提供原生命令，还贴心推荐了 nicolaka/netshoot 和 curlimages/curl 等极其实用的调试镜像，大幅降低了调试环境的准备门槛。

3. 潜在缺点或局限性

• 纯文档的被动性：由于该 Skill 仅是参考文档，它无法自动执行命令或收集系统信息，完全依赖 Agent 或用户根据指南手动输入。
• 来源可信度限制：维护者为社区个人开发者（gitgoodordietrying），安全评级因 T3 来源被限制在最高 A 级。虽然目前纯文档无风险，但若未来代码更新引入可执行内容，需要重新审计。
• 环境依赖性：所有命令均假设环境中已安装 Docker 和 Docker Compose，且部分高级命令（如 nsenter）仅适用于 Linux 系统，在容器化或非 Linux 开发环境中可能受限。

4. 适合的目标群体

• 后端与 DevOps 工程师：经常需要部署、维护和排查容器化微服务故障的专业人员，这是他们的“口袋字典”。
• 全栈开发者：在本地使用 Docker Compose 搭建开发环境时，遇到服务无法启动或互相连通的经典问题，可快速定位。
• 运维与 SRE：在生产或预发布环境中进行初步的应急响应，快速获取容器状态、资源信息和近期关键日志。
• 学习 Docker 进阶技术的人：Skill 涵盖了多阶段构建、健康检查、内部 DNS 等进阶主题，是很好的学习路径参考。

5. 使用常规风险

• 数据丢失风险：文档中包含 docker system prune -a --volumes 等清理命令，若在使用时照搬建议而未加注意，可能导致重要数据卷被意外删除。
• 生产环境操作风险：像 docker exec -u root -it 等以 root 权限进入容器的命令，在共用开发机上使用需谨慎，避免误操作影响宿主机或其他服务。
• 文档过时风险：作为社区 Skill，若 Docker 或 Compose CLI 版本发生更迭，部分命令参数可能失效，届时依赖该 Skill 的 Agent 如未及时更新知识，可能输出错误指令。