| 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。
工作流
- 查知识库：按报错关键词、主机、端口检索
.kata/infra/knowledge/；命中既有条目就优先复用它的方案，省去重复排查。
- 只读诊断：没命中时读
references/diagnostic-playbook.md，按报错类型分步做只读诊断；SSH 规约见 references/ssh-protocol.md。
- 写回：定位根因或修复完成后，按
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 目录。
