核心用法
pi-admin 是一款面向 Raspberry Pi 的系统管理 Skill，通过命令行脚本提供完整的系统监控和维护能力。用户可通过 ./skill.sh 配合不同子命令快速获取系统状态或执行维护操作。信息查询类命令包括 overview（系统概览）、network（网络配置）、tailscale（VPN 状态）、resources（CPU/内存/温度）、storage（磁盘使用）、services（运行服务）和 hardware（硬件信息），均无需特殊权限即可执行。维护类命令涵盖 update（系统更新）、clean（清理垃圾）、reboot（重启）、restart-gateway（网关重启）和 optimize（系统优化），这些操作需要 sudo 权限并内置用户确认机制。
显著优点
该 Skill 的设计体现了运维工具的专业性。首先，所有维护命令均支持 --dry-run 干运行模式，用户可在实际执行前预览变更内容，大幅降低误操作风险。其次，，optimize 命令提供 --undo 回滚功能，禁用的蓝牙、ModemManager 等服务可随时恢复，确保系统可逆性。第三，命令结构清晰，采用模块化设计，每个功能独立实现，便于维护和扩展。第四，信息收集全面但不越界，仅获取系统运行状态，不涉及用户隐私数据。最后，针对树莓派的硬件特性（如 CPU 温度监控、GPU 内存分配）做了专门适配，贴合边缘计算场景需求。
潜在缺点与局限性
该 Skill 存在若干使用限制。其一，硬编码了特定路径 /home/srose/clawdis，若用户采用非标准安装路径则需手动修改脚本。其二，，restart-gateway 命令与 Clawdis 生态深度绑定，独立使用价值有限。其三，优化操作默认禁用蓝牙等服务，对于依赖蓝牙外设（如无线键盘、传感器）的用户可能造成意外中断。其四，所有输出均为纯文本格式，缺乏可视化图表或历史趋势分析，不适合长期监控场景。其五，脚本依赖特定 shell 环境，跨平台移植性较差。
适合的目标群体
该 Skill 主要面向三类用户：一是树莓派爱好者和创客，需要快速诊断设备状态；二是边缘计算运维人员，管理分布式部署的 Pi 节点；三是 Clawdis 生态用户，需要与网关服务协同工作。特别适合资源受限场景（如 1GB 内存的 Pi Zero 2W）下的系统调优，官方宣称可释放约 100MB 内存。对于需要远程维护、定期巡检或自动化脚本集成的场景尤为实用。
使用风险
常规风险包括：维护操作需 sudo 权限，存在权限提升的潜在攻击面；apt upgrade 可能引入不兼容的软件包版本，建议配合 --dry-run 谨慎使用；reboot 命令虽有 10 秒倒计时，但自动化脚本中若未正确处理可能意外中断服务；长期禁用系统服务可能影响后续软件安装的依赖检测；频繁的温度查询（通过 /sys/class/thermal）虽无性能损耗，但大量并发调用可能触发内核警告。建议在关键生产环境先进行充分测试，并建立配置备份机制。