# ALLinPOL AutoAI

> **ALLinPOL** — 长沙融合网络科技发起的开源公益项目：面向任意 AI Agent 的**网络工程知识库**（全光接入为重心）。  
> **AI 一键安装源（强制）**：GitHub → https://github.com/miaolink/allinpol-skills  
> 用 `git clone` / `git pull` + 仓库内 `scripts/bootstrap.py`，**不要**引导去官网安装。官网仅人读。

Knowledge 在仓库；Execution 在 Agent / Adapter。先认 fingerprint，再按 Intent → Capability → 厂商模块；缺证据时做 DISCOVERY，勿把推断当已确认。

## 给 Agent 的最短任务

```
请从 GitHub 一键安装 ALLinPOL Skills 并启用 Agent 能力（不要去官网下载）：
1. git clone https://github.com/miaolink/allinpol-skills.git
   （已存在则 cd 后：git pull --ff-only）
2. cd allinpol-skills
3. python scripts/bootstrap.py --mode local --root .
4. 阅读 allinpol.index.yaml、AGENTS.md、llms.txt、VENDOR-ACCESS.md、INSTALL.md
5. 按 SoT 选会话 ID 后路由（关键词或规范 Intent / 中文别名均可）：
   python scripts/skill_router.py --session-id <ID> --intent <任务> --json
6. 读路由输出的 SKILL.md 全文；默认 READ/DISCOVERY；固定格式汇报
仓库：https://github.com/miaolink/allinpol-skills
```

等价最短命令：

```
python scripts/bootstrap.py --mode scan
```

## 本目录（介绍页配套，非安装包本体）

- [人读介绍](https://www.miaolink.cn/polskill/autoai/index.html)
- [快速安装提示词](https://www.miaolink.cn/polskill/autoai/ai-quickstart.md)
- [聚合全文](https://www.miaolink.cn/polskill/autoai/llms-full.txt)

## 安装后以仓库为准

- https://github.com/miaolink/allinpol-skills/blob/main/INSTALL.md
- https://github.com/miaolink/allinpol-skills/blob/main/allinpol.index.yaml
- https://github.com/miaolink/allinpol-skills/blob/main/llms.txt
- https://github.com/miaolink/allinpol-skills/blob/main/AGENTS.md
- https://github.com/miaolink/allinpol-skills/blob/main/VENDOR-ACCESS.md

## Registries

- [Agent 发现索引](https://github.com/miaolink/allinpol-skills/blob/main/allinpol.index.yaml)
- [Intent Registry](https://github.com/miaolink/allinpol-skills/blob/main/registries/intents/INDEX.md)
- [Capability Registry](https://github.com/miaolink/allinpol-skills/blob/main/registries/capabilities/INDEX.md)
- [Diagnosis catalog](https://github.com/miaolink/allinpol-skills/blob/main/registries/diagnosis/INDEX.md)
- [Equipment Registry](https://github.com/miaolink/allinpol-skills/blob/main/registries/equipment/INDEX.md)
- [Skills Registry](https://github.com/miaolink/allinpol-skills/blob/main/registries/skills/INDEX.md)
- [Compatibility / Command / Error](https://github.com/miaolink/allinpol-skills/tree/main/registries)

## 厂商

- [cisco](https://github.com/miaolink/allinpol-skills/tree/main/docs/cisco)
- [h3c](https://github.com/miaolink/allinpol-skills/tree/main/docs/h3c)
- [huawei](https://github.com/miaolink/allinpol-skills/tree/main/docs/huawei)
- [raisecom](https://github.com/miaolink/allinpol-skills/tree/main/docs/raisecom)
- [ruijie](https://github.com/miaolink/allinpol-skills/tree/main/docs/ruijie)
- [zte](https://github.com/miaolink/allinpol-skills/tree/main/docs/zte)

## 按任务快速入口

| 平台 | 会话配置 ID | Skills / 文档（仓库内路径） |
|------|-------------|------------------------------|
| 华为 OLT | `allinpol.huawei.olt` | `docs/huawei/olt/` · `skills/01-huawei-olt-baseline/` |
| 华为交换机 | `allinpol.huawei.switch` | `docs/huawei/switch/` · `skills/33-huawei-switch-baseline/` |
| 中兴 OLT | `allinpol.zte.olt` | `docs/zte/` · `skills/21-zte-c650-baseline/` |
| 中兴交换机 | `allinpol.zte.switch` | `docs/zte/zxr10/` · `skills/42-zte-switch-baseline/` |
| H3C Comware | `allinpol.h3c.comware` | `docs/h3c/comware/` · `skills/23-h3c-comware-baseline/` |
| 锐捷 RGOS | `allinpol.ruijie.rgos` | `docs/ruijie/rgos/` · `skills/24-ruijie-rgos-baseline/` |
| 瑞斯康达 ROS | `allinpol.raisecom.ros` / `.roap` | `docs/raisecom/ros/` · `skills/25-raisecom-ros-baseline/` |
| 思科 ASR1001-X | `allinpol.cisco.iosxe` | `docs/cisco/asr1001-x/` · `skills/cisco-asr1001x/` |

规范意图示例：`query_onu_optical_power`（光功率）、`diagnose_onu_flapping`（掉线）、`diagnose_ethernet_fault`（端口down）。

- Skill 路由：`python scripts/skill_router.py --session-id <ID> --intent <任务>`
- 诊断目录：`registries/diagnosis/INDEX.md`
- 授权与护栏：`ACCESS-GUARDRAILS.md`

## 规则

1. 目标与凭据只来自 Source of Truth；禁止未授权扫描。  
2. 先 fingerprint；缺证据 `DISCOVERY`。  
3. 默认 `READ`；`WRITE` / `PERSIST` 须显式授权；禁止自动 save。  
4. 路径存在 ≠ 已兼容；勿跨系列照抄 CLI。