Agent Skill 推荐文档

适用对象：bbs1.org（nginx + 单文件 PHP 论坛）
核实时间：2026-10-28
说明：文中星数、更新时间均为 GitHub API 实时抓取；技能名均对照仓库真实目录核对，非目录站描述。

一、结论先行

一句话：只装一个包，启用其中 6 个技能，另外借 2 个流程，最后自建 1 个 bbs1 专属技能。

动作对象说明
✅ 装linux-skills唯一覆盖 Web 栈 + 数据库 + 备份 + TLS 的包
⚙️ 启用6 个技能见 5.1，其余留目录备用不加载
📖 借ssh-diagnose借它"先采集→再分诊"的顺序，不装 MCP
📖 借sysadmin-maintain借它"只读优先、破坏性操作先确认"的纪律
🛠 自建bbs1-ops单文件 PHP + SQLite 锁，现成技能都不覆盖

二、目标站点现状（实测，非推测）

以下为 2026-10-28 直接请求 https://bbs1.org/ 的观测结果：

  • 应用层：页面自述"一个极简 PHP 论坛。仅由一个 100 多 KB 的 PHP 文件构建。纯原生、无框架、无依赖，支持 SQLite、MySQL 和 PostgreSQL。"
  • Web 服务器：响应头 server: nginx，HTTP/2
  • 已启用：strict-transport-security: max-age=31536000; includeSubDomains、x-frame-options: SAMEORIGIN、x-content-type-options: nosniff
  • 静态资源：挂在 /app/assets/，带版本串（index.css?v=v10.12）与内容哈希（plugins.css?v=dc6b16...）
  • 后端语言：PHP（论坛主体由 PHP 直接渲染，无前端框架层）

由此确定运维面（这决定了该推荐哪些技能）：

  1. nginx + PHP-FPM 进程池 → 502/504 的第一嫌疑
  2. 数据库三选一 → 必须先现场确认到底用的哪个；若用 SQLite，故障形态完全不同（锁、单文件损坏、并发写阻塞）
  3. 磁盘与附件目录 → 论坛类站点最常见的"慢慢死掉"原因
  4. TLS 证书续期 → HSTS 已开一年，证书过期用户连点"继续访问"的机会都没有
  5. 备份可恢复性 → 单文件应用最怕"备份了但恢复不了"

三、索引表

#技能包适配度
1linux-skills★★★★★
2linux-sysadmin-skills★★★★☆
3bridge-mcp★★★☆☆
4netclaw★★★☆☆
5claude-skills★★★☆☆
6claude-network-skills★★☆☆☆

四、逐项详述

1. linux-skills　★★★★★

  • GitHub 网址

🔒 外部链接需 后查看

  • 推荐的技能

linux-webstack、linux-troubleshooting、linux-log-management、linux-system-monitoring、linux-mysql-mariadb、linux-postgresql、linux-archive-integrity、linux-rsync-sync、linux-firewall-ssl、linux-network-admin、linux-site-deployment

  • 推荐的理由

48 个 SKILL.md 按 16 个分类组织，是这份清单里唯一同时覆盖站点运维全链路的包。三个关键技能的实际自述（已读原文元数据）：

  • linux-webstack：安装、配置、调优、诊断 Linux 上的共享 Nginx / Apache / PHP-FPM / Node.js 栈 —— 正对 bbs1 的运行环境
  • linux-troubleshooting：面向生产事故分诊，覆盖 CPU、内存、磁盘、服务、web、数据库、TLS、备份、部署 —— 一份技能串起所有故障面
  • linux-archive-integrity：tar 归档的创建、签名、加密、比对、恢复，含 ACL 与 xattr —— 论坛附件备份正需要

另有 install.sh、validate_skills.py、pytest 测试与 hooks，12★ 但工程完整度明显高于同等星数项目，2026-10-24 仍在更新。

  • 注意

面向 Debian/Ubuntu 与 RHEL 两族，命令需按实际发行版取用。带 scripts/ 与 hooks，安装前必须逐个读原文，不要 clone 完直接跑。

2. linux-sysadmin-skills　★★★★☆

  • GitHub 网址

🔒 外部链接需 后查看

  • 推荐的技能

sysadmin-diagnose、sysadmin-monitor、sysadmin-maintain、sysadmin-performance、sysadmin-security

  • 推荐的理由

只有 5 个技能，但纪律设计极好：只读优先，执行前先说明要做什么，破坏性操作强制确认。sysadmin-diagnose 用"假设—验证—再假设"的循环推进，而不是一把梭把命令全打出来；sysadmin-maintain 的例行清单（更新、清缓存、扫日志、查磁盘、验备份）几乎就是维护论坛的日常模板。

  • 注意

仅 7★、2026-05 后未更新；假设 Debian/Ubuntu + systemd，RHEL 系需改写。建议当纪律层参考，不指望它给新东西。

3. bridge-mcp（ssh-diagnose）　★★★☆☆

  • GitHub 网址

🔒 外部链接需 后查看

  • 推荐的技能

ssh-diagnose（配套 ssh_incident_triage、ssh_process_top、ssh_metrics、ssh_exec）

  • 推荐的理由

清单里唯一按"SSH 到远程主机"设计的技能。流程是：一条命令采集 uptime、CPU、内存、磁盘、进程、失败单元、近期错误 → 再按 slow / crash / oom / disk / network 五种症状自适应深入。并且明确要求把冗长的诊断输出交给子代理隔离，不污染主对话——这个设计对"论坛 502 卡住"的场景非常对症。

  • 注意

它是 MCP 大包：337 个工具 / 74 个分组，当前 42 个未关闭 issue，说明仍在剧烈变动。为用一个技能引入整套依赖不划算。建议只借流程，不装。

4. netclaw　★★★☆☆

  • GitHub 网址

🔒 外部链接需 后查看

  • 推荐的技能

globalping-external-checks、packet-analysis、nmap-service-detection、network-data-analysis

  • 推荐的理由

238 个技能，是我见过最全的网络运维技能库，688★、2026-10-25 仍在提交。对 bbs1 真正有用的是 globalping-external-checks：从全球节点反向验证站点可用性，能一句话分清"站挂了"还是"你本地网络有问题"，这是单机排障永远给不出的判断。packet-analysis 用于抓包定责。

  • 注意

其余绝大部分是交换机、防火墙、SD-WAN、云网设备向（pyATS、ACI、Meraki、F5 等），与 bbs1 无关。它是完整 agent 框架，需要安装器和外部数据源，绝对不要整体部署，只抄需要的 SKILL.md。

5. claude-skills（jeffallan）　★★★☆☆

  • GitHub 网址

🔒 外部链接需 后查看

  • 推荐的技能

sre-engineer、devops-engineer、monitoring-expert

  • 推荐的理由

12.1k★，本清单里唯一高频维护的大项目（2026-10-28 仍在提交）。价值不在命令而在约束：sre-engineer 管 SLI/SLO 与错误预算（论坛的 SLI 就是"可用性 + 发帖成功率"），devops-engineer 强制"未经批准不动生产、密钥不进代码、镜像不裸跑"。当底座叠在 linux-skills 之上，能拦住"顺手改一下生产"这类事故。

  • 注意

不含任何站点命令，单独装没用。67 个技能里绝大部分是全栈开发向，只取这 3 个。

6. claude-network-skills　★★☆☆☆

  • GitHub 网址

🔒 外部链接需 后查看

  • 推荐的技能

network-interface-health、netmiko-ssh-automation、network-config-validation

  • 推荐的理由

9 个技能 + 4 个 agent，结构小而规范：每个技能只讲一条有序诊断序列、确切命令、输出含义、反模式。对 bbs1 只有"接口健康 / SSH 批量执行 / 配置校验"三点沾边（如多机批量重载 PHP-FPM）。真正的价值是当结构模板——你要自建 bbs1-ops 时，照它的写法最省事。

  • 注意

77★，更新停在 2026-05。不含 Web 层与数据库层内容，不要指望它排论坛故障。

五、针对 bbs1.org 的具体建议

5.1 装什么：一个包，只启用 6 个技能

安装位置：~/.workbuddy/skills/

启用清单（按优先级）：

  1. linux-webstack —— nginx + PHP-FPM 的一切
  2. linux-troubleshooting —— 事故总入口，按面分诊
  3. linux-log-management —— journald / 日志轮转 / 定位错误
  4. linux-archive-integrity —— 备份可校验、可恢复
  5. linux-firewall-ssl —— 证书与防火墙（HSTS 已开，证书过期等于全站失联）
  6. 数据库二选一：linux-mysql-mariadb 或 linux-postgresql

暂不启用：linux-mail-server（论坛不发信则无用）、linux-ngo-cyber-resilience、linux-kernel-modules、全部 homelab 类。

5.2 论坛高频故障对照（现成技能覆盖不到的，要自建）

现象优先怀疑
502 Bad GatewayPHP-FPM 进程池打满 / 队列积压
504 Gateway Timeout慢查询或锁等待（SQLite 尤甚）
database is lockedSQLite 并发写、长事务、WAL 未开
图片/附件 404 或空白上传目录权限、磁盘满
登录后立刻掉线session 目录权限或 GC
页面能开但很慢静态资源未走缓存、PHP opcache 失效
全站打不开（本机正常）DNS / 证书 / CDN，需外部视角验证

这张表是 linux-troubleshooting 只能部分覆盖的部分——它懂"数据库连不上"，但不懂"这个单文件 PHP 论坛的 SQLite 锁该怎么处理"。这正是需要自建 bbs1-ops 的理由。

5.3 维护节奏

  • 每天（只读）：站点 HTTP 200 检查、磁盘使用率、nginx error log 新增条目
  • 每周：PHP-FPM 慢日志、数据库体积增长、附件目录增量、证书剩余天数
  • 每月：备份恢复演练（必须真恢复到临时目录验证，不是看备份文件存在）、系统与 PHP 安全更新

5.4 明确不做

  • ❌ 不整体部署 netclaw（框架级依赖，与本站无关）
  • ❌ 不安装 bridge-mcp（337 工具、42 个 open issue）
  • ❌ 不直接 git clone 就加载任何带 scripts/ 的技能——先读后装
  • ❌ 不用目录站（skillsdirectory / mcpmarket）的"Grade A"评级当依据

5.5 第一天可以跑的三个只读检查

在不装任何技能的前提下，先摸清底数，这三条不改变任何状态：

  1. nginx -t && systemctl status php*-fpm nginx —— 确认 Web 栈与单元状态
  2. df -h && du -sh <附件目录> —— 磁盘底数，附件是论坛唯一会持续膨胀的东西
  3. cat <站点配置> 看 fastcgi_pass 指向哪个 socket —— 由此确定 PHP-FPM 版本与池名，后续所有排查都依赖它

六、核实与免责

  • 星数与更新日期：GitHub API，2026-10-28 抓取。
  • 技能名：逐个对照仓库真实目录（contents 接口）核对。
  • linux-webstack、linux-troubleshooting、linux-archive-integrity 的描述引用自各 SKILL.md 的 frontmatter 原文。
  • 已剔除：目录站标注 "Grade A" 但仓库 404 的条目，包括 jackspace/network-diagnostics、loopyluci/network-diagnostics；muchiny/ssh-diagnose 作为独立仓库不存在，技能实际在 muchiny/bridge-mcp 内。
  • 站点技术栈依据 2026-10-28 的 HTTP 响应头与首页 HTML 静态分析，实际数据库类型、PHP 版本、部署方式需登入主机确认。
主楼