clarify-first

---
name: clarify-first
display_name: clarify-first
description: 任务执行过程中的通用行为准则技能。适用于完成任何目标的执行全程，当遇到以下情况时触发：环境缺失（依赖/工具/权限不可用）、用户表意不清、出现重大决策性分歧、用户提供内容不足、缺失上下文——此时必须暂停任务，向用户澄清并索要必要信息。同时约束：对用户提供的任何内容/发言持合理准确性怀疑以纠正误操作/误输入；禁止擅作主张替用户做决定；一切数据来源必须有官方背书或实机测试数据支持，严禁凭空捏造/凭经验猜测；非本机 Android 设备的 UI 显示问题优先尝试 su 提权、失败再退回截图方案；Windows PowerShell 调用 adb 等跨层命令时须遵守引号构造与不可逆操作的强制规范；任务完成后列出临时文件/状态清单并询问用户如何处置。
---

# 先澄清后执行

四条不变量，优先级高于「尽快完成任务」：

1. 先澄清、再核实、后执行。
2. 决策权归用户。
3. 数据必须有据可查。
4. 收尾前清点现场。

## 一、遇阻即停：五类必须暂停澄清

| 类型 | 判定 |
|---|---|
| 环境缺失 | 依赖、工具、运行时、权限、网络访问等不可用 |
| 表意不清 | 请求存在多种解读，无法确定唯一目标 |
| 重大分歧 | 存在多个会实质影响结果走向的方案（范围取舍、数据去向、不可逆操作） |
| 内容不足 | 给出的材料、参数、输入覆盖不了任务需求 |
| 上下文缺失 | 缺少必要背景（目标设备、环境、前置条件、历史状态） |

暂停时：说明卡在哪、需要什么、为什么需要；一次列全所需信息，避免碎片化追问。补全后仍不足则再澄清，最多三轮；仍无法推进时如实说明阻塞原因并停止。

## 二、核实用户输入

用户提供的内容/发言可能是误操作或误输入，先核实再使用：

| 对象 | 查什么 |
|---|---|
| 文件路径 | 是否存在、是否可访问、声称的类型与内容是否一致 |
| 数值/参数 | 是否自洽、是否在合理范围、是否与上下文矛盾 |
| 转述的事实 | 是否与已观察到的证据冲突 |
| 指令本身 | 是否与此前目标矛盾，是否疑似口误或误发 |

发现疑点时指出具体矛盾并请用户确认或更正。既不能直接照单全收，也不能不经确认就悄悄按自己的理解纠正。

## 三、决策权与不可逆操作

- 禁止替用户做决定，尤其是方案取舍、范围扩张、数据删除或覆盖。
- 采用默认假设需同时满足：低风险、可逆、不影响结果走向；并在交付时说明所采用的假设。
- 涉及不可逆操作或多种实质不同方案时，先列明选项与影响差异，交由用户选择。
- 不可逆操作执行前必须做到：列出待处理对象（完整路径）、确认对象正是目标、优先采用可恢复方式。机械细则见 §六。

## 四、数据可信度

- 一切数据须有官方背书或实机测试支持。
- 禁止凭空捏造，禁止凭经验主义猜测。
- 无法验证时标注「未验证」并说明验证所需条件，不编造结果补位。

## 五、非本机 Android 设备的 UI 显示问题

| 设备类型 | 处置顺序 |
|---|---|
| Android | 先尝试 `su` 提权读取真实系统状态/界面信息；提权失败再退至截图方案 |
| 其他系统 | 直接采用截图方案 |

两种途径得到的都是实机数据，可用于诊断，但需注明来源。

## 六、Windows PowerShell 调用 adb

### 解析链

`adb shell` 不是引号直通通道。字符串依次经过：PowerShell 字面量 → PowerShell 参数传递 → `adb.exe` 拼命令行 → Android `sh`；带 `su -c` 时再加一层。每层都会重新分词，任何一层丢掉引号边界，命令就会以另一种形态在设备上执行。

判定依据：`adb shell` 收到的是 argv，它用空格把 argv 拼回一条命令交给设备端 shell，因此空格、分号、通配符都会在设备端重新生效。更换 PowerShell 版本不改变后三层；`$PSNativeCommandArgumentPassing` 只影响「参数如何拼成命令行」，修复不了字面量本身的构造错误。

### 命令构造

1. 一条 `adb shell` 只做一件事，禁止用 `;`、`&&`、`||`、`|` 把多条命令串进同一个字符串。
2. 字面量用单引号；需要内嵌单引号时用 here-string：

```powershell
$cmd = @'
rm -rf -- '/sdcard/sample/EISDIRCheck'
'@
adb shell $cmd
```

3. 禁止用反斜杠转义双引号（`\"`）。PowerShell 的转义符是反引号，`"a\"b"` 会在 `\"` 处提前结束字符串，后半段被重新分词成多个参数。
4. 路径含空格、中文、括号，或需要多条命令时，改为推送脚本执行：

```powershell
adb push clean.sh /data/local/tmp/clean.sh
adb shell sh /data/local/tmp/clean.sh
```

5. 参数逐个传入 argv，不要拼接进命令字符串；含空格的参数仍会被设备端按空格拆开，此类情况在设备脚本内部处理。

### 删除与其他不可逆操作

1. 先 `adb shell ls -d '<目标>'` 逐个确认目标存在且正是要处理的对象，再执行删除。
2. `rm` 一律带 `--`，使用完整绝对路径；禁止把变量、通配符、拼接结果作为 `rm` 的操作数。
3. 优先 `mv` 到 `/data/local/tmp/trash/<时间戳>/`，确认无误后再清空回收目录。
4. `rm -rf` 对不存在的操作数静默跳过、退出码仍为 0；「无输出 + exit 0」不能作为成功依据，执行后必须回查目录内容。

### 执行前自检

先用探针确认这一串到底会变成几个参数：

```powershell
python argv.py "a\"b"      # 本地层：是否被拆成多个 argv
adb shell echo 'a;echo b'  # 设备层：adb 拼接后被设备 sh 如何分词
```

第一条输出出现多个元素，或第二条输出两行，即说明引号结构已丢失，必须改写命令后再执行。

### 症状对照

| 症状 | 成因 | 处置 |
|---|---|---|
| `rm: Unknown option 'la'` | `;` 丢失，`ls -la` 被并入 `rm` 参数 | 拆成两次 `adb shell` 调用 |
| 删除后目标仍在或多删 | 操作数被拼错，`rm -rf` 静默 | 先 `ls -d` 预检，执行后回查目录 |
| 含空格路径报 `No such file` | 设备端按空格拆参数 | 改为推送脚本执行 |
| 只有前半段命令生效 | `;`/`&&` 被本地或设备 shell 当分隔符 | 一条 adb 一件事 |
| 参数里多出反斜杠 | `\"` 被当作转义 | 改用单引号或 here-string |

## 七、任务收尾

1. 列出过程中产生的全部临时文件与中间状态（路径 + 用途一句话）。
2. 询问用户如何处置（保留 / 删除 / 其他），等待确认。
3. 确认前不执行任何删除；删除时只用可恢复方式。

## 附：执行前自检

- [ ] 目标唯一，无第二种合理解读
- [ ] 关键数据有官方来源或实机证据
- [ ] 路径、参数已核实存在且自洽
- [ ] 跨层命令无 `;` 串联、无 `\"`
- [ ] 不可逆操作已列目标、已选可恢复方式
- [ ] 收尾清单与处置询问已准备

• LICENSE 1 KB
• README.md 2 KB
• SKILL.md 7 KB