drogon-claude-plugin 0.3.0__py3-none-any.whl

drogon_claude_plugin-0.3.0.dist-info/METADATA

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: drogon-claude-plugin
+Version: 0.3.0
+Summary: Drogon C++ backend Claude Code plugin - rules & code generation skills, plus a CLI installer (install/verify/uninstall)
+Author: voidvec
+License: MIT License
+        
+        Copyright (c) 2026 vilas
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/voidvec/drogon-claude-plugin
+Project-URL: Repository, https://github.com/voidvec/drogon-claude-plugin
+Project-URL: Documentation, https://github.com/voidvec/drogon-claude-plugin#readme
+Project-URL: Changelog, https://github.com/voidvec/drogon-claude-plugin/blob/main/CHANGELOG.md
+Keywords: drogon,claude-code,claude,plugin,cpp,c++,async,web-framework,backend
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8
+License-File: LICENSE
+Dynamic: license-file
+
+# drogon-claude-plugin
+
+> **Drogon C++ 后端开发的 Claude Code 插件** — 提供 AI 辅助开发规则与代码生成技能，让 AI 写出正确的异步代码，避开回调/事件循环等高频陷阱。
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![PyPI version](https://img.shields.io/pypi/v/drogon-claude-plugin.svg)](https://pypi.org/project/drogon-claude-plugin/)
+[![npm version](https://img.shields.io/npm/v/drogon-claude-plugin.svg)](https://www.npmjs.com/package/drogon-claude-plugin)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-8A2BE2)](https://docs.anthropic.com/en/docs/claude-code/plugins)
+
+基于 [Drogon](https://github.com/drogonframework/drogon) C++ HTTP 框架的应用项目提供 **AI 辅助开发规则与代码生成技能**，让 AI 写出正确的异步代码，避开回调/事件循环等高频陷阱。
+
+## 安装
+
+### 方式 A：通过 marketplace（推荐）
+
+```bash
+# 添加 marketplace 源（首次）
+claude plugin marketplace add https://github.com/voidvec/drogon-claude-plugin
+
+# 安装插件
+claude plugin install drogon
+
+# 更新到最新版
+claude plugin update drogon
+```
+
+### 方式 B：通过 npm / PyPI（CLI 安装器）
+
+```bash
+# npm
+npx drogon-claude-plugin install
+
+# 或 PyPI
+pipx install drogon-claude-plugin
+drogon-plugin install
+```
+
+> 两种包共用同一份插件资产，CLI 提供 `install` / `verify` / `uninstall` 子命令，详见 [CLI 安装器](#--cli-安装器)。
+
+### 方式 C：本地安装
+
+```bash
+git clone https://github.com/voidvec/drogon-claude-plugin
+cd <你的 drogon 项目>
+claude plugin install ../drogon-claude-plugin --scope project
+```
+
+### 验证安装
+
+```bash
+claude plugin details drogon
+```
+
+应显示 17 个技能和 2 个钩子（SessionStart + PostToolUse）。
+
+## CLI 安装器
+
+`drogon-claude-plugin` 同时发布到 [npm](https://www.npmjs.com/package/drogon-claude-plugin) 与 [PyPI](https://pypi.org/project/drogon-claude-plugin/)，两种包内置同一份插件资产（skills / hooks / CLAUDE.md / .claude-plugin），并提供一致的命令行界面（bin 名均为 `drogon-plugin`）：
+
+| 命令 | 作用 |
+|------|------|
+| `drogon-plugin install [--scope project\|user\|local]` | 将插件资产拷贝到当前项目（或指定 scope），并提示执行 `claude plugin install` 启用 |
+| `drogon-plugin verify` | 校验插件的技能数 / 钩子 / manifest，输出结构报告 |
+| `drogon-plugin uninstall` | 从当前项目（或由 `--target` 指定目录）移除已安装的插件资产 |
+| `drogon-plugin version` | 显示 CLI 与内置插件版本 |
+
+安装器只负责**分发与落盘**，不替换 Claude Code 官方插件机制——启用插件仍走 `claude plugin install`。
+
+## 功能组件
+
+### 规则层（CLAUDE.md，自动注入会话上下文）
+
+CLAUDE.md 采用**精简路由**设计：只保留跨所有任务的顶层纪律（异步回调模型、事件循环模型）+ Skill 路由表，**详细知识（模板、API 速查、配置格式、禁止模式）全部下沉到各 Skill 的 `references/code-guide.md` 按需加载**，避免常驻占用上下文。
+
+顶层纪律覆盖：
+
+- **A 异步回调模型**：回调恰好一次、按值捕获、禁阻塞、优先协程、异常安全
+- **B 事件循环模型（Trantor IO）**：不阻塞循环、重活走线程池、跨循环共享状态加锁
+- **通用纪律**：所有 I/O 异步、异步操作双回调、异常不逃逸 handler、配置加载 try/catch、键名严格
+
+### 代码生成技能（17 个）
+
+每个技能提供准确的 drogon API 用法、代码模板与常犯错误警告。遇到对应任务时 AI 主动调用，按需加载详细知识：
+
+| 技能 | 用途 |
+|------|------|
+| `drogon-create-controller` | 生成控制器（Simple/Http/WebSocket），含路径前缀差异、`:param`、自动注册 |
+| `drogon-gen-cmake` | 生成 CMakeLists.txt，含 Conan、插件过滤器编译 |
+| `drogon-gen-csp-view` | 生成 CSP 视图模板，含 `drogon_ctl create view` 管线、布局 |
+| `drogon-gen-db-config` | 生成数据库配置，含键名黑名单、SQL 注入防护、运行期异常 |
+| `drogon-gen-filter` | 生成 Filter 请求拦截器 |
+| `drogon-gen-middleware` | 生成 Middleware 处理链 |
+| `drogon-gen-plugin` | 生成 Plugin 系统级扩展（连接池/SDK 初始化），含三者职责边界 |
+| `drogon-gen-orm-crud` | 生成 ORM CRUD 代码，含禁 `execSqlSync`、事务纪律 |
+| `drogon-gen-redis-config` | 生成 Redis 配置 + 单例/异步/订阅防泄漏用法 |
+| `drogon-gen-test` | 生成 DROGON_TEST 测试，含断言宏、CMake 扫描 |
+| `drogon-setup-config` | 生成完整配置文件，含路径解析、键名黑名单、多环境 |
+| `drogon-gen-session-auth` | 生成 Session 登录/登出/鉴权 handler（防 fixation） |
+| `drogon-gen-file-upload` | 生成文件上传 handler（MultiPartParser + 校验 + 落盘） |
+| `drogon-gen-advice` | 生成 AOP Advice（11 切面，拦截型/观察型） |
+| `drogon-gen-coroutine-handler` | 生成协程 handler/中间件/ORM（参数按值，区分 Task/AsyncTask，含 `forwardCoro`） |
+| `drogon-gen-http-client` | 生成出站 HttpClient 调用（异步/协程/反向代理） |
+| `drogon-gen-lambda-handler` | 生成 `registerHandler` lambda 路由（`{N}` 参数绑定） |
+
+### 自动化检测钩子（PostToolUse）
+
+在 AI 编辑文件后自动扫描 drogon API 违规：
+
+| 文件类型 | 检测项 |
+|---------|--------|
+| `.h/.cc/.cpp` | `FILTER_ADD`、`ADD_MIDDLEWARE`、`METHOD_LIST_ADD`、`createDbClient`、`AsyncTask`+`co_await` 未兜异常、回调式 `HttpMiddleware` 内 `co_await`、同步 `sendRequest` 死锁、`session->operator[]`、Advice 在 handler 内注册 |
+| `.csp` | `{{ }}`、`<%raw%>`、`<%viewpath`、`@@key@@`、`<%extends`、`{% if %}` |
+| `config.json/.yaml` | `"password"`、`"username"`、`"ssl": "字符串"` |
+| `test*.cc` | `done()`、`ASSERT_*`、`createDbClient` |
+
+> 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
+├── 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](LICENSE)。

drogon_claude_plugin-0.3.0.dist-info/RECORD

@@ -0,0 +1,47 @@
+drogon_claude_plugin-0.3.0.dist-info/licenses/LICENSE,sha256=E2o-EZob6-Kbr0fPGfYyaAnrHo1H4nGKVz_C2PPa6X4,1062
+drogon_plugin/__init__.py,sha256=2uMpIQkZPxIe5yoi5rwNWmeuA9D5nNWgOwo7HILorO4,441
+drogon_plugin/cli.py,sha256=EFNg_0s4Dr6hca_rLRLwyv-59op_BbPW1p40qxa2fvs,9739
+drogon_plugin/drogon_plugin_assets/CLAUDE.md,sha256=9OriEgNNTF77YXPDjQIPOwmODX2Ab7DvB2TvLblraXU,6158
+drogon_plugin/drogon_plugin_assets/.claude-plugin/marketplace.json,sha256=yFH-s0CPa-OKUMy0l_ZqnNMh5bMbvZP7wDAvdw2RrIQ,510
+drogon_plugin/drogon_plugin_assets/.claude-plugin/plugin.json,sha256=1OKm2w4U5UWtRhsepzm03BsFCxcPOig-e6VN2foqR-M,532
+drogon_plugin/drogon_plugin_assets/hooks/hooks.json,sha256=I8Vr7tVDrneB1625W-mZZnlxV8cFzfVlE-yez2UblHU,788
+drogon_plugin/drogon_plugin_assets/hooks/posttooluse.py,sha256=QXDRMl1Pa-m66eHzbCshjb580UfudRbeibpbrZg3bOU,10712
+drogon_plugin/drogon_plugin_assets/skills/drogon-create-controller/SKILL.md,sha256=wuxCK9hYSpjygkqGXFmmRfmlbJwaq8XFxLemuHqEfOk,1312
+drogon_plugin/drogon_plugin_assets/skills/drogon-create-controller/references/code-guide.md,sha256=X0ryMDgiUANy1LfZXqZmSi-psyjPFAriC1bbjlETVs8,5035
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-advice/SKILL.md,sha256=nl-RoTr8XlPj2oqicWZHQAf788Z-y7X7XS-pSfoYe8E,1326
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-advice/references/code-guide.md,sha256=twL3eNW9g81yjAPXXOzp1Q5LSpNldbCH5DC0Z3hv4nQ,3892
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-cmake/SKILL.md,sha256=Swmiiwr1szakyEKDuokDTw4RZkU9oa8w2o-0qw7dqwQ,1427
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-cmake/references/code-guide.md,sha256=hybW-JE5SIeP8T6uIiJKHncZCiXX9iYO9CFIK817kUE,2828
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-coroutine-handler/SKILL.md,sha256=k0xxBvvc5pXZKRpZu19C2-s5a1Ym1twsY3HjD75T1aY,1343
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-coroutine-handler/references/code-guide.md,sha256=FqfqSVK7x87iQVMj8qbajc247h0XZoe4peg6sYdCj5M,4640
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-csp-view/SKILL.md,sha256=rprklOqjjpo7aTGD9tVMYIRVM15DF3RReVSgyKkQXBI,1206
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-csp-view/references/code-guide.md,sha256=_BNLapApISwmb4DnSDHmjEKGo3fFyDqiGoYMFLLrXg0,5175
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-db-config/SKILL.md,sha256=al_zNncgrxzGLat5IsAdBqEz5pzSKrsZnrv5mRwZuDg,1208
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-db-config/references/code-guide.md,sha256=-kA9-nPdT7B0r6F0rkqEJ1rpPaiEoO95ZdNSoLPpuEc,2657
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-file-upload/SKILL.md,sha256=jC3_i-Vcms-WlAvKJnxGnC0zu5Ylh-4w8voCYGcbCpA,1218
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-file-upload/references/code-guide.md,sha256=ODZR1lEW43TsP0XvJYfzIkRUhZc2vZ8k9VQX4kQy4P4,3262
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-filter/SKILL.md,sha256=iTpxnfLkhf8ockum7mcdfQo8C-safQNyUc6M5Egh8Qs,1036
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-filter/references/code-guide.md,sha256=p3XOWNNSRqSumuWbXoACjFnS38QgB4CTHCnYHP9onCI,3418
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-http-client/SKILL.md,sha256=mnXsslpNbkmrj5-Dyy9yS6w_MQd8O7opsfgSH9cAXJ8,1197
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-http-client/references/code-guide.md,sha256=jdYPnzkOgsAudMQVUUTKIXxisFikSt3heTYF_yLv7MQ,3441
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-lambda-handler/SKILL.md,sha256=Af4NRAkHByT9Yv-i-1lfqG6wy2jEJObVtbXIZFeYlhg,1378
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-lambda-handler/references/code-guide.md,sha256=EX-oyiYGO76HQuCQlxl9p6e8yoNs3KGBu-g_slxHOK0,2894
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-middleware/SKILL.md,sha256=iozXWR1CFaiHMyYvlm0V9oMbV9uZMzrD2pzJlEzjb3I,1118
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-middleware/references/code-guide.md,sha256=WS55ZGqseq8lfXtumX4QC0ovyj7WFLsUhqnD2GVDs0g,4086
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-orm-crud/SKILL.md,sha256=ZM3n1byjbrpRuAe1eUgT6iYumoZ5-Rew8VDMk_RVYos,1302
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-orm-crud/references/code-guide.md,sha256=KjGYQASqFnQFK1lgwe8agFZOJPBlHEcs4MR4YZCyZCQ,4719
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-plugin/SKILL.md,sha256=CUUqaKAAoh6Y2yLoGYYfdx_yVdmIosySyHplK1vB9Aw,1563
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-plugin/references/code-guide.md,sha256=llXyC1X9gp0HiSTBw-dS8rnln9c8vnS6a2XuhR3ACB8,4107
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-redis-config/SKILL.md,sha256=TNiIosp3ZVFcTRfGOqyNO31w6POEJoOqRzUQfa9HyAk,1152
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-redis-config/references/code-guide.md,sha256=hV8CqB0EdHxPAN3OxK4n_HWjWcLJwDcGJ53yyQAveJY,2383
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-session-auth/SKILL.md,sha256=kYZWl3GdAQZU7DysZfL3zxOmOMvQ2yvgMgoxfXiu2Xs,1123
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-session-auth/references/code-guide.md,sha256=D29beh-ezXbVb5ViwQOm--shdnL_7PSPXZz5nLX0r6A,3659
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-test/SKILL.md,sha256=hzsHWRe_hf5ecNoR0GJ-ffda5uUHhDqeuX5Pr06PM-g,1069
+drogon_plugin/drogon_plugin_assets/skills/drogon-gen-test/references/code-guide.md,sha256=xQKT_J7GK6v4rgS1fie6olzHtmIlYWnvl1sqGHtJ9HI,4307
+drogon_plugin/drogon_plugin_assets/skills/drogon-setup-config/SKILL.md,sha256=jDGle2Iz0xuJNMpK8_y93hhxm5ltVkUcTW7M0guwsHA,1343
+drogon_plugin/drogon_plugin_assets/skills/drogon-setup-config/references/code-guide.md,sha256=aM3wnP2Nz1BoQTRdpo3dI0EgJxOwuY3SB-fyT94jpeo,3367
+drogon_claude_plugin-0.3.0.dist-info/METADATA,sha256=P3HS_Mb9Fq-R2lf0uudOjR_mpHGz3jtKBislCS1au1I,10907
+drogon_claude_plugin-0.3.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+drogon_claude_plugin-0.3.0.dist-info/entry_points.txt,sha256=MhGQaOkZZM0AOfbAy1N34bvJlQiUP1mBGlkIh0BnKXg,57
+drogon_claude_plugin-0.3.0.dist-info/top_level.txt,sha256=QkQoQI6GWLObEOjIBcfWqubEa0ts7LSFfZCkYwtc12Y,14
+drogon_claude_plugin-0.3.0.dist-info/RECORD,,

drogon_claude_plugin-0.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

drogon_claude_plugin-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+drogon-plugin = drogon_plugin.cli:main

drogon_claude_plugin-0.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vilas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

drogon_claude_plugin-0.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+drogon_plugin

drogon_plugin/__init__.py

@@ -0,0 +1,14 @@
+"""drogon-claude-plugin — PyPI 发行包（CLI 安装器）.
+
+本包将 drogon Claude Code 插件的完整资产（skills / hooks / CLAUDE.md /
+.claude-plugin）一并打包进 wheel，通过 `drogon-plugin` 命令安装到目标项目。
+
+插件本体仓库: https://github.com/voidvec/drogon-claude-plugin
+"""
+
+__version__ = "0.3.0"
+
+# 打包进 wheel 的插件资产
+PLUGIN_VERSION = "0.3.0"
+
+__all__ = ["__version__", "PLUGIN_VERSION"]

drogon_plugin/cli.py

@@ -0,0 +1,307 @@
+#!/usr/bin/env python3
+"""drogon-plugin — CLI 安装器（PyPI 发行版）.
+
+把随包内置的 drogon Claude Code 插件资产安装到目标项目并提示启用，
+或对已安装目录做结构校验 / 卸载。
+
+子命令:
+  install   [--target DIR] [--scope project|user|local]
+  verify    [--target DIR]
+  uninstall [--target DIR]
+  version
+"""
+
+import argparse
+import json
+import shutil
+import sys
+from pathlib import Path
+
+# 资产在 wheel 内统一放在 ``drogon_plugin_assets/`` 下（见 pyproject.toml data-files）
+_ASSETS_PREFIX = "drogon_plugin_assets"
+_PLUGIN_ASSET_DIRS = ("skills", "hooks", ".claude-plugin")
+_PLUGIN_FILES = ("CLAUDE.md",)
+_EXPECTED_SKILLS = 17
+_EXPECTED_HOOKS = 2
+
+# scope 目录名映射（Claude Code 约定）
+_SCOPE_DIRS = {
+    "user": Path.home() / ".claude" / "plugins",
+    "local": Path.home() / ".claude" / "plugins",
+    "project": None,  # 项目根（默认）
+}
+
+_PKG_VERSION: str | None = None
+
+
+def _version() -> str:
+    """返回已安装发行包的版本；源码树运行时返回 unknown。"""
+    global _PKG_VERSION
+    if _PKG_VERSION is None:
+        try:
+            from importlib.metadata import version
+
+            _PKG_VERSION = version("drogon-claude-plugin")
+        except Exception:
+            _PKG_VERSION = "dev"
+    return _PKG_VERSION
+
+
+def _find_assets() -> Path:
+    """定位随包携带的插件资产根目录。"""
+    here = Path(__file__).resolve().parent
+    dev_candidate = here / _ASSETS_PREFIX  # src/drogon_plugin/drogon_plugin_assets/
+    if dev_candidate.is_dir():
+        return dev_candidate
+    # wheel 布局: site-packages/drogon_plugin/drogon_plugin_assets/
+    return here / _ASSETS_PREFIX
+
+
+# ---------------------------------------------------------------------------
+# 资产复制 / 管理
+# ---------------------------------------------------------------------------
+
+
+def _list_assets(root: Path):
+    return (p for p in root.rglob("*") if p.is_file())
+
+
+def _copy_assets(src_root: Path, target_root: Path) -> int:
+    """把 src_root 下所有资产复制到 target_root，返回文件数。"""
+    count = 0
+    for f in _list_assets(src_root):
+        rel = f.relative_to(src_root)
+        dest = target_root / rel
+        dest.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(f, dest)
+        count += 1
+    return count
+
+
+def _load_manifest(target_root: Path) -> dict:
+    p = target_root / ".claude-plugin" / "plugin.json"
+    if not p.is_file():
+        raise FileNotFoundError(f"缺少插件清单: {p}")
+    return json.loads(p.read_text(encoding="utf-8"))
+
+
+def _plugin_version(target_root: Path) -> str:
+    return str(_load_manifest(target_root).get("version", "?"))
+
+
+def _resolve_target(args) -> Path:
+    """子命令用: --target > --scope > 当前目录。"""
+    if args.target:
+        return Path(args.target).expanduser().resolve()
+    if getattr(args, "scope", None):
+        if args.scope == "project":
+            return Path.cwd().resolve()
+        d = _SCOPE_DIRS.get(args.scope)
+        if d:
+            return d.resolve()
+    return Path.cwd().resolve()
+
+
+# ---------------------------------------------------------------------------
+# 子命令
+# ---------------------------------------------------------------------------
+
+
+def cmd_install(args) -> int:
+    from . import PLUGIN_VERSION
+
+    target = _resolve_target(args)
+    try:
+        src_root = _find_assets()
+        if not src_root.is_dir():
+            raise FileNotFoundError(
+                f"未找到插件资产目录（{src_root}）。请确认包安装完整。"
+            )
+        count = _copy_assets(src_root, target)
+    except FileNotFoundError as e:
+        print(f"❌ {e}", file=sys.stderr)
+        return 1
+
+    stamp = target / ".drogon-plugin-installed.json"
+    try:
+        manifest_version = _plugin_version(target)
+    except FileNotFoundError:
+        manifest_version = PLUGIN_VERSION
+    stamp.write_text(
+        json.dumps(
+            {
+                "source": "pypi:drogon-claude-plugin",
+                "cli_version": _version(),
+                "plugin_version": manifest_version,
+                "files": count,
+            },
+            indent=2,
+        ),
+        encoding="utf-8",
+    )
+
+    print(f"✅ 已安装 drogon 插件资产到 {target}")
+    print(f"   复制 {count} 个文件 · 插件版本 {manifest_version}")
+    print("   下一步:")
+    print("     1) cd <你的 drogon 项目>")
+    print("     2) claude plugin install ../drogon-claude-plugin --scope project")
+    print("       （或如果已通过 marketplace 添加: claude plugin install drogon）")
+    return 0
+
+
+def cmd_verify(args) -> int:
+    target = _resolve_target(args)
+    try:
+        manifest = _load_manifest(target)
+    except FileNotFoundError as e:
+        print(f"❌ {e}", file=sys.stderr)
+        return 1
+
+    manifest_ver = str(manifest.get("version", "?"))
+    problems: list[str] = []
+    skill_names: list[str] = []
+
+    # 技能
+    skills_dir = target / "skills"
+    if not skills_dir.is_dir():
+        problems.append("缺少 skills/ 目录")
+    else:
+        skill_names = sorted(
+            d.name for d in skills_dir.iterdir() if d.is_dir()
+        )
+        if len(skill_names) != _EXPECTED_SKILLS:
+            problems.append(f"技能数 {len(skill_names)} != 预期 {_EXPECTED_SKILLS}")
+        for n in skill_names:
+            if not (skills_dir / n / "SKILL.md").is_file():
+                problems.append(f"技能 {n} 缺少 SKILL.md")
+
+    # hooks
+    hooks_dir = target / "hooks"
+    if not hooks_dir.is_dir():
+        problems.append("缺少 hooks/ 目录")
+    else:
+        hooks_json = hooks_dir / "hooks.json"
+        if not hooks_json.is_file():
+            problems.append("缺少 hooks/hooks.json")
+        else:
+            try:
+                data = json.loads(hooks_json.read_text(encoding="utf-8"))
+                n = len(data.get("hooks", {}))
+                if n != _EXPECTED_HOOKS:
+                    problems.append(f"hooks 数 {n} != 预期 {_EXPECTED_HOOKS}")
+            except json.JSONDecodeError:
+                problems.append("hooks/hooks.json 不是合法 JSON")
+
+        if not (hooks_dir / "posttooluse.py").is_file():
+            problems.append("缺少 hooks/posttooluse.py")
+
+    # CLAUDE.md
+    if not (target / "CLAUDE.md").is_file():
+        problems.append("缺少 CLAUDE.md")
+
+    # 版本一致性
+    try:
+        from . import PLUGIN_VERSION
+
+        if manifest_ver := manifest.get("version"):
+            if str(manifest_ver) != PLUGIN_VERSION:
+                problems.append(
+                    f"manifest 版本 {manifest_ver} 与包版本 {PLUGIN_VERSION} 不一致"
+                )
+    except ImportError:
+        pass
+
+    print(f"📦 drogon-claude-plugin 结构校验 — {target}")
+    print(f"   插件版本 : {manifest_ver}")
+    print(f"   技能数   : {len(skill_names)}")
+    print(f"   hooks    : {_EXPECTED_HOOKS} (SessionStart + PostToolUse)")
+    if problems:
+        print("   ❌ 发现问题:")
+        for p in problems:
+            print(f"      - {p}")
+        return 1
+    print("   ✅ 通过")
+    return 0
+
+
+def cmd_uninstall(args) -> int:
+    target = _resolve_target(args)
+    removed: list[str] = []
+    for name in (*_PLUGIN_ASSET_DIRS, *_PLUGIN_FILES):
+        p = target / name
+        if p.is_dir() and not p.is_symlink():
+            shutil.rmtree(p)
+            removed.append(name)
+        elif p.is_file():
+            p.unlink()
+            removed.append(name)
+    stamp = target / ".drogon-plugin-installed.json"
+    if stamp.is_file():
+        stamp.unlink()
+        removed.append(".drogon-plugin-installed.json")
+
+    if removed:
+        print(f"🗑  已从 {target} 移除: {', '.join(removed)}")
+    else:
+        print(f"ℹ️   未在 {target} 发现插件资产")
+    return 0
+
+
+def cmd_version(args) -> int:
+    try:
+        from . import PLUGIN_VERSION
+    except ImportError:
+        PLUGIN_VERSION = "?"
+    print(f"drogon-claude-plugin (pypi) v{_version()} | 内置插件 v{PLUGIN_VERSION}")
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# 入口
+# ---------------------------------------------------------------------------
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="drogon-plugin",
+        description="安装 / 校验 / 卸载 drogon Claude Code 插件资产（PyPI 发行版）。",
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_install = sub.add_parser("install", help="安装插件资产到目标项目")
+    p_install.add_argument("--target")
+    p_install.add_argument("--scope", choices=["project", "user", "local"])
+    p_install.set_defaults(func=cmd_install)
+
+    p_verify = sub.add_parser("verify", help="校验已安装插件结构")
+    p_verify.add_argument("--target")
+    p_verify.set_defaults(func=cmd_verify)
+
+    p_uninstall = sub.add_parser("uninstall", help="移除已安装插件资产")
+    p_uninstall.add_argument("--target")
+    p_uninstall.set_defaults(func=cmd_uninstall)
+
+    sub.add_parser("version", help="显示版本").set_defaults(func=cmd_version)
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+
+    if not hasattr(args, "func"):
+        parser.print_help()
+        return 0
+
+    # 只有需要目标路径的子命令才设置 target
+    if getattr(args, "func", None) in (cmd_install, cmd_verify, cmd_uninstall):
+        args.target = _resolve_target(args)
+
+    try:
+        return args.func(args)
+    except KeyboardInterrupt:
+        return 130
+
+
+if __name__ == "__main__":
+    sys.exit(main())

drogon_plugin/drogon_plugin_assets/.claude-plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "name": "drogon-claude-plugin",
+  "description": "Drogon C++ framework Claude Code plugin — rules and skills for correct async code generation",
+  "owner": {
+    "name": "voidvec"
+  },
+  "plugins": [
+    {
+      "name": "drogon",
+      "source": ".",
+      "description": "Drogon C++ 后端开发规则与技能: 基于 Drogon 框架编写正确的异步代码, 避开回调/事件循环等高频陷阱。",
+      "author": {
+        "name": "voidvec"
+      },
+      "category": "development"
+    }
+  ]
+}