菜单
Integrates moox/audit activity logging into Moox consumer packages (config, ServiceProvider, Filament, hooks, tests). Use when the user says moox/audit, moox-audit, protokolieren, auditieren, activity log, or names a package to audit (e.g. moox/tag, tag package).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Add, enable, or start using a package in a monorepo-consuming Laravel project — both Moox monorepo packages (moox/*) and the project's own packages. Use this skill whenever the user wants to "add a package", "enable moox/X", "use the X package", "pull in X from the monorepo", "neues Package hinzufügen", "Package aktivieren", or references wanting a new moox/* or own package available in the app. It performs the full, error-prone sequence (devlink config, composer.json path entry WITH the required versions option, package list export, composer update, verification, commit) so the dev doesn't do it by hand and doesn't hit the dev-dev/route-cache pitfalls. Trigger this proactively even if the user only names a package and an intent to use it.
Integrates moox/tree into Moox consumer packages (installation, Filament assets, TreeIndexConfiguration, forwardFromResource, TreeIndexListRecords, RendersAsTreeIndexInspector, Filament plugin). Use only when the user explicitly invokes moox-tree skill or asks to integrate moox/tree into a resource.
基于 SOC 职业分类
| name | moox-audit |
| description | Integrates moox/audit activity logging into Moox consumer packages (config, ServiceProvider, Filament, hooks, tests). Use when the user says moox/audit, moox-audit, protokolieren, auditieren, activity log, or names a package to audit (e.g. moox/tag, tag package). |
Config-driven activity logging via moox/audit. Consumer packages declare an audit block in package config and register it in the ServiceProvider. No model traits and no Eloquent changes on models for standard CRUD tracking.
Canonical package docs: packages/audit/README.md
Gold-standard consumer: packages/category (config/category.php, CategoryServiceProvider).
| User intent | Action |
|---|---|
| "Nutze skill moox/audit und protokolieren moox/tag" | Follow integration.md for packages/tag |
| "Audit für {package}" / "protokolieren {package}" | Same workflow for packages/{package} |
| Install audit in an app | composer require moox/audit + php artisan mooxaudit:install (see package README) |
| App-only model tracking | Published config/audit.php models section (no package registry) |
| Custom lifecycle event | Hook or MooxActivityLogger::log() — see decisions.md |
Copy and track:
- [ ] 1. Inspect target package (models, translations, resource, delete side-effects)
- [ ] 2. Add `audit` block to `packages/{pkg}/config/{pkg}.php`
- [ ] 3. Register in `{Pkg}ServiceProvider::packageBooted()` via AuditPackageRegistry
- [ ] 4. Decide hooks (pivot detach on delete?) — decisions.md
- [ ] 5. Add/adjust Pest tests when behavior is new or non-trivial
- [ ] 6. Run package tests + `composer lint` / `composer analyse` if touched from monorepo root
Do not add moox/audit to the consumer package's composer.json require. Use class_exists(AuditPackageRegistry::class) so the package works without audit installed.
use Moox\Audit\Support\AuditPackageRegistry;
// in packageBooted():
if (class_exists(AuditPackageRegistry::class) && config('audit.enabled', true)) {
AuditPackageRegistry::register('{package_key}', config('{package_key}.audit', []));
}
{package_key} matches the config file name (category, tag, …).
Three sections under {package}.audit:
| Section | Purpose |
|---|---|
models | Per-model tracking: preset, log_name, attributes |
hooks | Custom events (e.g. pivot detach on deleting) |
filament | Activity tab on resources + aggregate_subjects for translations |
Presets (draft_main, draft_translation) live in config/audit.php. See decisions.md for attribute selection and hooks.
When filament is registered, AuditBootstrap adds the Activity relation manager automatically. No manual getRelations() change unless you need loose coupling — see package README.
After integrating audit into a consumer package, add tests when you introduce hooks or non-default config. Run:
php vendor/bin/pest --configuration=packages/{pkg}/phpunit.xml packages/{pkg}/tests
Audit package tests (reference):
php vendor/bin/pest --configuration=packages/audit/phpunit.xml packages/audit/tests/Unit