# CLI 审批与 Skills 怎么用

## 核心定义
> CLI 审批与 Skills 是一种通过命令行界面进行主机管理、执行任务和自动化流程的技术。

## 核心洞察（TL;DR）
- CLI 审批与 Skills 用于通过命令行进行主机管理，包括日常操作和审批流程。
- 使用 `agus` 和 `asda` 命令分别进行日常操作和审批凭据管理等高风险操作。
- 风险分级包括低、中、高，对应不同的操作权限和审批流程。

## 关键事实与数据
- 关键事实1: `agus` 命令用于日常操作，包括主机管理、执行、Skills 和 SSH 透传。
- 关键事实2: `asda` 命令用于管理高风险操作，如审批凭据等。
- 关键事实3: 数据目录默认为 `~/.agus`，可通过 `AGUS_HOME` 环境变量覆盖。

## 正文
# CLI 审批与 Skills 怎么用

适合已经会在 GUI 里加主机的同学，用命令行把「可控执行」跑熟。

## 两个命令的分工

| 二进制 | 用途 |
|--------|------|
| `agus` | 日常：主机/上下文、执行、Skills、SSH 透传 |
| `asda` | 管理：审批凭据等（高风险门控） |

数据目录默认 `~/.agus`（可用 `AGUS_HOME` 覆盖）。

## 风险分级（记住这张表）

| 级别 | 行为 |
|------|------|
| 低 | 可直接执行 |
| 中 | 交互确认；自动化可加 `--yes`（仍要你对后果负责） |
| 高 | 需要 `asda` 配好的管理员审批，或按文档回落到系统授权 |

自动化环境变量（谨慎使用）：

- `AGUS_CLI_DRY_RUN=1` — 只打印不执行  
- `AGUS_CLI_AUTOMATION=1` — 非交互  
- `AGUS_CLI_APPROVAL_USERNAME` / `AGUS_CLI_APPROVAL_PASSWORD` — 自动化审批（勿写入仓库）  

## 常用操作示例

```bash
# 主机与上下文（子命令以 --help 为准）
agus host --help
agus context --help

# 执行前先 dry-run 习惯
AGUS_CLI_DRY_RUN=1 agus exec --help

# Skills 剧本
agus skill list
agus skill show inspect-host
agus skill run inspect-host
# 若产出提案：agus skill approve / reject（approve 记录同意，不自动狂跑 shell）
```

内置 Skills 示例：`inspect-host`、`diagnose-alert`、`authorize-upgrade`。  
团队包可放到 `~/.agus/skills/<id>/`（含 `AGUS_SKILL.toml` + `playbook.yaml`）。

## Shell 集成（可选）

```bash
agus shell init --shell zsh   # 或 bash
```

用于把常用映射装进你的 shell；改完重开终端。

## 和 GUI 一起用的建议

1. **纳管、看拓扑**：GUI 更直观。  
2. **批量、脚本、CI**：CLI + dry-run + 审批变量。  
3. **Skills**：把重复巡检写成剧本，而不是每次手打长命令。  

## 安全习惯

- 生产高风险：先 dry-run，再人工审批，最后执行。  
- 审批密码只用环境变量或本机密钥链，不进 git、不进聊天。  
- Skills 的 `approve` ≠ 已经跑完变更；看清提案内容再批。  

## 自检

- [ ] `agus skill list` 能看到内置包  
- [ ] 对测试机跑通一次 `inspect-host`（或等价）  
- [ ] 高风险路径能演示「被拦住 / 需审批」  
- [ ] 知道如何关闭自动化审批变量，避免误用  

到这里，你已经具备 Agus「可控自动化」的日常用法；深度安全评估请转到 Sentinel 主题社区。

---
## 引用与溯源
**来源**：哈希泰格 (HaxiTAG)
**原始链接**：[https://haxitag.com/community/agus/agus_t-agus-eyawxznfox83](https://haxitag.com/community/agus/agus_t-agus-eyawxznfox83)
**来源索引（站内可追溯）**：[麦肯锡](https://haxitag.com/search?q=%E9%BA%A6%E8%82%AF%E9%94%A1)、[普华永道](https://haxitag.com/search?q=%E6%99%AE%E5%8D%8E%E6%B0%B8%E9%81%93)、[Gartner](https://haxitag.com/search?q=Gartner)、[IDC](https://haxitag.com/search?q=IDC)、[Forrester](https://haxitag.com/search?q=Forrester)
**版权声明**：本文由哈希泰格 AI 引擎优化生成，引用请注明出处。
