drogon-claude-plugin Skill 技能

技能简介

drogon-claude-plugin 是一款专为 Drogon C++ HTTP 框架打造的编程 Agent 插件，由 voidvec 开发，支持 Claude Code 与 ZCode 双宿主。它用一条命令把 22 个代码生成技能、2 个自动化检测钩子以及顶层开发纪律装进你的项目，帮助 AI Agent 为 Drogon 编写「正确的异步代码」——主动避开回调地狱、事件循环等 C++ 后端开发中的高频陷阱。插件在 Windows / Linux / macOS 全平台可用，安装时绝不触碰项目自有文件。

核心能力

• 22 个 Drogon 代码生成技能：覆盖 Drogon 后端开发的常见场景，直接为 Agent 注入框架级最佳实践。
• 2 个自动化检测钩子：内置 SessionStart 与 PostToolUse 钩子（跨平台启动器），在会话开始时注入纪律、在工具调用后自动检查。
• 顶层开发纪律（CLAUDE.md）：把 Drogon 开发规范作为顶层规则装进项目，约束 Agent 的编码行为。
• 多宿主支持：npm CLI 提供 Claude Code / ZCode 双宿主 bundle 安装；多宿主安装（codex / cursor / copilot / gemini / qoder / codebuddy / trae / agents）与 scan 由 PyPI CLI 提供。
• 结构化校验：verify 可校验已安装插件的结构（技能数、钩子、清单、版本一致性）。
• 安全卸载：uninstall 逐项归属校验，绝不误删业务代码。
• 隔离安装：资产装入 /.drogon-plugin/，绝不触碰项目自有文件。

安装配置

1. 全局安装（推荐）：npm install -g drogon-claude-plugin。
2. 免安装直跑：npx drogon-claude-plugin install。
3. 多宿主 CLI（参考实现）：pipx install drogon-claude-plugin，用于 codex / cursor / copilot 等宿主与 scan 功能。
4. Claude Code 启用：claude plugin install .drogon-plugin --scope project，或走 marketplace：claude plugin marketplace add https://github.com/voidvec/drogon-claude-plugin 后 claude plugin install drogon。
5. ZCode 启用：在插件管理中添加 marketplace 地址并安装 drogon 插件。
6. 包内含资产：assets/ 下含 skills/（22 个技能）、hooks/、CLAUDE.md、.claude-plugin/ / .zcode-plugin/ 清单，与 GitHub 仓库同步。

使用步骤

1. 通过 npm install -g drogon-claude-plugin 或 npx 安装插件。
2. 在项目目录执行 drogon-claude-plugin install，把插件资产装入 /.drogon-plugin/。
3. 用 drogon-claude-plugin verify 校验已安装插件结构的完整性（技能数 / 钩子 / 清单 / 版本一致性）。
4. 通过宿主官方机制启用插件——Claude Code 用 claude plugin install，ZCode 在插件管理中添加 marketplace。
5. 在 Claude Code / ZCode 中开始编写 Drogon 异步代码，技能与钩子会自动生效。
6. 需要卸载时执行 drogon-claude-plugin uninstall，逐项归属校验、不误删业务代码。

适用场景

• 使用 C++ Drogon 框架开发 HTTP 后端的团队与个人。
• 希望用 AI Agent 生成正确异步代码、规避回调/事件循环陷阱的开发者。
• 同时使用 Claude Code 与 ZCode 双宿主的工程环境。
• 需要把框架级开发纪律与自动化检查固化进项目的团队。
• 在 Windows / Linux / macOS 上都需要统一体验的跨平台开发。

适用人群

• C++ 后端工程师与 Drogon 框架使用者；
• 用 AI 编程助手做 C++ 服务端开发的开发者；
• 需要为团队统一 Drogon 编码规范与 AI 行为的技术负责人。

工作原理

drogon-claude-plugin 以「插件资产包 + 宿主原生机制」的方式工作：npm 包内置完整插件资产（22 个技能、2 个钩子、CLAUDE.md 与插件清单），安装器把资产复制到项目本地 .drogon-plugin/ 目录，再通过宿主的插件机制注册启用。钩子分为 SessionStart（会话启动时注入顶层开发纪律）与 PostToolUse（工具调用后自动检测），由跨平台启动器执行。插件刻意与项目自有文件解耦：install 只写入插件目录，verify 做结构校验，uninstall 做逐项归属校验后安全移除，从而在不干扰业务代码的前提下为 Agent 提供 Drogon 专用的代码生成与纪律约束能力。

官方链接

• npm 包：https://www.npmjs.com/package/drogon-claude-plugin
• GitHub 仓库：https://github.com/voidvec/drogon-claude-plugin
• Drogon 框架：https://github.com/drogonframework/drogon