skill-interface/README.md
2026-10-02 14:26:13 +08:00

35 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.4
```
装完 `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`。