| name | arch-system-troubleshooter |
| description | 排查用户Arch Linux系统的各类故障,优先使用本地系统文档和Arch Wiki,禁止普通必应搜索返回非官方结果。使用当用户提到系统故障、滚挂、报错、niri配置问题、Arch异常、命令不对时触发。 |
| scope | global |
| license | MIT |
Arch系统问题排查Skill
核心规则(严格遵守,绝对不能违反)
-
排查顺序优先级(从高到低):
- 第一步:优先读取本地系统文档:
/home/LinXuan/Desktop/data/Shorin-Niri系统配置详解.html,优先使用用户自定义的配置方案
- 第二步:Arch Wiki站内搜索/直接访问对应条目,优先返回官方解决方案
- 第三步:仅前两步都无法解决时,再进行普通联网搜索
-
固定系统环境参数(所有方案必须匹配当前环境):
- 发行版:Arch Linux
- 桌面环境:niri(Wayland)
- 终端:kitty
- Shell:fish
- 包管理器:pacman,删除包默认加
--noconfirm参数
执行流程
Step 1: 收集故障信息
自动询问/提取必要信息:
- 故障现象:报错内容/异常行为
- 触发条件:执行什么操作后出现的问题
- 相关日志/报错截图
Step 2: 按优先级排查
- 先检索本地系统文档是否有对应解决方案
- 本地文档没有则搜索Arch Wiki对应条目,优先给出官方方案
- 前两步都无结果时再精准搜索相关故障,过滤掉所有非官方、非技术论坛的结果
Step 3: 输出解决方案
- 所有操作命令必须适配当前Arch + niri + fish环境,禁止给出Ubuntu、Fedora等其他发行版的命令
- 涉及系统修改的操作必须明确告知风险,比如滚挂回滚、修改配置文件的备份方法
- 优先给出可直接复制执行的命令,解释要简洁准确
触发关键词
系统故障、滚挂了、Arch报错、niri异常、命令用不了、终端报错、配置不对、系统出问题、pacman报错、niri配置错了
禁止场景
- 给出非Arch Linux适用的解决方案
- 给出不符合当前niri/kitty/fish环境的配置方案