interserver

Creates a new command module in server/commands/ following the { match(text, lcText, deps), execute(matchResult, deps) } shape used by all 21 existing modules. Use when user says 'add command', 'new bot command', 'add !something', 'create handler for X message', or when adding files to server/commands/. Handles admin-gate (ima !== 'admin'), deps destructuring, MessageFactory.text replies, registration in server/commands/index.js, and the required match() test in test/commands.test.js. Do NOT use for OAuth dialog logic (use bot-dialog skill), adaptive-card JSON authoring (use adaptive-card skill), card-submit handler routing changes inside TeamsActivityHandler (use bot-activity-handler skill), or editing the dispatcher in server/commands/index.js itself.

Writes node:test tests for the Teams Chat Bot. Use when user says 'add test', 'write a node:test', 'mock the consumer', 'test the queue', or creates files in test/*.test.js. Provides the canonical mock setup: `_setInternalsForTest({ redis, redisBot, adapter })` seam, hash-map-backed Redis mock with hget/hset/incr/pipeline/expire/lrem, adapter mock recording _calls[] with sentActivities/updatedActivities, NOTIF_TRACE_LOG=0 silencing, and beforeEach/after restoration. Do NOT use for Jest, Mocha, or Codeception — this project is strictly `node:test`.

Builds and enqueues notification envelopes onto Redis `notif:queue` in the canonical v=1 shape `{ v, id, ts, expires_at, room, type:'msg', message|card, extra:{ dedup_key, event_type, repo, _commit_sha, data }, fallback_webhook_url? }`. Covers channel resolution via `CHANNELS`, GitHub `dedup_key` auto-injection (`github:commit:{sha7}` / `github:pr:{repo}:{n}` / `github:issue:{repo}:{n}`), edit-window coalescing (`NOTIF_EDIT_WINDOW_MS`, 30 min), trackable batch-merge via `handleTrackableBatch`, announce-redirect via `decideAnnounceRedirect`, and dead-letter on `notif:dead`. Use when user says 'enqueue notification', 'queue a notification', 'add webhook event', 'send to notif queue', or modifies `server/queue/notificationConsumer.js`, `server/queue/filters.js`, `server/queue/channels.js`, or an external producer. Do NOT use for synchronous proactive sends via `POST /api/message` (those bypass the queue) or for daily-recap cards (`POST /api/dailyrecap` has its own pipeline).

Debugs notification-grouping bugs via `scripts/replay-notif.js` reading `.logs/notif-trace-YYYY-MM-DD.jsonl`. Covers `--mode timeline|grouped|raw`, filters (`--dedup`, `--commit`, `--room`, `--tick`, `--event`, `--kind`, `--since/--until`, `--activity`), and signature kinds (`recent_lookup`, `edit_skipped_no_convref`, `edit_fell_through`, `recent_saved`, `announce_redirect`, `batch_merge`, `batch_skipped`). Use when user reports 'commits not grouping', 'new message instead of edit', 'trace this dedup key', 'why did this fall through', or asks to inspect `notif:queue` historical behavior. Do NOT use for live-queue admin (use `!notif status`/`drain-dead`) or for non-queue bug investigation.

Expert knowledge for Azure AI Bot Service development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Azure AI bots with Direct Line/Web Chat, Teams/SMS channels, OAuth/SSO, skills, or proactive messages, and other Azure AI Bot Service related development tasks. Not for Azure Health Bot (use azure-health-bot), Azure Functions (use azure-functions), Azure App Service (use azure-app-service), Azure Logic Apps (use azure-logic-apps).

Optimize MongoDB client connection configuration (pools, timeouts, patterns) for any supported driver language. Use this skill when working/updating/reviewing on functions that instantiate or configure a MongoDB client (eg, when calling `connect()`), configuring connection pools, troubleshooting connection errors (ECONNREFUSED, timeouts, pool exhaustion), optimizing performance issues related to connections. This includes scenarios like building serverless functions with MongoDB, creating API endpoints that use MongoDB, optimizing high-traffic MongoDB applications, creating long-running tasks and concurrency, or debugging connection-related failures.

Help with MongoDB query optimization and indexing. Use only when the user asks for optimization or performance: "How do I optimize this query?", "How do I index this?", "Why is this query slow?", "Can you fix my slow queries?", "What are the slow queries on my cluster?", etc. Do not invoke for general MongoDB query writing unless user asks for performance or index help. Prefer indexing as optimization strategy. Use MongoDB MCP when available.

MongoDB schema design patterns and anti-patterns. Use when designing data models, reviewing schemas, migrating from SQL, or troubleshooting performance issues caused by schema problems. Triggers on "design schema", "embed vs reference", "MongoDB data model", "schema review", "unbounded arrays", "one-to-many", "tree structure", "16MB limit", "schema validation", "JSON Schema", "time series", "schema migration", "polymorphic", "TTL", "data lifecycle", "archive", "index explosion", "unnecessary indexes", "approximation pattern", "document versioning".

Applies per-VPS bandwidth limits using tc/HTB and ebtables following patterns in `tclimit`, `limitbw`, and `run_buildebtables.sh`. Handles vnet interface detection, HTB qdiscs, /tools/bandwidth/{id}/ flag files, and ebtables FORWARD rules. Use when asked to 'set bandwidth limit', 'apply tc rules', 'update ebtables', or run `limitbw`. Do NOT use for OpenVZ/venet traffic shaping (see `vzopenvztc.sh` which uses CBQ, not HTB).

Provisions a new KVM VPS: LVM or ZFS volume creation via vps_kvm_lvmcreate.sh, libvirt XML config from windows.xml, DHCP entry in dhcpd.vps, VNC setup via provirted.phar, and ebtables rebuild via run_buildebtables.sh. Use when asked to 'create a VPS', 'provision KVM', 'add a new VM', or modify install scripts. Do NOT use for LXD, OpenVZ, or Virtuozzo provisioning.

PHP 8.x modern patterns, PSR standards, and SOLID principles. Use when reviewing PHP code, checking type safety, auditing code quality, or ensuring PHP best practices. Triggers on "review PHP", "check PHP code", "audit PHP", or "PHP best practices".

Use when building PHP applications with modern PHP 8.3+ features, Laravel, or Symfony frameworks. Invokes strict typing, PHPStan level 9, async patterns with Swoole, and PSR standards. Creates controllers, configures middleware, generates migrations, writes PHPUnit/Pest tests, defines typed DTOs and value objects, sets up dependency injection, and scaffolds REST/GraphQL APIs. Use when working with Eloquent, Doctrine, Composer, Psalm, ReactPHP, or any PHP API development.

Expert in strict POSIX sh scripting for maximum portability across Unix-like systems. Specializes in shell scripts that run on any POSIX-compliant shell (dash, ash, sh, bash --posix).

Adds or extends a `provirted.phar cron` subcommand invocation in `vps_cron.sh` or `qs_cron.sh`. Understands the cron lock pattern (`/dev/shm/lock`), age-based stale-check with `.cron.age`, `.enable_workerman` flag, and log append to `cron.output`. Use when asked to 'add a cron step', 'schedule a task', 'run something in the vps cron', or modify `vps_cron.sh`/`qs_cron.sh`. Do NOT use for workerman timer-based tasks (setupTimers.php).

Manages libvirt storage pools and LVM/ZFS volumes following create_libvirt_storage_pools.sh and vps_kvm_lvmcreate.sh patterns. Handles virsh pool-define-as, lvcreate/zfs create, pool autostart, and vz pool detection logic. Use when asked to 'create storage pool', 'add LVM volume', 'setup ZFS', or work with /dev/vz/. Do NOT use for image installation, DHCP changes, or network configuration.

Adds a new Workerman event handler or background task following the closure patterns in workerman/src/Events/ and workerman/src/Tasks/. Handles timer registration in setupTimers.php, message routing in onMessage.php, and closure-based stdObject methods. Use when asked to 'add a workerman handler', 'new event', 'background task', or modify workerman/src/. Do NOT use for worker process config (workerman/src/Workers/).

Creates a new Composer command extending BaseCommand in src/Command/, registers it in CommandProvider.php, and scaffolds a matching PHPUnit test. Use when user says 'add command', 'new composer command', 'create myadmin command'. Do NOT use for modifying existing commands or non-command classes.

Adds a new MyAdmin package type to Installer.php supports() and configures install path routing. Use when user says 'add package type', 'support new type', 'new installer type', 'add myadmin- type'. Do NOT use for changing existing type behavior or modifying TemplateInstaller standalone logic.

Writes PHPUnit 9 tests following the project's ReflectionClass-based pattern. Uses newInstanceWithoutConstructor() stubs, tests interface implementation, method visibility, and parameter counts. Use when user says 'add tests', 'write test', 'test coverage for'. Do NOT use for running existing tests.

Creates a new test event fixture directory under tests/events/{event_name}/ with payload.json, type.txt, and expected_text.txt. Use when user says 'add test for X event', 'create fixture', 'test event payload', or needs to add files to tests/events/. Do NOT use for modifying existing fixtures or writing unit tests that don't involve GitHub webhook payloads.

Adds a new GitHub event type case to the switch block in `web/github.php`. Handles extracting fields from `$Message`, building a `$ChatMsg` string with markdown links, setting `$Msg['text']`, and calling `SendToChat('notifications', $Msg, $useRC, $useTeams)`. Use when user says 'add support for X event', 'handle X webhook', 'new event type', or adds a case to `web/github.php`. Do NOT use for modifying existing event handlers.

Formats dual Rocket Chat + MS Teams notification messages following the project's emoji+markdown style. Builds $Msg with avatar/alias/text keys, [User](url) links, repo links, branch backticks, and action emojis (📦 push, 🐛 issues, 🔀 PR, 📝 wiki, ✅/❌ CI). Calls SendToChat('notifications', $Msg, $useRC, $useTeams). Use when user says 'format message', 'notification style', 'chat output', or is writing a new event handler case. Do NOT use for changing SendToChat() itself or src/GithubWebhook.php.