Agent Skills
返回列表
💻

出海助手-Python调试

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9c953624/yimubiao-py-debugpy。

技能介绍

你要解决什么问题

Python 服务一旦跑在远程主机、容器或后台进程里,本地 print 和单测往往够不到「坏掉的那一帧」:局部变量被隐藏、状态在 нескольк里被悄悄改掉、子进程或长驻服务刚起来就出错。这个时候需要选对调试器,并在不污染项目依赖的前提下 attach 到正在跑的进程。

技能如何工作

本技能围绕 debugpy 与备选方案(breakpoint()、python3 -m pdb)帮你选型:本地改源码最快用 breakpoint();从零单步用 pdb;已运行 PID、无头远程、DAP 客户端走 debugpy。技能会按场景协助你挂接调试端、设断点、查变量,并提醒常见流程:pdb 里 n/s/c、b file.py:42、用 p/pp 看表达式等。

核心原则来自原技能:先用最小复现命令或测试;并行测试 worker 里别开交互 pdb;debugpy 保持在当前虚拟环境,非必要不写进项目依赖;调试服务绑定 127.0.0.1,并行会话用不同端口;--pid 注入视为敏感操作,生产环境需明确批准;Linux 上 attach 失败先查 ptrace/容器权限;提交前用 rg 扫干净 breakpoint(|pdb.set_trace|debugpy.。

适用边界

需要外部凭证或远程环境的,须先完成授权与网络隧道。本技能为 python-debugpy 的中文说明层,逻辑与原开源技能一致;detach 后进程若仍卡住,需确认是否仍停在断点处。

使用场景

  • 远程部署的 Flask/FastAPI 服务出现异常,需要在不重启的前提下 attach 到进程里对某一请求处理链设断点
  • Docker 或 K8s 内 Python worker 逻辑分支难复现,需在容器里单步执行并查看局部变量
  • 长运行后台任务中途状态异常,要用 debugpy 连上已存在 PID 而非从头用 pdb 跑一遍
  • 单测在 worker 池里失败且堆栈指向子进程,需要先缩小复现命令再选 pdb 或 debugpy 路径

适合人员

  • 维护线上 Python 微服务、经常要在测试/预发环境 attach 而非只靠日志的后端工程师
  • 在容器化 CI 或本地 compose 里排查 Python 任务失败、熟悉 ptrace/端口绑定的平台或 SRE
  • 编写复杂异步或状态机逻辑、需要对照 SKILL 规则在提交前清理调试残留的应用开发者
  • 负责把 openclaw 生态技能本地化成中文说明、并在团队内统一远程调试规范的技能维护者