面向 AI 助手的 Webman 常驻内存 PHP 开发技能

大家好，我是小皮。

面向 AI 编码助手（Cursor / Claude Code 等支持 Agent Skills 的工具）的 webman 框架专用技能。

webman 是基于 workerman 的高性能常驻内存 PHP 框架。它与 PHP-FPM 的运行模型截然不同，通用 PHP 知识直接套用会产出带有内存泄漏、状态污染、exit 杀进程等隐患的代码。本技能把 webman 的运行模型、API 约定和最佳实践注入给 AI 助手，让其生成符合常驻内存语义的代码。

项目地址：https://github.com/zjkal/webman-skill

覆盖内容

文件	主题
`SKILL.md`	核心心智模型、项目结构、常用命令、Do/Don't 速查
`references/routing-controller.md`	路由、控制器、Request/Response、Session、参数校验、统一异常
`references/middleware.md`	中间件洋葱模型、鉴权、CORS、路由中间件传参
`references/database-redis.md`	illuminate/database、Eloquent、事务、分页、Redis、缓存、连接池
`references/custom-process.md`	自定义进程、WebSocket/TCP、Timer、Crontab、队列、进程间推送
`references/coroutine.md`	webman v2 协程：eventLoop 驱动、Context、并发原语、连接池守则
`references/memory-lifecycle.md`	生命周期、内存泄漏四大来源、状态污染、reload 生效范围
`references/plugin.md`	基础插件与应用插件的开发、发布

采用渐进式披露：AI 平时只加载简短的 SKILL.md，遇到具体主题再按需读取 references/ 下的对应文档，不浪费上下文。

说明：技能正文（SKILL.md 与 references/）为英文，便于模型稳定执行；description 中保留中文触发词（如「常驻内存 PHP」「协程 PHP」）。

安装

推荐用 skills CLI 一键安装（无需克隆仓库），支持 Cursor、Claude Code 等多种 Agent：

# 全局安装（所有项目可用）npx skills add zjkal/webman-skill -g# 仅安装到当前项目npx skills add zjkal/webman-skill# 非交互安装到指定 Agentnpx skills add zjkal/webman-skill -g -a cursor -ynpx skills add zjkal/webman-skill -g -a claude-code -y

也可在 skills.sh 浏览该技能。

手动安装（备选）

# Cursor — 个人技能git clone https://github.com/zjkal/webman-skill ~/.cursor/skills/webman# Cursor — 项目技能git clone https://github.com/zjkal/webman-skill .cursor/skills/webman# Claude Codegit clone https://github.com/zjkal/webman-skill ~/.claude/skills/webman

Windows（PowerShell）：

git clone https://github.com/zjkal/webman-skill "$env:USERPROFILE\.cursor\skills\webman"

安装后无需额外配置。当对话涉及 webman / workerman / 常驻内存 PHP 等主题时，AI 会自动应用该技能；也可在 Cursor 中通过 @webman 或 /webman 显式调用。

适用版本

webman 1.5+ / 2.x（协程相关内容仅适用 2.x）
PHP 8.0+（v2 需 8.1+）
数据库示例基于 webman/database（illuminate），并附 think-orm 说明

目录结构

webman-skill/├── SKILL.md              # 技能入口（含 frontmatter 元数据）├── references/           # 分主题深度参考，按需加载│   ├── routing-controller.md│   ├── middleware.md│   ├── database-redis.md│   ├── custom-process.md│   ├── coroutine.md│   ├── memory-lifecycle.md│   └── plugin.md├── README.md             # 简体中文（默认）├── README.en.md          # English└── LICENSE

感谢大家阅读，个人观点仅供参考，欢迎在评论区发表不同观点。

欢迎关注、分享、点赞、收藏、在看，我是微信公众号「PHP驿站」作者小皮。