infra-diagnose

name	infra-diagnose
description	出现数据源/数据库/服务器连通性报错(如 JDBC No route to host、连接超时或被拒)，SSH 登录只读排查并修复，并记录凭据与排查知识。纯前端运行时报错且无需 SSH 登录改用 defect-analyze；只查改业务知识改用 knowledge-curate。
argument-hint	<数据源/服务器报错 | 主机 | JDBC 错误>
user-invocable	true
model	sonnet
effort	high

infra-diagnose

收到数据源/服务器故障线索后，按以下顺序推进：先查本地知识库，再 SSH 只读诊断定位根因，执行破坏性修复前先确认，最后把结论写回知识库。

路由边界

以下场景不属本 skill 范围，请转至对应 skill：

• 纯前端运行时报错、不用 SSH 登录 → defect-analyze。
• 只查询或更新业务知识 → knowledge-curate。

工作流

1. 查知识库：按报错关键词、主机、端口检索 .kata/infra/knowledge/；命中既有条目就优先复用它的方案，省去重复排查。
2. 只读诊断：没命中时读 references/diagnostic-playbook.md，按报错类型分步做只读诊断；SSH 规约见 references/ssh-protocol.md。
3. 写回：定位根因或修复完成后，按 references/knowledge-format.md 把知识条目写回，下次遇到同类问题可以直接复用。

何时加载哪个文件

文件	何时读	作用
references/diagnostic-playbook.md	自行排查时	按报错类型分步只读诊断，再对症修复
references/ssh-protocol.md	需要 SSH 登录时	SSH 连接、读取或补充凭据、破坏性命令把关
references/knowledge-format.md	收尾记录时	知识条目怎么检索、怎么写回

安全规则

凭据流程、JDBC URL 仅解析主机端口、SSHPASS=<pw> sshpass -e ssh 传参、只读命令可自动执行、破坏性操作先确认后复测——权威细节见 references/ssh-protocol.md，执行前以该文件为准。

诊断规范

• 根因必须有命令输出作为支撑，严格区分事实与推断；无证据时不得臆造根因或责任人。
• 仅操作目标服务器和本地 .kata/infra/，不得改动 .kata/repos/** 源仓库。
• 知识条目写入 workspace/{project}/.kata/infra/knowledge/，凭据写入 .kata/infra/credentials.yaml；不写入 feature 目录。