opencode-skills

一组可直接使用的 opencode Skill（AI 能力扩展包）。

包含的 Skills

Skill	作用	目录
image-vision	给不支持读图的大模型提供「眼睛」：图片/截图/剪贴板/URL/PDF/多图识别，支持多供应商视觉 API 或本地 ollama	image-vision/
notion-blog	向 Notion 数据库发布/管理博客文章：自动填充字段、Markdown 转 blocks、批量写入、字段更新、归档删除	notion-blog/

安装

# 1. 拷贝到 opencode 用户 Skill 目录
cp -r image-vision ~/.agents/skills/
cp -r notion-blog ~/.agents/skills/

# 2. 可执行权限
chmod +x ~/.agents/skills/image-vision/vision
chmod +x ~/.agents/skills/notion-blog/nb

# 3. 配置（每个 skill 各自说明见下）

注意：安装后需重启 opencode 会话，新 Skill 才会被加载。

安全性说明

• 不包含任何真实 API Key / Token：所有配置均为 config.example.json 占位模板
• 真实配置由用户自行创建：复制 config.example.json 为 config.json 并填入自己的 Key
• notion-blog 的 Token 从环境变量 NOTION_TOKEN 读取，不落盘
• 发布前请检查：grep -r "sk-\|ntn_\|secret_" . 确认无真实凭据

image-vision 使用

# 安装后
~/.agents/skills/image-vision/vision --help

# 识别图片
vision screenshot.png "识别报错信息"
vision --clipboard "描述截图"
vision https://example.com/a.png
vision report.pdf --pdf-page 3
vision a.png b.jpg --prompt "对比差异"
vision --get   # 从 opencode 数据库提取最新图片

详见 image-vision/SKILL.md。

notion-blog 使用

export NOTION_TOKEN="ntn_..."   # 必填
# 复制 config.example.json 为 config.json 并填入 database_id

~/.agents/skills/notion-blog/nb create --title "标题" --category 技术分享 --tags "教程" --content article.md
~/.agents/skills/notion-blog/nb list
~/.agents/skills/notion-blog/nb update <id> --status Draft
~/.agents/skills/notion-blog/nb delete <id>

详见 notion-blog/SKILL.md。