{
  "markdown": "# Webman Development Skill\n\n[简体中文](README.zh-CN.md)\n\nSource-grounded guidance for developing, reviewing, debugging, testing, and deploying [Webman](https://www.workerman.net/doc/webman/) applications. It helps coding agents use Webman's controller, routing, validation, data, process, coroutine, plugin, and production practices without treating a long-lived Workerman process like an ordinary PHP-FPM application.\n\n## Install\n\nChoose **one** of the following methods. Run project-scoped commands from the root of the Webman project that should use the Skill.\n\n### 1. Ask your coding agent (recommended)\n\nGive Codex, Claude Code, or another Skill-aware coding agent this prompt:\n\n```text\nInstall the webman-development Skill from https://github.com/webman-php/skills\nfor this project. Keep the complete skill directory, use your native Skill installer\nwhen available, and verify that the installed SKILL.md is discoverable.\n```\n\nThe agent should use its native Skill installer or one of the explicit methods below.\n\n### 2. Composer\n\nThis option needs PHP and Composer, but does not need Node.js, PowerShell, or `webman/console`:\n\n```bash\ncomposer require --dev webman/skills\nphp vendor/bin/webman-skills install --agents=codex,claude-code\n```\n\nUse `--agents=codex` or `--agents=claude-code` to install for only one agent. Add `--global` to install in the current user's Skill directories instead of the current project. The installer refuses to overwrite an unmanaged same-name directory; inspect it first, or use `--force` to preserve it as a backup before installing.\n\n### 3. npx\n\nIf Node.js is available:\n\n```bash\nnpx skills add webman-php/skills --skill webman-development -a codex -a claude-code\n```\n\nKeep only the required `-a` option to target one agent. Add `--copy` when independent copied files are preferable to linked entries.\n\n### 4. Manual installation\n\nClone or download the repository:\n\n```bash\ngit clone --depth 1 https://github.com/webman-php/skills.git webman-skills\n```\n\nCopy the complete `webman-skills/skills/webman-development/` directory to one of these locations:\n\n| Scope | Codex | Claude Code |\n|---|---|---|\n| Project | `.agents/skills/webman-development/` | `.claude/skills/webman-development/` |\n| Current user | `~/.agents/skills/webman-development/` | `~/.claude/skills/webman-development/` |\n\nDo not copy only `SKILL.md`: the on-demand `references/` are part of the Skill.\n\n### Update\n\nUse the update path that matches the chosen installation method:\n\n```bash\n# Composer\ncomposer update webman/skills\nphp vendor/bin/webman-skills update --agents=codex,claude-code\n\n# npx\nnpx skills update webman-development\n\n# Git clone/manual copy\ngit -C webman-skills pull --ff-only\n```\n\nAfter a manual source update, replace only the verified `webman-development` copy; never delete an entire `.agents` or `.claude` directory.\n\n## Use\n\nThe skill can activate automatically for a matching Webman task. To call it explicitly:\n\n```text\n# Codex\n$webman-development add a POST endpoint with typed route parameters and validation\n\n# Claude Code\nUse the webman-development skill to add a POST endpoint with typed route parameters and validation.\n```\n\n## What it covers\n\n- The resident-process model and cross-request state safety.\n- Controllers as the primary entry point: typed parameter binding, HTTP method and route attributes, request injection, validation, middleware, and `make:crud` routing.\n- Request/response helpers, uploads, routing, CORS/OPTIONS, middleware scopes, and access-control boundaries.\n- `webman/validation` plus `webman/console` generators, only after checking the installed packages and command help.\n- Eloquent/ThinkORM-compatible data access, transactions, cache and Redis without reproducing their entire upstream manuals.\n- Queues, custom processes, coroutines, plugins, deployment, observability, security, and proportionate verification.\n\nThe entry point keeps only routing and important invariants. Detailed API recipes live in `references/` and are loaded only for the task that needs them.\n\n## Repository layout\n\n```text\nskills/\n  webman-development/\n    SKILL.md\n    agents/openai.yaml       # optional Codex/ChatGPT UI metadata\n    references/              # task-specific Webman guidance\n```\n\nThis follows the open Agent Skills directory convention. The shared `SKILL.md` and references are portable; editors that do not recognize `agents/openai.yaml` can ignore it.\n\n## Contributing and verification\n\nKeep changes scoped to a documented Webman behavior and preserve progressive disclosure: put routing and durable constraints in `SKILL.md`, and put detailed, conditional guidance in a focused reference. Before submitting a change, validate the YAML frontmatter, relative Markdown links, and that an installer discovers exactly one `webman-development` skill.\n\nFor the current installation locations and discovery behavior, use the official [Codex Skills documentation](https://developers.openai.com/codex/skills/) and [Claude Code Skills documentation](https://code.claude.com/docs/en/skills).\n",
  "bytes": 5047,
  "sha": "5a0a3973fcfe6e4b4a724b4016d13dd80aa862fca5a5641b2446020b03e2588d",
  "repo_slug": "webman-php/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_webman_php_skills_webman_development_40e1d1c1/readme"
}