webman-skill

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

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

覆盖内容

采用渐进式披露：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

# 非交互安装到指定 Agent
npx skills add zjkal/webman-skill -g -a cursor -y
npx 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 Code
git 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

贡献

欢迎 PR：

1. 保持 SKILL.md 精简（约 500 行以内），深度内容放 references/。
2. 代码示例遵循 declare(strict_types=1) 与 webman 官方 API。
3. 新增主题时在 SKILL.md 的 References 章节补充链接（引用保持一层深度）。
4. 同步更新 README.md 与 README.en.md。

License

MIT

仓库地址: https://github.com/zjkal/webman-skill