arch-linux-triage

arch-linux-triage 技能概览

arch-linux-triage 能做什么

arch-linux-triage 是一个专门面向 Arch Linux 故障排查的技能，适合处理那些不能靠一句泛泛的“试试重装”就解决的问题。它会把代理引导到更符合 Arch 场景的诊断路径上，重点使用 pacman、systemctl、journalctl，同时关注是否已重启，以及是否需要回滚或清理。

谁适合使用它

如果你正在排查 Arch Linux 上的更新损坏、服务启动失败、启动回归、软件包冲突，或升级后出现但原因不明确的异常行为，这个技能很适合你。它尤其适合希望拿到可直接复制执行的命令和更稳妥排障顺序的用户，而不只是看一段高层解释。

它真正要解决的是什么问题

这个技能的实际价值，在于把“更新后音频坏了”或“服务起不来”这种模糊反馈，转成一套结构化的排查流程，包含命令、检查点和验证步骤。对 Arch 来说，这一点很关键，因为 rolling-release 带来的问题往往和最近更新、系统当前状态、以及是否重启过或内核是否不匹配直接相关。

为什么它比普通提示词更好用

普通提示词经常只会给出过于泛化、混杂不同发行版，或者缺少验证步骤的 Linux 建议。arch-linux-triage 会明确推动代理去做这些事：

• 先确认更新时间和环境前提
• 优先使用 Arch 相关工具
• 给出可以直接执行的修复命令
• 在每个关键变更后做验证
• 补上回滚或清理步骤

仓库里缺少什么

这个仓库是刻意保持精简的：只有 SKILL.md。这让 arch-linux-triage skill 很容易快速看懂，但也意味着它没有附带辅助脚本、预置诊断工具或参考文档。最终输出质量会高度依赖你提供的系统快照和问题描述。

如何使用 arch-linux-triage 技能

先读 SKILL.md

先看上游仓库里的 skills/arch-linux-triage/SKILL.md。这个文件定义了输入项、必须遵循的排障顺序，以及期望的输出结构。因为没有其他支持文件，读完这一个文件，基本就等于掌握了这个技能的完整使用契约。

先搞清楚三个关键输入

这个技能围绕三个输入构建：

• ProblemSummary：症状和最近的变化
• ArchSnapshot：系统上下文
• Constraints：你能做什么、不能做什么

如果你只能提供一项信息，那就尽量把 ProblemSummary 写准确。想要结果更好，就再补一个简洁的系统快照。

ProblemSummary 应该写什么

好的 arch-linux-triage usage，开头一定是一个明确的问题描述：说清楚出问题的组件、发生时间和影响范围。比如：

• “昨天执行 pacman -Syu 后，sshd 无法启动，22 端口也没在监听。”
• “笔记本能启动，但 NVIDIA 更新后图形登录界面一直循环。”
• “内核升级后 PipeWire 音频消失了，扬声器和蓝牙都失效。”

比较差的输入是：

• “Arch 坏了。”

ArchSnapshot 应该包含什么

在 arch-linux-triage for Debugging 的场景下，快照的作用是减少猜测。只放那些会影响诊断的信息：

• 最近一次 pacman -Syu 的时间
• 内核版本，以及你是否已经重启
• 受影响的软件包或服务名称
• 来自 systemctl status 或 journalctl 的相关报错文本
• 如果相关，补充桌面环境或硬件信息
• 这是裸机、VM，还是远程主机

在代理给出高风险建议前先写明限制条件

用 Constraints 可以提前避免不安全或不现实的建议。例如：

• “远程服务器；除非最后手段，否则不要重启。”
• “没有网络，只能用本地控制台。”
• “根分区加密；不要建议重装。”
• “要求尽量少停机；优先可回退的修复方案。”

这是 arch-linux-triage guide 里最能拉高结果质量的部分之一。

把模糊目标改写成强提示词

一次高质量调用通常包含四部分：症状、触发因素、证据、限制条件。示例：

“Use arch-linux-triage. Problem: nginx.service stopped starting after a full system update today. Snapshot: Arch x86_64, kernel 6.x, rebooted once, systemctl status nginx shows config or dependency failure, journalctl -u nginx -b available. Constraints: production host, avoid package removal unless necessary. Give triage steps, remediation commands, validation after each change, and rollback options.”

预期输出应该长什么样

这个技能会引导代理按以下结构返回：

• Summary
• Triage Steps
• Remediation Commands
• Validation
• Rollback/Cleanup

这个结构的价值在于把“诊断”和“执行”分开。如果回答里跳过了验证或回滚，可以要求代理严格按技能定义的格式重新生成。

真实故障中的最佳工作流

使用 arch-linux-triage skill 时，推荐按这个顺序来：

1. 描述症状和最近更新
2. 收集一到两个真实命令输出
3. 让代理提出排查顺序
4. 先只执行最安全的诊断步骤
5. 把结果反馈回去
6. 再要求更收敛的修复和验证方案

相比一开始就要求“直接修好”，这种方式更稳，尤其是在第一个假设未必正确时。

仓库路径与实际安装方式

SKILL.md 里没有写安装命令，而仓库现状也看不到额外资源或脚本。所以理解 arch-linux-triage install 时，应该按“通过支持 skills 的客户端添加这个技能，然后查看 SKILL.md”来处理。如果你的环境支持基于 GitHub 的 skills，相关源路径是 skills/arch-linux-triage/SKILL.md。

能明显提升输出质量的实用建议

想让 arch-linux-triage usage 更靠谱，尽量提供：

• 精确的软件包名，而不是大类描述
• 一条真实报错，而不是转述
• 问题出现在重启前还是重启后
• 这是软件包问题、服务问题、启动问题，还是硬件回归
• 你已经尝试过什么，避免代理在原地打转

arch-linux-triage 技能常见问题

arch-linux-triage 只适合处理软件包问题吗

不是。它明确面向 pacman、systemd 和 rolling-release 排障，因此也适用于服务失败、更新后回归、与启动相关的问题，以及那些日志信息比软件包状态更关键的场景。

什么情况下它比普通 Linux 排障提示词更合适

当问题需要按 Arch 的语境来排查时，就该用 arch-linux-triage。通用提示词经常会忽略软件包数据库状态、内核更新后的重启影响，或者在提出修复前没有先检查 journalctl 和 systemctl。

这个技能对新手友好吗

友好，但有一个前提：它给出的修复方式是命令驱动的，所以新手最好把实际输出原样贴回去，而不是自己临场发挥。这个技能更适合交互式、一轮一步地用，而不是把它当成一段“一次性全修好”的批处理脚本。

什么情况下不该使用 arch-linux-triage

不要把它用于非 Arch 系统、广义安全事件响应，或缺少 Linux 可观测数据的硬件维修问题。如果你无法提供日志、服务名、更新时间，或者任何具体症状细节，它也不会是一个理想选择。

它对远程服务器有帮助吗

有，尤其是在你一开始就说明只能远程操作的限制时。这样技能会更倾向于优先检查、使用可回退命令，并关注重启带来的影响，而不是默认按本地图形桌面恢复的思路来处理。

仓库里包含自动化诊断工具吗

没有。仓库里只有技能定义本身，没有附带 shell 脚本、日志收集器、规则集或参考资料，所以如果你不提供输出，代理也无法自动检查你的系统。

如何改进 arch-linux-triage 技能

提供证据，而不只是下结论

想提升 arch-linux-triage 的结果质量，最快的方法就是贴出简短的原始输出：

• systemctl status <service>
• journalctl -u <service> -b
• 失败时的 pacman 消息
• 内核版本或重启状态

原始证据能帮助代理区分依赖问题、配置损坏、软件包冲突，以及运行时状态未刷新这类问题。

把诊断和修复分开

如果场景本身风险较高，明确要求技能“先 triage，再 fix”。这样可以减少它在生产环境或远程主机上给出糟糕建议的概率，也能让回滚方案更贴近实际。

告诉代理最近到底变了什么

Arch 问题往往和更新直接相关。建议补充：

• 上一次正常状态是什么时候
• 故障前更新了哪些软件包
• 期间是否重启过
• 问题是新出现的，还是间歇性出现

这是在不修改仓库内容的前提下，提升 arch-linux-triage skill 表现最有效的方法之一。

留意常见的失效模式

如果你提供的是下面这些信息，这个技能依然可能发挥失常：

• 没有软件包名或服务名
• 没有日志
• 把 Arch 和非 Arch 环境混在一起描述
• 目标很模糊，比如“优化我的系统”
• 等代理已经建议了破坏性操作之后，才补充限制条件

每一步修复后都要求验证

技能本身已经要求带验证，但如果你明确要求以下内容，效果通常更好：

• “show me what success looks like after each command”
• “include one validation command per change”
• “add rollback if the validation fails”

这样能让 arch-linux-triage for Debugging 在真实排障中更可靠。

用第一次命令输出继续迭代

第二轮最有效的提示词，通常不是“这没用”，而是“这是第 1 步的精确输出”。这样技能可以基于真实状态收敛路径，而不是继续围绕最初症状猜测。

如果你维护仓库，可以这样改进

如果你希望让 arch-linux-triage 更容易被采用，最值得补充的内容包括：

• 面向软件包、服务、启动问题的示例输入包
• 一个简短的“safe on remote host”模式
• 基于 journalctl 和 systemctl 的示例工作流
• 针对 pacman -Syu 后回归和重启检查的指导

相比继续增加营销式文案，这些补充会更实质地提升安装决策信心和首次使用质量。