# ISS-0088: clinic --env dev 参数不支持 / dev 环境集群无法诊断

## Background

用户通过 GitHub issues #563、#564 反馈（workspace ws-1779176792765-e116e462e，
dev.investibook.com 环境，cluster 10725806546876878563）：

- #563: "dev 环境的集群" — dev 环境集群诊断支持问题
- #564: "clinic 可以设置 --env dev" — 用户观察到 clinic 命令支持 --env dev 参数

## Problem

`collect_evidence.py` 中调用 `clinic-auth.sh` 及 Clinic API 时，默认使用生产环境端点
（clinic.pingcap.com）。对于 dev 环境的集群（部署在 TiDB Cloud dev/staging 环境），
Clinic 数据存储在 dev/staging 的 Clinic 实例中，生产端点无法访问其数据。

用户观察到 clinic CLI 支持 `--env dev` 参数来切换到 dev 环境端点，但
`collect_evidence.py` 中没有该参数的传递路径，导致 dev 集群的诊断数据无法采集。

## Impact

- dev.investibook.com 上的所有诊断会话，若集群属于 dev/staging 环境，
  `collect_evidence.py` 将无法获取 metrics/TopSQL/SlowQuery/logs 数据
- 表现为所有 Clinic API 调用返回空结果或 404/403

## Fix Plan

### Step 1: 理解 --env dev 参数

调研 clinic-auth.sh 支持的 --env 参数：
```bash
# 验证：
./clinic-auth.sh --env dev
# 预期：对应 dev.clinic.pingcap.com 或同等端点
```

### Step 2: collect_evidence.py 增加 --env 参数支持

在 `collect_evidence.py` 的参数解析中增加 `--env` 选项：

```python
parser.add_argument("--env", default="prod",
                    choices=["prod", "dev", "staging"],
                    help="Clinic environment: prod (default), dev, or staging")
```

将 `--env` 参数传递给所有 `clinic-auth.sh` 调用：
```python
auth_cmd = [f"{SKILL_DIR}/clinic-auth.sh", "--cluster-id", cluster_id,
            "--env", args.env]
```

### Step 3: SKILL.md 增加 dev 环境诊断说明

在 SKILL.md 中增加环境参数说明：
```markdown
**Dev/Staging 集群诊断**：
若集群属于 dev 或 staging 环境（从 Jira source 或用户说明判断），
在调用 collect_evidence.py 时添加 --env dev 参数：
```bash
python3 $SKILL_DIR/scripts/collect_evidence.py --cluster-id $CLUSTER_ID --env dev
```
```

### Step 4: Investibook 端点自动检测

长期方案：根据 Investibook 实例的部署环境（dev.investibook.com vs investibook.tidbcloud.com）
自动推断 --env 参数，无需用户手动指定：

```python
# 在 collect_evidence.py 或 SKILL.md 中：
# 若 INVESTIBOOK_ENV=dev → --env dev
# 若 INVESTIBOOK_ENV=prod 或未设置 → --env prod（默认）
```

## Verification

在 dev.investibook.com 中使用 dev 集群验证：
1. collect_evidence.py 使用 --env dev 参数能成功采集 metrics 数据
2. SKILL.md 引导 agent 识别 dev 环境并使用正确参数

## Files to Modify

- `agentkit/skills/builtin/tidb-clinic-diagnosis/scripts/collect_evidence.py`
  - 增加 --env 参数支持并传递给 clinic-auth.sh
- `agentkit/skills/builtin/tidb-clinic-diagnosis/SKILL.md`
  - 增加 dev/staging 集群诊断说明