drogon-claude-plugin

Drogon C++ 后端开发的 Claude Code 插件 — 提供 AI 辅助开发规则与代码生成技能，让 AI 写出正确的异步代码，避开回调/事件循环等高频陷阱。

基于 Drogon C++ HTTP 框架的应用项目提供 AI 辅助开发规则与代码生成技能，让 AI 写出正确的异步代码，避开回调/事件循环等高频陷阱。

安装

方式 A：通过 marketplace（推荐）

# 添加 marketplace 源（首次）
claude plugin marketplace add https://github.com/voidvec/drogon-claude-plugin

# 安装插件
claude plugin install drogon

# 更新到最新版
claude plugin update drogon

方式 B：通过 npm / PyPI（CLI 安装器）

npm 与 PyPI 两种包内置同一份插件资产，bin 名均为 drogon-claude-plugin，提供 install / verify / uninstall / version 子命令。无需提前克隆本仓库。

# npm（免安装，直接跑）
npx drogon-claude-plugin install

# 或 PyPI（推荐，可持久使用）
pipx install drogon-claude-plugin
drogon-claude-plugin install

安装器只负责分发与落盘，不替换 Claude Code 官方插件机制——启用插件仍走 claude plugin install（安装器会在安装成功后提示你执行）。

方式 C：本地安装

git clone https://github.com/voidvec/drogon-claude-plugin
cd <你的 drogon 项目>
claude plugin install ../drogon-claude-plugin --scope project

验证安装

claude plugin details drogon

应显示 17 个技能和 2 个钩子（SessionStart + PostToolUse）。

CLI 安装器

drogon-claude-plugin 同时发布到 npm 与 PyPI。两种包都内置同一份插件资产（skills / hooks / CLAUDE.md / .claude-plugin），并提供一致的命令行界面：

CLI 的典型用法

# 在 drogon 项目根目录执行
npx drogon-claude-plugin install     # npm 免安装方式
drogon-claude-plugin install                # 已安装 pipx/npm -g 后

drogon-claude-plugin verify                 # 确认 17 技能 + 2 钩子全部到位
drogon-claude-plugin uninstall              # 移除插件资产（不会动你的代码）

功能组件

插件由三层组成，各司其职：

规则层（CLAUDE.md，自动注入会话上下文）

CLAUDE.md 采用精简路由设计：只保留跨所有任务的顶层纪律（异步回调模型、事件循环模型）+ Skill 路由表，详细知识（模板、API 速查、配置格式、禁止模式）全部下沉到各 Skill 的 references/code-guide.md 按需加载，避免常驻占用上下文。

顶层纪律覆盖：

• A 异步回调模型：回调恰好一次、按值捕获、禁阻塞、优先协程、异常安全
• B 事件循环模型（Trantor IO）：不阻塞循环、重活走线程池、跨循环共享状态加锁
• 通用纪律：所有 I/O 异步、异步操作双回调、异常不逃逸 handler、配置加载 try/catch、键名严格

代码生成技能（17 个）

每个技能提供准确的 drogon API 用法、代码模板与常犯错误警告。遇到对应任务时 AI 主动调用，按需加载详细知识：

自动化检测钩子（PostToolUse）

在 AI 编辑文件后自动扫描 drogon API 违规：

v0.2.0 修复：C++ 标识符检测改为大小写敏感（不再误报 isDone()）；移除与 CLAUDE.md 示例冲突的 callback 变量名硬约束。

使用

在 drogon 项目中启用插件后，AI 自动生效。典型对话：

> 创建一个 /api/users 的 REST 控制器
AI: [使用 drogon-create-controller 技能] 生成 UserController.h/.cc...

> 添加一个 JWT 认证过滤器
AI: [使用 drogon-gen-filter 技能] 生成 JwtAuthFilter.h + registerFilter()...

> 写一个测试验证用户注册接口
AI: [使用 drogon-gen-test 技能] 生成 DROGON_TEST(UserRegister)...

> 这个 handler 代码有问题吗？
AI: [对照 CLAUDE.md 异步回调纪律] 这个 handler 的提前返回路径没有调用 callback...

前提

• Claude Code CLI 已安装
• 插件用于 依赖 drogon 框架的应用项目（drogon 本身作为库被安装）
• Python 3 在 PATH 中（PostToolUse 钩子需要）

仓库结构

├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .github/workflows/
│   ├── ci.yml              # 插件结构/CLI 冒烟测试
│   └── publish.yml         # tag 触发 → PyPI + npm + GitHub Release
├── scripts/                  # 构建辅助（资产同步 + 冒烟测试）
│   ├── sync-assets.py/.mjs   # 同步 skills/hooks/CLAUDE.md 到 npm 与 PyPI 包
│   └── dev-smoke-test.py/.mjs
├── hooks/
│   ├── hooks.json
│   └── posttooluse.py
├── src/drogon_plugin/        # PyPI 包（CLI 安装器）
│   ├── __init__.py
│   └── cli.py
├── npm/                      # npm 包（CLI 安装器）
│   ├── package.json
│   └── bin/cli.js
├── skills/
│   ├── drogon-create-controller/
│   ├── drogon-gen-advice/
│   ├── drogon-gen-cmake/
│   ├── drogon-gen-coroutine-handler/
│   ├── drogon-gen-csp-view/
│   ├── drogon-gen-db-config/
│   ├── drogon-gen-file-upload/
│   ├── drogon-gen-filter/
│   ├── drogon-gen-http-client/
│   ├── drogon-gen-lambda-handler/
│   ├── drogon-gen-middleware/
│   ├── drogon-gen-orm-crud/
│   ├── drogon-gen-plugin/
│   ├── drogon-gen-redis-config/
│   ├── drogon-gen-session-auth/
│   ├── drogon-gen-test/
│   └── drogon-setup-config/
├── CLAUDE.md
├── LICENSE
├── README.md
└── pyproject.toml           # PyPI 打包配置

许可

MIT — 详见 LICENSE。