# TapTap CLI Skill: CLI 入口与路由

TapTap 开发者中心的统一入口 skill，负责查看 skills、解释 CLI 调用范式，并把请求路由到对应业务 skill。

- 网页版: /v3/cli/#skill-taptap-cli
- Markdown: /v3/cli/skills/taptap-cli.md

## 摘要

| Skill ID | 分组 | 类型 | 作用域 | 主要命令数 | 确认要求 |
| --- | --- | --- | --- | --- | --- |
| taptap-cli | CLI & discovery | CLI / router | Global → Developer → App | 0 | 无 |

## 行为与边界

`taptap-cli` 本身不承接具体业务流程。先用 `--help`、`skills list` 和 `aliases` 判断业务域，再用 `<domain> --help` 或 `schema <domain> <verb>` 查看当前参数、风险和返回结构。

> `skills read` / `<domain> --help` / `schema` 输出的字段名、枚举和结构默认是给 Agent 决策的**内部执行信息**，不是面向普通用户的产品说明；回复用户只给业务结论与下一步动作，除非用户明确要求 debug / JSON / schema。

## 能力摘要

- 查看业务能力列表，并用 `skills read <id>` 阅读具体指南。

- 统一 CLI 调用范式：认证、默认 JSON 输出、业务域帮助、schema 和 shortcut。

- 资源发现：开发者 / 应用列表与切换。

- 文件上传入口：图片 / 视频 / 包体直传。

- 跨 skill 路由与防误路由分流。

## 调用范式

| 范式 | 命令 | 说明 |
| --- | --- | --- |
| 认证 | taptap-cli auth login · auth status · auth logout | 浏览器授权；登录失效时按提示重新授权。 |
| 能力发现 | taptap-cli --help · skills list · aliases · <domain> --help | 先定位业务域，再读取对应 Skill 和方法 schema。 |
| 命令树调用 | taptap-cli <domain> <verb> --dev-id <id> --app-id <id> ... | 业务命令默认输出 JSON；不可逆写必须带 --yes，可先用 --dry-run 试跑。 |
| 查 schema | taptap-cli schema <domain> <verb> | 返回完整 JSON Schema（参数名、类型、枚举）。 |
| 资源发现 | taptap-cli developer +list · app +list --dev-id <id> --kw <kw> | 多结果时停下让用户选，不自动猜。 |
| 上传 | taptap-cli upload <img> ... --yes · upload-video · upload-apk · upload-pc-package · upload-h5-package | 上传都是写操作，先用 --dry-run 试跑，再用 --yes 执行；Tap 小游戏上传转开发者中心。 |

## 你可以这样问

- TapTap CLI 现在能帮我处理哪些开发者中心的事情？

- 我不知道这件事该找哪个能力，可以帮我判断吗？

- 这个需求 CLI 支持吗？如果不支持，我接下来应该怎么办？

## 示例

```bash
taptap-cli skills list                 # 业务域粗定位
taptap-cli skills read taptap-app-edit          # 阅读适用场景和执行边界
taptap-cli --help                              # 读取业务域和 shortcut
taptap-cli aliases                             # 查看快捷命令映射
taptap-cli schema app analyze-app-status       # 读取动作 schema
```

## 用户可见输出边界

只输出业务结论、自然语言状态和下一步动作。默认**不转述** schema 里的字段名、枚举值、ID、算法细节、工具返回 shape；仅在用户明确要求 debug / JSON / schema 时展示。

## 相关能力

- taptap-identity — 首次定位当前 scope、发现厂商 / 游戏。

- 全部业务 skill — 由本 skill 按路由表分发。