Claude Code / Codex / Hermes 通用增强插件集合。这个仓库同时兼容三种 agent runtime，但各插件的 runtime 覆盖不同。插件按用途分类，方便在不同环境中按需启用：
steroids：主体 Skills 和通用 workflow。telegram：Claude Code 专用的 Telegram agent 运维、通知 MCP、Telegram hook，并包含 guard-payload-size。chrome：可选的每 OS 用户一个进程的共享有头 Chrome provider；Claude Code / Codex 安装后随插件提供 cdp-chrome MCP 启动器。write-blog：Claude Code 专用的写作流程 skill 插件——选题构思、对话式挖掘、大纲迭代、按作者风格成文，附信息图/制图参考。taskdag：仓库原生的 ADR + Task DAG 控制面——结构化任务/决策文档、vendor 进项目的零依赖生命周期 CLI、生成式 DAG 看板、跨 agent 派发。wechat：Claude Code / Codex 通用的本机微信（macOS 4.x）聊天记录读取插件——只读本地磁盘、本地解密 SQLCipher 库，绝不操作微信客户端。仅 macOS + Apple Silicon。market：Claude Code / Codex 通用的调研/数据分析方法论插件——目前含 trend-radar skill：自底向上扫描 Reddit/X/TikTok/YouTube/Instagram，强制每条候选话题/关键词附互动量达标证据,不接受凭假设推断的条目；后续会陆续收纳更多社媒调研与 SEO/关键词数据方法论。
steroids、chrome、taskdag 和 market 的 canonical skills 位于 plugins/<plugin>/skills/ 并可跨 runtime 复用；Claude Code / Codex 通过各自 marketplace 安装，Hermes 通过根目录 shim 仅暴露 steroids 与 chrome。wechat 同时提供 Claude Code 与 Codex marketplace 条目，但不提供 Hermes shim（仅 macOS）；market 同理提供 Claude Code 与 Codex 条目，暂不提供 Hermes shim；telegram 和 write-blog 保持 Claude Code 专用。
安装、升级、启用流程统一见 INSTALL.md。如果让 agent 帮你安装，直接让它先读取这份安装手册即可。
详细设计见 docs/tech/20260518-plugin-split.md。核心原则：插件之间优先依赖能力（capability），不要把 provider 写死成硬依赖。例如 paper-download 需要 headed-browser 能力，但不一定需要安装 chrome/cdp-chrome；如果用户环境已有 Codex Chrome plugin 或原生 browser-use，就可以直接使用现有 provider。
| Plugin |
Runtime |
包含内容 |
硬依赖 |
可选 / capability 依赖 |
steroids |
Claude + Codex + Hermes |
主体 Skills：文档处理、书籍阅读、PDF 导出、网页剪藏、论文下载、模型派发（dispatch）、Agent 记忆管理（诊断/整理/吸收），以及 /song |
无 |
paper-download / clipping 的登录态或 CAPTCHA 场景需要 headed-browser |
telegram |
Claude Code only |
telegram-agents、/tg-*、/check-release、telegram-notify MCP、Telegram time hook、guard-payload-size hook |
Claude Code + official Telegram plugin；心跳 workflow 需 Telethon/tmux/launchd |
无 |
chrome |
Claude + Codex + Hermes |
cdp-chrome 每 OS 用户一个进程的共享有头 Chrome provider；Claude/Codex 内置 cdp-chrome MCP 启动器，会读取当前用户 steroids 配置 |
Chrome、npx；Hermes 使用时需在 mcp_servers 注册 |
提供 headed-browser，可被 Codex Chrome plugin / 原生 browser-use 替代 |
write-blog |
Claude Code only |
write-blog skill：选题/对话式挖掘/大纲迭代/按作者风格成文，附 voice-dna 与制图参考 |
无 |
无 |
taskdag |
Claude + Codex |
orchestrator skill：ADR + Task DAG 控制面，含 vendor 进项目的 taskdag.py（validate/query/transition/board）与派发/复审参考 |
Python 3（仅标准库） |
派发映射到本机可用的 agent CLI（Claude Code / Codex / OpenCode 等） |
wechat |
Claude + Codex |
wechat-extract skill：解密本机微信（macOS 4.x）SQLCipher 库、导出/总结群聊，含初始化手册（临时关 SIP 截口令、恢复 SIP、开 FDA） |
macOS + Apple Silicon；Homebrew zstd；一次性 lldb 截口令 |
无 |
market |
Claude + Codex |
调研/数据分析方法论；目前含 trend-radar skill：自底向上扫描 Reddit/X/TikTok/YouTube/Instagram 发现真实热门话题，每条候选词强制附互动量达标证据，拒绝凭假设推断的条目 |
无 |
Reddit/X 免费公开访问即可；TikTok/Instagram 通常需要第三方抓取服务的付费 key |
| Skill |
Plugin |
说明 |
extract-to-md |
steroids |
将网页导出内容或 PDF 报告重构为可编辑 Markdown。处理断行修复、段落结构恢复、图片插入等。 |
read-book |
steroids |
EPUB 书籍中英双语翻译，以及阅读和讨论书籍内容。 |
youtube-bilingual-transcript |
steroids |
把 YouTube 链接转成中英对照单页 HTML 阅读稿。yt-dlp 抓字幕+章节，agent 翻译并策展，脚本渲染带时间戳跳转、带序号章节目录、重点高亮、专有名词内联点击注释。 |
html-to-pdf |
steroids |
将样式化 HTML 转为高质量单页 PDF。自动处理动态元素（scroll-snap、CSS 动画、IntersectionObserver），含可复用生成脚本。 |
dispatch |
steroids |
把活派给别的模型的 CLI（Codex 跑 GPT，OpenCode 跑 GLM/DeepSeek/Kimi）：怎么写任务、这些 CLI 有哪些提示词里看不见的硬边、怎么审收回来的产物。 |
clipping |
steroids |
将网页文章保存为本地 Markdown 笔记。支持微信公众号等 JS 渲染页面；对信息图/表格截图可使用 PaddleOCR 提取文本并重构为 Markdown 表格。 |
paper-download |
steroids |
学术论文检索与下载。三级策略：HTTP/OA 直链、headless 解析、headed browser 登录/CAPTCHA。cdp-chrome 只是可选 provider。 |
clash-verge-config |
steroids |
Clash Verge Rev / mihomo / Stash 客户端配置即代码：保留字段与 enhance 管线、不中断 provider 热刷新、隔离内核验收、Stash Override、运行态 controller、规则/provider/真实连接闭环、DNS 与浏览器泄漏、TUN 回环。 |
skill-console |
steroids |
生成本地 Skill 清单控制台，审计 token 用量、description token、重复项路径、Skill 内容预览，并导出选中 Skill 的 {name, path} JSON。 |
hippocampus |
steroids |
Agent 记忆与上下文的品味清单（T1–T14，每条附反模式）：最短充分表达、护栏越少越好、description 只答「何时用」、一个事实一个主人、重构不追加等。用于体检清理 CLAUDE.md/AGENTS.md、auto-memory、skill 与工具描述，或把教训沉淀到唯一归属。 |
telegram-agents |
telegram |
Telegram agent 配置与管理。包括 tmux 会话、Telethon 调度器、launchd 心跳定时任务。 |
cdp-chrome |
chrome |
可选的共享有头 Chrome provider。适合需要持久登录态、用户手动 CAPTCHA、反 bot 页面或 live site inspection 的环境；明确独立 CDP profile 与日常 Chrome 的验证边界。 |
write-blog |
write-blog |
写作全流程：从录音稿成文，或从零开始的对话式写作（选题、调研、提问漏斗、大纲迭代、初稿）。按作者 voice-dna 风格输出，附「图形为主、文字为辅」制图参考。 |
orchestrator |
taskdag |
仓库原生的 ADR + Task DAG 控制面：任务按「一次派发」粒度拆分并标注 priority/model-tier/effort，零依赖 taskdag.py 管 schema 校验、runnable 推导、状态机与单文件 DAG 看板（可发布到仓库外路径）；含初始化/迁移、跨 agent 派发映射两份参考。 |
wechat-extract |
wechat |
读取/总结/提取本机微信桌面端（macOS 4.x）聊天记录：只读本地 SQLCipher 库、本地解密，绝不操作微信客户端（零封号风险）。含 references/setup.md 初始化手册（临时关 SIP → lldb 截口令 → 恢复 SIP → 开 FDA）与 scripts/wechat.py 解密导出管线（decrypt/groups/contacts/dump）。 |
trend-radar |
market |
自底向上发现社媒平台真实热门话题/关键词：先看平台实际在发生什么，不先假设类目再找帖子佐证；每条候选词按平台互动量门槛（点赞/转发/播放/评论）二选一收录，不设低置信度中间态；含 references/platform-mechanics.md（Reddit 公开 .json 端点、X cookie 免费访问与查询长度坑、TikTok/Instagram 付费抓取现状、中文平台现状）。 |
| Hook |
Plugin |
说明 |
guard-payload-size |
telegram |
会话 payload 接近 20MB API 限制时告警，提示执行 /compact。临时方案，待官方修复后可移除。 |
| Telegram time awareness |
telegram |
在 Telegram reply tool call 前注入当前本地时间，避免主动推送/回复缺少时间上下文。 |
| Server |
Plugin |
Runtime |
说明 |
cdp-chrome |
chrome |
Claude + Codex bundled；Hermes config-driven |
Claude/Codex 通过插件本地 MCP 配置启动 launcher，读取当前用户 cdp-chrome.port/profile_dir 并校验监听者；Hermes 通过 mcp_servers.cdp-chrome 手动注册。每个 OS 用户应使用自己的端口和 profile，并运行 doctor.sh 验证。 |
telegram-notify |
telegram |
Claude Code only |
轻量级 Telegram 通知服务，供 agent 发送消息。 |
| 脚本 |
说明 |
agent-switch |
切换本机 agent CLI 账号。当前支持 Codex：agent-switch 与 agent-switch codex 等价，显示当前 live auth 账号和账号快照列表，共享 ~/.codex 配置、skills、sessions，仅切换账号认证快照；agent-switch codex logout 保存当前账号并移除 live auth，便于重新 codex login；切换前检查 Codex CLI、Codex.app 和 codex-acp 进程，--force 可先结束这些进程再继续。agent-switch install 一键 symlink 到 ~/.local/bin。 |
chrome-instances |
管理 macOS 上的多 Chrome 实例。列出所有实例及其 Profile/窗口，按 PID 或名称聚焦窗口。通过 AppleScript 解析窗口标题，无需调试端口。chrome-instances install 一键 symlink 到 ~/.local/bin。 |
agent-steroids/
INSTALL.md # 唯一安装手册：给 human/agent 安装时读取
.agents/plugins/ # Codex marketplace 配置（只列跨运行时 skill 插件）
.claude-plugin/ # Claude marketplace 配置（列全部插件）
steroids/ # Hermes shim：agent-steroids/steroids
chrome/ # Hermes shim：agent-steroids/chrome
scripts/ # 独立 CLI 工具
plugins/
steroids/ # 主体 skills 和通用 commands
telegram/ # Telegram skill/commands/MCP/hooks（含 guard-payload-size）
chrome/ # cdp-chrome provider（含 Claude/Codex MCP launcher 配置）
write-blog/ # 写作流程 skill（Claude Code only）
taskdag/ # ADR + Task DAG 控制面（Claude + Codex）
wechat/ # 微信本地聊天记录解密读取（Claude + Codex，仅 macOS）
docs/
tech/ # 技术方案和架构设计
research/ # 调研、对比分析
MIT