大家期待已久的 Webman 官方 Skill，终于来了！

对于经常使用 Codex、Claude Code 这类 AI 编程工具开发 Webman 项目的开发者，本次发布的 Webman Skill 非常实用。

这是面向 Webman 的开发、代码审查、故障排查、单元测试、项目部署的 AI 编辑器 Skill。
它可以让 AI Agent 遵循 Webman 真实运行模型进行编码，包含控制器、路由、参数验证、数据访问、异步进程、协程、插件以及生产环境各项约束；避免把常驻内存的 Workerman 进程，错误当作普通 PHP‑FPM 项目处理。

安装

以下方式任选其一即可。项目级安装，请在 Webman 项目根目录执行命令。

1. AI 自动安装（推荐）

直接把下面提示发给 Codex / Claude Code 或其他支持 Skill 的 AI 编程 Agent：

请从 https://github.com/webman-php/skills 为当前项目安装
webman-development Skill。优先使用你内置的 Skill 安装能力，保留完整目录，
并在安装后确认 SKILL.md 已被发现。

AI 会优先使用内置 Skill 安装能力；如果不支持，选用下面手动安装方案。

2. Composer 安装

仅依赖 PHP + Composer，无需 Node.js、PowerShell、webman/console

composer require --dev webman/skills
php vendor/bin/webman-skills install --agents=codex,claude-code

• 只给单个 Agent 安装：--agents=codex 或 --agents=claude-code
• 增加 --global：安装到用户全局目录，而非当前项目
• 安装器不会覆盖同名目录；强制覆盖增加 --force，原有目录会自动备份

3. npx 安装

本地已具备 Node.js 环境时使用

npx skills add webman-php/skills --skill webman-development -a codex -a claude-code

• 只安装单个 Agent，保留一个 -a 参数即可
• --copy：生成独立副本，不使用软链接

4. 手动安装

克隆仓库，或者在 GitHub 下载 ZIP 解压

git clone --depth 1 https://github.com/webman-php/skills.git webman-skills

把 webman-skills/skills/webman-development/ 完整复制到对应目录，必须连同 references 目录，不能只复制 SKILL.md

更新

根据当初的安装方式执行更新：

# Composer 方式
composer update webman/skills
php vendor/bin/webman-skills update --agents=codex,claude-code

# npx 方式
npx skills update webman-development

# Git / 手动复制
git -C webman-skills pull --ff-only

手动更新时，仅替换 webman-development，不要直接删除整个 .agents / .claude 目录。

使用

当任务涉及 Webman 相关开发，Skill 会自动加载；也可以手动显式调用：

# Codex
$webman-development 新增一个带类型路由参数与验证的 POST 接口

# Claude Code
使用 webman-development skill 新增一个带类型路由参数与验证的 POST 接口。

Skill 能力覆盖范围

• 常驻内存、多进程运行模型，跨请求状态污染防护
• 控制器：类型参数绑定、路由Attribute、Request注入、参数验证、中间件、make:crud
• 请求响应、文件上传、路由、CORS、中间件作用域、鉴权逻辑
• webman/validation、webman/console 脚手架命令
• Eloquent / ThinkORM 数据访问、事务、缓存、Redis
• 消息队列、自定义进程、协程、插件、部署、可观测性、安全校验

SKILL.md 存放通用规则与约束；详细API参考存放在 references/，AI 在需要时按需读取。

目录结构

skills/
  webman-development/
    SKILL.md
    agents/openai.yaml       # Codex 元数据（可选）
    references/              # Webman 参考文档库

遵循开放 Agent Skills 目录规范。agents/openai.yaml 仅 OpenAI 系编辑器识别，其他工具可直接忽略。

维护与校验

• 所有规则需要有 Webman 官方文档或源码作为依据
• 原则：通用约束写进 SKILL.md，场景化细节放在 references
• 提交前校验 YAML 头、Markdown 相对链接，保证环境只识别一份 webman-development

加载规则以官方文档为准：
Codex Skills：https://developers.openai.com/codex/skills/
Claude Skills：https://code.claude.com/docs/en/skills