# 用 AI 助手一键安装 ALLinPOL Skills

> **唯一安装源**：Git 仓库 https://github.com/miaolink/allinpol-skills  
> 对 AI 而言 `git clone` / `git pull` + `scripts/bootstrap.py` 比打开官网更直接；官网仅给人阅读，**不要**引导 Agent 去官网“安装”。

整体三件事：

1. 确认本机有 **Git**（建议再有 Python 3.10+ 做校验）。
2. 把下面提示词交给 Cursor / Codex 等 Agent。
3. Agent 从 GitHub **克隆或拉取** → `bootstrap` 校验 → 读 `allinpol.index.yaml` → `skill_router` 按 Intent 选能力 → 汇报。

---

## 复制给 AI 的提示词（推荐）

```
请从 GitHub 一键安装 ALLinPOL Skills 并启用 Agent 能力（不要去官网下载）：

1. 若当前目录还不是该仓库：执行
   git clone https://github.com/miaolink/allinpol-skills.git
   进入仓库根目录。
2. 若已是该仓库：git pull --ff-only（勿 force）。
3. 运行：python scripts/bootstrap.py --mode local --root .
4. 打开并遵循 allinpol.index.yaml、INSTALL.md、AGENTS.md、llms.txt、VENDOR-ACCESS.md、ACCESS-GUARDRAILS.md。
5. 按 Source of Truth 选会话 ID，运行（关键词或规范 Intent / 中文别名均可）：
   python scripts/skill_router.py --session-id <ID> --intent <任务> --json
   示例：--intent 光功率 或 diagnose_onu_flapping 或 端口down
6. 读取路由输出的 SKILL.md 全文后再接设备；默认 READ/DISCOVERY；勿自动 save。
7. 按固定格式汇报：根路径、commit、关键文件、校验结果、下一步。

仓库：https://github.com/miaolink/allinpol-skills
```

---

## 本机最短命令（人可选手敲）

```bash
git clone https://github.com/miaolink/allinpol-skills.git
cd allinpol-skills
python scripts/bootstrap.py --mode local --root .
python scripts/skill_router.py --session-id allinpol.huawei.olt --intent baseline --json
python scripts/skill_router.py --session-id allinpol.huawei.olt --intent 光功率 --json
```

---

## 验收

工作区根目录应有：

- `allinpol.index.yaml`、`INSTALL.md`、`llms.txt`、`llms-full.txt`、`AGENTS.md`
- `VENDOR-ACCESS.md`、`ACCESS-GUARDRAILS.md`
- `skills/`、`docs/`、`registries/`（含 intents / capabilities / diagnosis / skills）、`schema/`
- `scripts/bootstrap.py`、`scripts/skill_router.py`
- `bootstrap` 布局检查 PASS；`skill_router` 能输出含 `canonical_intent` / `workflow` 的 JSON

之后在 Source of Truth / 本地 env 写入已授权设备与会话配置 ID（如 `allinpol.huawei.olt` 或 `allinpol.huawei.switch`），再让 AI 做运维。

---

## 说明

- 仓库权威规格：https://github.com/miaolink/allinpol-skills/blob/main/INSTALL.md
- 诊断目录：https://github.com/miaolink/allinpol-skills/blob/main/registries/diagnosis/INDEX.md
- 人读介绍页（非安装源）：https://www.miaolink.cn/polskill/autoai/index.html
- 远程协助：李先生 · 18670334431（微信同号），备注「ALLinPOL AutoAI」