webman-skill: 给 AI 编码助手装上webman专业知识

AI摘要
【知识分享】该内容介绍了一个面向AI编码助手的webman框架专用技能包,包含核心心智模型、路由控制器、中间件、数据库Redis、协程、内存生命周期等主题的参考文档,支持通过skills CLI或手动方式安装到Cursor、Claude Code等70多种Agent工具,适用于webman 1.5+/2.x及PHP 8.0+环境,采用渐进式披露机制按需加载文档以节省上下文。

面向AI编码助手的 webman 框架专用技能

覆盖内容

文件 主题
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.mdreferences/)为英文,便于模型稳定执行;description 中保留中文触发词(如「常驻内存 PHP」「协程 PHP」)。

安装

推荐用 skills CLI 一键安装(无需克隆仓库),支持 Cursor、Claude Code、Codex、OpenCode、GitHub Copilot 等 70+ Agent

# 全局安装(所有项目可用;CLI 会检测本机已安装的 Agent)
npx skills add zjkal/webman-skill -g

# 仅安装到当前项目
npx skills add zjkal/webman-skill

# 非交互安装到指定 Agent(可多次传 -a)
npx skills add zjkal/webman-skill -g -a claude-code -y
npx skills add zjkal/webman-skill -g -a codex -y
npx skills add zjkal/webman-skill -g -a cursor -y
npx skills add zjkal/webman-skill -g -a opencode -y
npx skills add zjkal/webman-skill -g -a github-copilot -y
npx skills add zjkal/webman-skill -g -a gemini-cli -y
npx skills add zjkal/webman-skill -g -a windsurf -y
npx skills add zjkal/webman-skill -g -a cline -y
npx skills add zjkal/webman-skill -g -a trae -y
npx skills add zjkal/webman-skill -g -a continue -y

# 一次安装到多个 Agent
npx skills add zjkal/webman-skill -g -a cursor -a claude-code -a codex -y

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

手动安装(备选)

将仓库克隆到对应 Agent 的 skills 目录(目录名使用技能名 webman):

Agent --agent 全局路径 项目路径
Cursor cursor ~/.cursor/skills/webman .agents/skills/webman
Claude Code claude-code ~/.claude/skills/webman .claude/skills/webman
Codex codex ~/.codex/skills/webman .agents/skills/webman
OpenCode opencode ~/.config/opencode/skills/webman .agents/skills/webman
GitHub Copilot github-copilot ~/.copilot/skills/webman .agents/skills/webman
Gemini CLI gemini-cli ~/.gemini/skills/webman .agents/skills/webman
Windsurf windsurf ~/.codeium/windsurf/skills/webman .windsurf/skills/webman
Cline cline ~/.agents/skills/webman .agents/skills/webman
Trae trae ~/.trae/skills/webman .trae/skills/webman
Continue continue ~/.continue/skills/webman .continue/skills/webman
Amp / Universal amp / universal ~/.config/agents/skills/webman .agents/skills/webman

# 示例:Claude Code(全局)
git clone https://github.com/zjkal/webman-skill ~/.claude/skills/webman

# 示例:Codex(全局)
git clone https://github.com/zjkal/webman-skill ~/.codex/skills/webman

# 示例:Cursor(全局)
git clone https://github.com/zjkal/webman-skill ~/.cursor/skills/webman

# 示例:OpenCode(全局)
git clone https://github.com/zjkal/webman-skill ~/.config/opencode/skills/webman

# 示例:GitHub Copilot(全局)
git clone https://github.com/zjkal/webman-skill ~/.copilot/skills/webman

# 示例:项目级(Cursor / Codex / Copilot / Gemini CLI 等共用 .agents/skills)
git clone https://github.com/zjkal/webman-skill .agents/skills/webman

Windows(PowerShell)示例:

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

完整 Agent 列表与路径见 skills CLI Supported Agents

安装后无需额外配置。当对话涉及 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

License

MIT

本作品采用《CC 协议》,转载必须注明作者和本文链接
讨论数量: 0
(= ̄ω ̄=)··· 暂无内容!

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!