# skill-interface

所有技能的统一切入点：技能目录、用法转发、PATH 入口注册与契约检查

以 Pi package（技能形态）发布。技能本体在 `skills/skill-interface/`。

- 平台：全平台
- 许可：GPL-3.0-or-later（全文见 [LICENSE](LICENSE)）

## 安装

```sh
pi install git:gitea.vhkd.top/pi-hub/skill-interface.git@v0.1.3
```

装完 `pi-skill list` 能看到 `skill-interface`，`pi-skill skill-interface check` 会告诉还缺什么。

## 先准备什么

- `tar`（命令），安装：`macOS/Windows 10+ 自带`；pi-skill pack 生成 .tar.gz 用；没有也能出目录包

## 常用命令

| 命令 | 说明 |
|---|---|
| `list` | 列出技能：名字/分级/别名/命令/何时用 |
| `help` | pi-skill 自己的用法 |
| `stats` | 调用统计：调用量/失败率/错误码/从未被调用的技能与命令（--since 7d|all，--json） |
| `impact` | 影响面：谁硬依赖（脚本调用）/软引用（文档提及）某技能或命令，含近 30d 调用量（--json） |
| `doctor` | 体检：哪些技能缺必需配置（给 setup 命令）/ 缺外部依赖（给装法），--json |
| `pack` | 打包单个技能给他人用：白名单 + 泄漏扫描（密钥/家目录/真实工单号）+ MANIFEST（--out，--json） |
| `audit` | 技能库巡检：路由异常/入口重叠/体量膨胀/重复实现/生命周期（只报告，定期跑） |

用法与对外契约见技能内的 `SKILL.md` 与 `REFERENCE.md`。