# astrbot-plugin-dev

AstrBot 插件开发技能，为 OpenCode 提供 AstrBot 插件开发的常见模式、最佳实践和避坑指南。

## 功能

- 项目结构规范（metadata.yaml、_conf_schema.json、requirements.txt）
- 四个核心避坑：`star` 装饰器兼容性、async generator 委托、缺失 `repo` 字段、同步 HTTP 库
- 消息处理速查（过滤器、指令、发送、事件钩子）
- AI 调用模式（LLM、Agent、Tool 定义）
- 存储与调试

## 安装

添加至 `opencode.json`：

```json
{
  "plugin": [
    "astrbot-plugin-dev@git+https://git.rainycy.top/rainysy/astrbot-plugin-dev.git"
  ]
}
```

重启 OpenCode 后自动加载，可通过 `skill` 工具查看已注册技能。

## 结构

```
├── package.json
├── .opencode/plugins/astrbot-plugin-dev.js
└── skills/astrbot-plugin-development/
    └── SKILL.md
```