内容
# agent-skills
A personal collection of reusable AI agent skills and MCP-related utilities.
这个仓库用于收集个人日常使用中沉淀下来的 agent skills，包括网页读取、命令行调用规范、自动化流程、工具集成经验等。内容以可直接复制使用的 `SKILL.md` 为主，后续也可能加入 MCP server 配置和示例。
## 安装
复制需要的 skill 到你的 agent 技能目录即可。
### Codex
推荐使用 PowerShell 7+ (`pwsh`)。`powershell-safe-invocation` skill 针对现代 PowerShell 行为编写，尤其关注原生命令参数传递、路径、引号、编码和进程启动。
- 安装指南：[Install PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell)
- 发布页面：[PowerShell GitHub Releases](https://github.com/PowerShell/PowerShell/releases)
```powershell
$repo = (Get-Location).Path
$target = "$env:USERPROFILE\.codex\skills"
New-Item -ItemType Directory -Force -Path $target | Out-Null
Copy-Item -LiteralPath "$repo\skills\bilibili-page-reader" -Destination $target -Recurse -Force
Copy-Item -LiteralPath "$repo\skills\powershell-safe-invocation" -Destination $target -Recurse -Force
```
### 其他 agent
如果你的 agent 使用其他技能目录，例如 `~/.agents/skills`，把 `$target` 改成对应路径即可。
## bilibili-page-reader 的工作环境与依赖
`bilibili-page-reader` 用来读取 Bilibili 视频页内容：优先获取投稿字幕、弹幕摘要和评论；如果没有投稿字幕，再走音频下载和本地 ASR 转写。
运行这个 skill 主要依赖这几类工具：
- [Kimi WebBridge](https://www.kimi.com/zh-cn/features/webbridge)：让 agent 访问真实浏览器页面，用于读取当前 Bilibili 页面状态和登录后可见内容。
- [Bilibili Evolved](https://github.com/the1812/Bilibili-Evolved)：提供投稿字幕、弹幕等页面内数据来源。
- Node.js：用于请求 Bilibili playurl API 和下载音频流。
- `ffmpeg` / `ffprobe`：用于音频格式转换和时长读取。
- Python + [FunASR](https://github.com/modelscope/FunASR)：无投稿字幕时，把下载到的音频转写成 SRT/VTT/JSON。
相关辅助文件：
- `skills/bilibili-page-reader/audio2srt.py`：音频转字幕脚本。
- `skills/bilibili-page-reader/clean_srt.py`：SRT 清理脚本。
- `skills/bilibili-page-reader/agents/openai.yaml`：agent 界面元数据。
更具体的执行步骤、兜底策略和常见问题写在 `skills/bilibili-page-reader/SKILL.md` 中。
## 可用 Skills
| Skill | 说明 |
| --- | --- |
| [`bilibili-page-reader`](skills/bilibili-page-reader/) | 读取 Bilibili 视频页，包括投稿字幕、弹幕摘要、评论；无字幕时可通过 FunASR 下载音频并转写。 |
| [`powershell-safe-invocation`](skills/powershell-safe-invocation/) | Windows agent 的安全 PowerShell 调用规范，覆盖原生命令参数、路径、引号、编码和进程启动。 |
## 仓库结构
```text
skills/ 可复用的 agent skills
mcp/ 预留给未来的 MCP servers、配置和示例
```
每个 skill 都放在独立目录中，并以 `SKILL.md` 作为入口。有些 skill 还会包含辅助脚本、示例或 agent 专用元数据。
## 许可证
[MIT](LICENSE)
MCP 市场