# 示例：CLI 工具

CLI 是最简单的情况——通常没有后台进程要管理、没有端口、没有生命周期。该技能专注于**安装**、**代表性调用**和**测试**。

## 重要的内容

- **如何将二进制文件放到 `PATH` 上。** 全局安装？通过 `npx`/`uv run` 运行？构建到 `./target/release/foo`？要明确。
- **两到三个示例调用**，覆盖主要用例。包含预期输出，以便读者可以判断是否成功。
- **退出码**，如果它们有意义（例如 linter 在发现问题时返回 1）。
- **标准输入行为**，如果该工具从 stdin 读取。

## 示例片段

> ---
> name: run-mytool
> description: 构建、安装和运行 mytool。当要求运行 mytool、测试它或验证它是否正确安装时使用。
> ---
>
> ## 设置
>
> ```bash
> pip install -e .
> ```
>
> 这将 `mytool` 放在 PATH 上。验证：
>
> ```bash
> mytool --version
> # → mytool 0.3.1
> ```
>
> ## 运行
>
> 处理单个文件：
>
> ```bash
> mytool process input.json
> # → 已处理 42 条记录，写入 output.json
> ```
>
> 从 stdin 读取，写入 stdout：
>
> ```bash
> cat input.json | mytool process -
> ```
>
> 检查一个目录（发现问题时以非零退出）：
>
> ```bash
> mytool lint ./src
> echo $?  # 0 表示干净，1 表示发现问题
> ```
>
> ## 测试
>
> ```bash
> pytest
> ```

## 保持简短

CLI 的运行技能可以非常紧凑。不要用每个标志来填充——`--help` 输出已经涵盖了那些。只需展示足够让一个代理能够 (a) 构建它，(b) 确认它工作，(c) 运行测试。
