# ISS-0107: clinic_cli.py logs 幻觉参数（--component/--level）

## Background

在 ws-1780543020672-995d1e0f1（JP0529-0604 巡检工作区，2026-06-04）中，Agent 使用
`tidbcloud-dedicated-daily-inspection` skill 对集群 `1379661944646416019` 进行巡检时，
调用 `clinic_cli.py logs` 时使用了不存在的 `--component` 和 `--level` 参数：

```
clinic_cli.py logs --cluster-id <id> --component tikv --level ERROR --start <ts> --end <ts>
```

CLI 报错：`error: unrecognized arguments: --component --level`

Agent 自行修正为 `--query '{container="tikv"} |~ "(?i)ERROR|FATAL"'`，但浪费了一次 tool call。

## Observed Error

```
error: unrecognized arguments: --component tikv --level ERROR
```

## Root Cause

`clinic_cli.py logs` 的唯一过滤参数是 `--query`（LogQL 格式），没有独立的 `--component`
或 `--level` 参数。这些是 Agent 从其他系统（如 Loki 直接 API、grep 命令等）的接口语义
"幻觉"出来的参数名，clinic-cli SUBSKILL.md 的 loki/SUBSKILL.md 中明确了正确用法但未
显式列出所有不存在的参数。

关联问题：ISS-0090（`clinic_cli.py metrics` 中幻觉 `--promql` 参数），两者是同一类型
的问题（参数名幻觉），但涉及不同的子命令（metrics vs. logs）。

## Fix Plan

### 短期修复

在 `agentkit/skills/builtin/clinic-cli/loki/SUBSKILL.md` 中增加明确警告：

```markdown
## ⚠️ Common parameter mistakes

- **DO NOT** use `--component`, `--level`, `--severity`, `--container` as separate parameters.
- The **only** filter parameter is `--query` with a LogQL expression.
- To filter by component: use `{container="tikv"}` in the LogQL query.
- To filter by severity: use `|~ "(?i)ERROR|FATAL"` in the LogQL query.
```

在主 `SKILL.md` 中也可以在 loki 章节行内补充一行提示。

### 长期修复

与 ISS-0090 一起，可以考虑在 clinic_cli.py 的 argparse 配置中为常见错误参数添加
`aliases` 或友好的错误提示（如 "Did you mean --query?"），降低幻觉参数的代价。

## Verification

运行以下命令确认修复效果：
1. Agent 在第一次调用 `clinic_cli.py logs` 时即使用正确的 `--query` LogQL 格式
2. 无需 retry 即可成功返回日志结果

## Related Issues

- ISS-0090: `--promql` 幻觉参数（metrics 子命令）— 同类型问题，不同子命令