Agent Skills › rcarmo/piclaw › debug

debug

GitHub

用于诊断和修复 Pibox 容器环境问题，检查系统基础、工具可用性、配置及进程状态，并提供修复建议。

skel/.pi/skills/debug/SKILL.md rcarmo/piclaw

Trigger Scenarios

容器环境异常工具缺失或路径错误权限或挂载问题

Install

npx skills add rcarmo/piclaw --skill debug -g -y

More Options

Non-standard path

npx skills add https://github.com/rcarmo/piclaw/tree/main/skel/.pi/skills/debug -g -y

Use without installing

npx skills use rcarmo/piclaw@debug

指定 Agent (Claude Code)

npx skills add rcarmo/piclaw --skill debug -a claude-code -g -y

安装 repo 全部 skill

npx skills add rcarmo/piclaw --all -g -y

预览 repo 内 skill

npx skills add rcarmo/piclaw --list

SKILL.md

Frontmatter

{
    "name": "debug",
    "description": "Diagnose and fix issues with the Pibox container environment — tools, paths, mounts, pi configuration.",
    "distribution": "public"
}

Debug

Use this skill to diagnose and fix Pibox container issues.

Steps

Check system basics:

uname -a && cat /etc/os-release | head -3
whoami && id
df -h / /workspace /home/agent 2>/dev/null
free -h

Check tool availability:

for cmd in bun brew git rg make pi vim tmux htop jq curl; do
  printf "%-8s " "$cmd"; which "$cmd" 2>/dev/null && "$cmd" --version 2>/dev/null | head -1 || echo "NOT FOUND"
done

Check pi configuration:

echo "=== Global skills ===" && ls ~/.pi/agent/skills/ 2>/dev/null || echo "none"
echo "=== Global settings ===" && cat ~/.pi/agent/settings.json 2>/dev/null || echo "none"
echo "=== Project AGENTS.md ===" && head -5 AGENTS.md 2>/dev/null || echo "none"
echo "=== Project skills ===" && ls .pi/skills/ 2>/dev/null || echo "none"

Check piclaw (if running):

echo "=== Piclaw ===" && pgrep -af "bun.*piclaw" || echo "not running"
ls -la data/ipc/ 2>/dev/null || echo "no IPC directory"

Report the findings and suggest fixes.

Common Issues

bun not found: source ~/.bashrc or check ~/.bun/bin is in PATH
brew not found: eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
pi not found: bun add -g @earendil-works/pi-coding-agent
Permission denied: sudo chown -R agent:agent /workspace
Config not persisting: Check /config volume is mounted and ~/.pi is symlinked