# ALLinPOL Skills — 仓库完整导航（llms-full.txt）

> 供 LLM 在 **GitHub 克隆工作区** 内一次性消费。  
> 短索引见 [llms.txt](llms.txt)；人读说明见 [README.md](README.md)。

长沙融合网络科技发起的开源公益项目：面向任意 AI Agent 的**网络工程知识库**（全光接入为重心）。

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

---

## Agent 一键安装与能力启用

```bash
python scripts/bootstrap.py --mode local --root .
python scripts/skill_router.py --session-id allinpol.huawei.olt --intent baseline --json
```

- 安装规格：[INSTALL.md](INSTALL.md)
- Agent 规则：[AGENTS.md](AGENTS.md)
- Skill 机读目录：[registries/skills/v1/skills-index.yaml](registries/skills/v1/skills-index.yaml)
- Agent 发现：[allinpol.index.yaml](allinpol.index.yaml)
- 规范 Intent：[registries/intents/v1/intents.yaml](registries/intents/v1/intents.yaml)
- Skill 路由：`python scripts/skill_router.py --session-id <ID> --intent <任务> --json`

复制给 Agent 的最短任务见 [INSTALL.md#agent-最短任务](INSTALL.md)。

---

## 导航流程

```text
Source of Truth（目标 / 授权 / 凭据机制）
  → llms.txt 或本文件选厂商与型号
  → docs/<厂商>/<型号>/<分类>/ 原子模块
  → 对应 skills/ Skill 执行与校验
  → 只记录脱敏证据；WRITE/PERSIST/HIGH-IMPACT 须显式授权
```

概念模型：User intent → Canonical Intent → Capability → Fingerprint / Equipment → Vendor Skill → Evidence → Diagnosis。执行层（SSH/MCP/API）不在本仓库。详见 [ARCHITECTURE.md](ARCHITECTURE.md)。

---

## Registries

- [Equipment Registry](registries/equipment/INDEX.md) — 已版本化并有证据的技术身份；不证明 capability、兼容性或适用 Skill。
- [Skills Registry](registries/skills/INDEX.md) — 会话 ID → Skill 路径机读映射；供 `skill_router.py` 使用。
- [Intent Registry](registries/intents/INDEX.md) — 规范任务 ID 与别名。
- [Capability Registry](registries/capabilities/INDEX.md) — 设备类能力矩阵。
- [Compatibility Registry](registries/compatibility/INDEX.md) — Equipment ↔ 会话适用边界。
- [Command Registry](registries/commands/INDEX.md) — 命令 → Skill 薄索引。
- [Error Registry](registries/errors/INDEX.md) — 字面错误 → 诊断薄索引。
- [Agent 发现](allinpol.index.yaml)
- Schema：[registries/skills/v1/SCHEMA.md](registries/skills/v1/SCHEMA.md)
- 数据：[registries/skills/v1/skills-index.yaml](registries/skills/v1/skills-index.yaml)
- Equipment Schema：[registries/equipment/v1/SCHEMA.md](registries/equipment/v1/SCHEMA.md)
- Equipment 数据：[registries/equipment/v1/equipment-registry.yaml](registries/equipment/v1/equipment-registry.yaml)

---

## 厂商索引

- [cisco](docs/cisco/INDEX.md)
- [h3c](docs/h3c/INDEX.md)
- [huawei](docs/huawei/INDEX.md)
- [raisecom](docs/raisecom/INDEX.md)
- [ruijie](docs/ruijie/INDEX.md)
- [zte](docs/zte/INDEX.md)

---

## 按任务快速入口

| 平台 | 会话配置 ID | 文档 | Skills 起点 |
|------|-------------|------|-------------|
| 华为 OLT（MA5600 / MA5800 / EA5800） | `allinpol.huawei.olt` | [docs/huawei/olt/INDEX.md](docs/huawei/olt/INDEX.md) | [skills/01-huawei-olt-baseline/](skills/01-huawei-olt-baseline/SKILL.md) |
| 华为 VRP 交换机（DISCOVERY） | `allinpol.huawei.switch` | [docs/huawei/switch/INDEX.md](docs/huawei/switch/INDEX.md) | [skills/33-huawei-switch-baseline/](skills/33-huawei-switch-baseline/SKILL.md) |
| 中兴 OLT（ZXA10 C 系列，参考 C650） | `allinpol.zte.olt` | [docs/zte/INDEX.md](docs/zte/INDEX.md) | [skills/21-zte-c650-baseline/](skills/21-zte-c650-baseline/SKILL.md) |
| 中兴 ZXR10 交换机（DISCOVERY） | `allinpol.zte.switch` | [docs/zte/zxr10/INDEX.md](docs/zte/zxr10/INDEX.md) | [skills/42-zte-switch-baseline/](skills/42-zte-switch-baseline/SKILL.md) |
| H3C Comware（DISCOVERY 脚手架） | `allinpol.h3c.comware` | [docs/h3c/comware/INDEX.md](docs/h3c/comware/INDEX.md) | [skills/23-h3c-comware-baseline/](skills/23-h3c-comware-baseline/SKILL.md) |
| 锐捷 RGOS（DISCOVERY 脚手架） | `allinpol.ruijie.rgos` | [docs/ruijie/rgos/INDEX.md](docs/ruijie/rgos/INDEX.md) | [skills/24-ruijie-rgos-baseline/](skills/24-ruijie-rgos-baseline/SKILL.md) |
| 瑞斯康达 ROS/ROAP（DISCOVERY 脚手架） | `allinpol.raisecom.ros` / `.roap` | [docs/raisecom/ros/INDEX.md](docs/raisecom/ros/INDEX.md) | [skills/25-raisecom-ros-baseline/](skills/25-raisecom-ros-baseline/SKILL.md) |
| Cisco ASR1001-X | `allinpol.cisco.iosxe` | [docs/cisco/asr1001-x/INDEX.md](docs/cisco/asr1001-x/INDEX.md) | [skills/cisco-asr1001x/README.md](skills/cisco-asr1001x/README.md) |

- 原生接入与会话 ID：[VENDOR-ACCESS.md](VENDOR-ACCESS.md)
- 通用接入 Skill：[skills/network-device-access/SKILL.md](skills/network-device-access/SKILL.md)
- 配置备份 Skill：[skills/network-config-backup/SKILL.md](skills/network-config-backup/SKILL.md)
- 命令/错误/决策：根目录 [COMMAND-MATRIX.md](COMMAND-MATRIX.md)、[HUAWEI-OLT-ERROR-DATABASE.md](HUAWEI-OLT-ERROR-DATABASE.md)、[HUAWEI-OLT-DECISION-TREE.md](HUAWEI-OLT-DECISION-TREE.md)
- 授权与护栏：[ACCESS-GUARDRAILS.md](ACCESS-GUARDRAILS.md)
- 先查厂商索引，再查型号索引，以选择原子模块。

---

## 华为 OLT Skills（01–20、26–30 + 决策树）

适用范围：MA5600 系列（MA5600T、MA5608T、MA5683T、MA5680T）；MA5800 系列（X2/X7/X15）；EA5800 系列（X2/X7/X15）。已观测参考：MA5800-X7 / MA5800V100R018 / SPH507。

| Skill | 路径 |
|-------|------|
| 01 基线 | [skills/01-huawei-olt-baseline/SKILL.md](skills/01-huawei-olt-baseline/SKILL.md) |
| 02 CLI 发现 | [skills/02-huawei-olt-cli-discovery/SKILL.md](skills/02-huawei-olt-cli-discovery/SKILL.md) |
| 03 DBA | [skills/03-huawei-olt-dba/SKILL.md](skills/03-huawei-olt-dba/SKILL.md) |
| 04 Line Profile | [skills/04-huawei-olt-line-profile/SKILL.md](skills/04-huawei-olt-line-profile/SKILL.md) |
| 05 Service Profile | [skills/05-huawei-olt-service-profile/SKILL.md](skills/05-huawei-olt-service-profile/SKILL.md) |
| 06 ONT Autofind | [skills/06-huawei-olt-ont-autofind/SKILL.md](skills/06-huawei-olt-ont-autofind/SKILL.md) |
| 07 ONT 开通 | [skills/07-huawei-olt-ont-provisioning/SKILL.md](skills/07-huawei-olt-ont-provisioning/SKILL.md) |
| 08 ONT 状态 | [skills/08-huawei-olt-ont-status/SKILL.md](skills/08-huawei-olt-ont-status/SKILL.md) |
| 09 GEM/T-CONT | [skills/09-huawei-olt-gem-tcont/SKILL.md](skills/09-huawei-olt-gem-tcont/SKILL.md) |
| 10 Service-Port | [skills/10-huawei-olt-service-port/SKILL.md](skills/10-huawei-olt-service-port/SKILL.md) |
| 11 VLAN | [skills/11-huawei-olt-vlan/SKILL.md](skills/11-huawei-olt-vlan/SKILL.md) |
| 12 上联 | [skills/12-huawei-olt-uplink/SKILL.md](skills/12-huawei-olt-uplink/SKILL.md) |
| 13 PPPoE 接入 | [skills/13-huawei-olt-pppoe-access/SKILL.md](skills/13-huawei-olt-pppoe-access/SKILL.md) |
| 14 排障 | [skills/14-huawei-olt-troubleshooting/SKILL.md](skills/14-huawei-olt-troubleshooting/SKILL.md) |
| 15 错误库 | [skills/15-huawei-olt-error-database/SKILL.md](skills/15-huawei-olt-error-database/SKILL.md) |
| 16 安全变更 | [skills/16-huawei-olt-safe-change/SKILL.md](skills/16-huawei-olt-safe-change/SKILL.md) |
| 17 回滚 | [skills/17-huawei-olt-rollback/SKILL.md](skills/17-huawei-olt-rollback/SKILL.md) |
| 18 清理 | [skills/18-huawei-olt-cleanup/SKILL.md](skills/18-huawei-olt-cleanup/SKILL.md) |
| 19 生产清单 | [skills/19-huawei-olt-production-checklist/SKILL.md](skills/19-huawei-olt-production-checklist/SKILL.md) |
| 20 ONT WAN/PPPoE | [skills/20-huawei-olt-ont-wan-pppoe/SKILL.md](skills/20-huawei-olt-ont-wan-pppoe/SKILL.md) |
| 26 ONT 生命周期 | [skills/26-huawei-olt-ont-lifecycle/SKILL.md](skills/26-huawei-olt-ont-lifecycle/SKILL.md) |
| 27 板卡巡检 | [skills/27-huawei-olt-board-inventory/SKILL.md](skills/27-huawei-olt-board-inventory/SKILL.md) |
| 28 TR069 | [skills/28-huawei-olt-tr069/SKILL.md](skills/28-huawei-olt-tr069/SKILL.md) |
| 29 IPTV/IGMP | [skills/29-huawei-olt-iptv-igmp/SKILL.md](skills/29-huawei-olt-iptv-igmp/SKILL.md) |
| 30 配置保存 PERSIST | [skills/30-huawei-olt-config-save/SKILL.md](skills/30-huawei-olt-config-save/SKILL.md) |
| 决策树 | [skills/huawei-olt-decision-tree/SKILL.md](skills/huawei-olt-decision-tree/SKILL.md) |

API 工程交叉验证：[HUAWEI-OLT-API-CROSSWALK.md](HUAWEI-OLT-API-CROSSWALK.md)  
华为 OLT 命令全集：[HUAWEI-OLT-CLI-COMMANDS.md](HUAWEI-OLT-CLI-COMMANDS.md)

---

## Cisco ASR1001-X Skills

索引：[skills/cisco-asr1001x/README.md](skills/cisco-asr1001x/README.md)  
命令矩阵：[skills/cisco-asr1001x/CISCO-ASR1001X-COMMANDS.md](skills/cisco-asr1001x/CISCO-ASR1001X-COMMANDS.md)

01-baseline · 02-cli-discovery · 03-interface-diagnostics · 04-optical-diagnostics · 05-ip-routing · 06-static-routing · 07-bgp · 08-ospf · 09-ipv6 · 10-vlan-subinterfaces · 11-pppoe-bng · 12-aaa-local · 13-aaa-radius · 14-nat-cgnat · 15-acl · 16-qos · 17-policy-map · 18-route-map-prefix-list · 19-loopback · 20-management · 21-ssh · 22-boot-config-register · 23-cpu-memory · 24-pppoe-troubleshooting · 25-bgp-troubleshooting · 26-nat-troubleshooting · 27-service-policy-troubleshooting · **28-huawei-olt-access**（经 ASR 跳转华为 OLT） · 29-isp-troubleshooting · 30-safe-change · 31-production-checklist · 32-pppoe-up-no-navigation

路径前缀：`skills/cisco-asr1001x/<编号>-<名称>/SKILL.md`

---

## 其他平台 Skills

| 平台 | Skill |
|------|-------|
| ZTE C650 基线 | [skills/21-zte-c650-baseline/SKILL.md](skills/21-zte-c650-baseline/SKILL.md) |
| ZTE C 系列 ONU 关联 | [skills/22-zte-c600-ont-correlation/SKILL.md](skills/22-zte-c600-ont-correlation/SKILL.md) |
| ZTE 一键开通 ONU | [skills/31-zte-olt-ont-one-click/SKILL.md](skills/31-zte-olt-ont-one-click/SKILL.md) |
| 跨厂商以太网故障诊断 | [skills/diagnosis-ethernet-fault/SKILL.md](skills/diagnosis-ethernet-fault/SKILL.md) |
| 跨厂商 PON 拥塞诊断 | [skills/diagnosis-pon-congestion/SKILL.md](skills/diagnosis-pon-congestion/SKILL.md) |
| 跨厂商业务 VLAN 诊断 | [skills/diagnosis-service-vlan/SKILL.md](skills/diagnosis-service-vlan/SKILL.md) |
| 跨厂商 ONU 不在线诊断 | [skills/diagnosis-onu-offline/SKILL.md](skills/diagnosis-onu-offline/SKILL.md) |
| 跨厂商 ONU LOS/掉电诊断 | [skills/diagnosis-onu-los/SKILL.md](skills/diagnosis-onu-los/SKILL.md) |
| 跨厂商 ONU 光功率诊断 | [skills/diagnosis-onu-optical-power/SKILL.md](skills/diagnosis-onu-optical-power/SKILL.md) |
| 跨厂商 ONU 掉线诊断 | [skills/diagnosis-onu-flapping/SKILL.md](skills/diagnosis-onu-flapping/SKILL.md) |
| ZTE ONU PnP 开局 | [skills/32-zte-olt-onu-pnp/SKILL.md](skills/32-zte-olt-onu-pnp/SKILL.md) |
| 华为交换机 33 基线 | [skills/33-huawei-switch-baseline/SKILL.md](skills/33-huawei-switch-baseline/SKILL.md) |
| 华为交换机 34 CLI 发现 | [skills/34-huawei-switch-cli-discovery/SKILL.md](skills/34-huawei-switch-cli-discovery/SKILL.md) |
| 华为交换机 35 端口/光口 | [skills/35-huawei-switch-interface/SKILL.md](skills/35-huawei-switch-interface/SKILL.md) |
| 华为交换机 36 VLAN/QinQ | [skills/36-huawei-switch-vlan/SKILL.md](skills/36-huawei-switch-vlan/SKILL.md) |
| 华为交换机 37 Eth-Trunk | [skills/37-huawei-switch-eth-trunk/SKILL.md](skills/37-huawei-switch-eth-trunk/SKILL.md) |
| 华为交换机 38 VLANIF | [skills/38-huawei-switch-l3-vlanif/SKILL.md](skills/38-huawei-switch-l3-vlanif/SKILL.md) |
| 华为交换机 39 MAC/ARP/LLDP | [skills/39-huawei-switch-mac-arp-lldp/SKILL.md](skills/39-huawei-switch-mac-arp-lldp/SKILL.md) |
| 华为交换机 40 环路/STP | [skills/40-huawei-switch-loop-stp/SKILL.md](skills/40-huawei-switch-loop-stp/SKILL.md) |
| 华为交换机 41 排障 | [skills/41-huawei-switch-troubleshooting/SKILL.md](skills/41-huawei-switch-troubleshooting/SKILL.md) |
| 中兴交换机 42 基线 | [skills/42-zte-switch-baseline/SKILL.md](skills/42-zte-switch-baseline/SKILL.md) |
| 中兴交换机 43 CLI 发现 | [skills/43-zte-switch-cli-discovery/SKILL.md](skills/43-zte-switch-cli-discovery/SKILL.md) |
| 中兴交换机 44 端口 | [skills/44-zte-switch-interface/SKILL.md](skills/44-zte-switch-interface/SKILL.md) |
| 中兴交换机 45 VLAN | [skills/45-zte-switch-vlan/SKILL.md](skills/45-zte-switch-vlan/SKILL.md) |
| 中兴交换机 46 LACP/smartgroup | [skills/46-zte-switch-lacp-smartgroup/SKILL.md](skills/46-zte-switch-lacp-smartgroup/SKILL.md) |
| 中兴交换机 47 三层 | [skills/47-zte-switch-l3/SKILL.md](skills/47-zte-switch-l3/SKILL.md) |
| 中兴交换机 48 排障 | [skills/48-zte-switch-troubleshooting/SKILL.md](skills/48-zte-switch-troubleshooting/SKILL.md) |
| H3C Comware 基线 | [skills/23-h3c-comware-baseline/SKILL.md](skills/23-h3c-comware-baseline/SKILL.md) |
| 锐捷 RGOS 基线 | [skills/24-ruijie-rgos-baseline/SKILL.md](skills/24-ruijie-rgos-baseline/SKILL.md) |
| 瑞斯康达 ROS 基线 | [skills/25-raisecom-ros-baseline/SKILL.md](skills/25-raisecom-ros-baseline/SKILL.md) |

---

## 根目录参考文档

| 文档 | 用途 |
|------|------|
| [README.md](README.md) | 项目定位、覆盖范围、快速开始 |
| [INDEX.md](INDEX.md) | 主索引 |
| [llms.txt](llms.txt) | LLM 短索引 |
| [ARCHITECTURE.md](ARCHITECTURE.md) | 规范架构与演进 |
| [ACCESS-GUARDRAILS.md](ACCESS-GUARDRAILS.md) | 接入与变更护栏 |
| [VENDOR-ACCESS.md](VENDOR-ACCESS.md) | 厂商会话配置 ID |
| [COMMAND-MATRIX.md](COMMAND-MATRIX.md) | 命令分类矩阵 |
| [HUAWEI-OLT-CLI-COMMANDS.md](HUAWEI-OLT-CLI-COMMANDS.md) | 华为 OLT 命令证据 |
| [HUAWEI-OLT-DECISION-TREE.md](HUAWEI-OLT-DECISION-TREE.md) | 华为 OLT 决策树 |
| [HUAWEI-OLT-ERROR-DATABASE.md](HUAWEI-OLT-ERROR-DATABASE.md) | 华为 OLT 错误库 |
| [ONT-PROVISIONING-CHECKLIST.md](ONT-PROVISIONING-CHECKLIST.md) | ONT 开通清单 |
| [TROUBLESHOOTING-CHECKLIST.md](TROUBLESHOOTING-CHECKLIST.md) | 排障清单 |
| [ROLLBACK-CHECKLIST.md](ROLLBACK-CHECKLIST.md) | 回滚清单 |
| [EXAMPLES.md](EXAMPLES.md) | 脱敏示例 |
| [CONTRIBUTING.md](CONTRIBUTING.md) | 贡献约定 |

---

## 技术证据与运维操作类别

**证据：** `已确认` · `DISCOVERY` · `推断` · `ERRO` · `版本不同`  
**操作类别：** `READ` · `DISCOVERY` · `TEST` · `WRITE` · `PERSIST` · `HIGH-IMPACT`  

下层不得扩大上层授权。权威顺序：目标真实 CLI → 同型号同版本证据 → 目标 discovery → 兼容官方文档 → 其他版本证据 → 推断。

---

## 护栏摘要

- 目标与凭据只来自 Source of Truth；禁止未授权扫描。  
- 凭据、`.env`、客户数据、原始备份勿入库。  
- 默认 `READ` / `DISCOVERY`；`WRITE` / `PERSIST` / `HIGH-IMPACT` 须显式授权与完整计划。  
- 认证失败、host key 异常或 fingerprint 不一致时停止。

全文：[ACCESS-GUARDRAILS.md](ACCESS-GUARDRAILS.md)

---

## 仓库校验（克隆后）

```bash
python scripts/bootstrap.py --mode local --root .
python scripts/skill_router.py --session-id allinpol.huawei.olt --intent baseline --json
```

公开仓库仅提供 Agent 运行时脚本；维护者全量校验在 monorepo 的 `scripts/`（不随本仓库发布）。

---

## 链接

- 短索引：[llms.txt](llms.txt)
- 主索引：[INDEX.md](INDEX.md)
- 仓库根：[README.md](README.md)