Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

code-assessment

/code-assessment

Wykrywa, przegląda i naprawia problemy jakości i poprawności kodu w projekcie AEM as a Cloud Service lokalnie: Java, Sling Models, OSGi i Maven, bez usług zewnętrznych.

Repozytorium
skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
24.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
60
Skrypty
24
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 24 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: remove-deprecated-api/scripts/detect.sh, scripts/analyze.sh, scripts/analyzer/Analyze.java, scripts/analyzer/Corpus.java, scripts/analyzer/Detector.java, scripts/analyzer/Finding.java, scripts/analyzer/JavaUnit.java, scripts/analyzer/OsgiUnit.java

Co robi i kiedy

Wykrywa, przegląda i naprawia problemy jakości i poprawności kodu w projekcie AEM as a Cloud Service lokalnie: Java, Sling Models, OSGi i Maven, bez usług zewnętrznych.

Wyzwalacze z opisu

check my Sling Models are implemented correctlyreview my @Inject usageare my Maven dependencies up to datescan this AEM project for issuesmodernize my Sling Modelsfix code-quality problems
Oryginalny opis (EN)

Detect, review, and fix code-quality and correctness issues in an AEM as a Cloud Service project — locally, with no external services or network calls. Use whenever a user wants to check, review, assess, audit, scan, modernize, upgrade, or fix AEM Java, Sling Models, OSGi, or Maven code — for example: "check my Sling Models are implemented correctly", "review my @Inject usage", "are my Maven dependencies up to date", "scan this AEM project for issues", "modernize my Sling Models", or "fix code-quality problems". Name the files to assess, or ask it to scan the repo; it detects issues, plans, an

Jak działa

  1. Findings sources
  2. Routing
  3. Manual Pattern Hints (classification → expert skill)
  4. Invocation from the migration skill
  5. Runbook
  6. One pattern per session
  7. Critical rules
  8. Scope & limitations
  9. Adding a new pattern
  10. Related skills
Sekcje z nagłówków SKILL.md, w oryginale · 134 linii, 1 324 słów
Podgląd SKILL.md
---
name: code-assessment
description: |
  Detect, review, and fix code-quality and correctness issues in an AEM as a Cloud Service
  project — locally, with no external services or network calls. Use whenever a user wants to
  check, review, assess, audit, scan, modernize, upgrade, or fix AEM Java, Sling Models, OSGi,
  or Maven code — for example: "check my Sling Models are implemented correctly", "review my
  @Inject usage", "are my Maven dependencies up to date", "scan this AEM project for issues",
  "modernize my Sling Models", or "fix code-quality problems". Name the files to assess, or ask
  it to scan the repo; it detects issues, plans, and — only when you ask — applies surgical
  edits on a branch or in place, then verifies with mvn compile. It recognises the intent and
  handles each issue type itself, reporting anything it cannot yet fix.
license: Apache-2.0
---

# AEM as a Cloud Service — Code Assessment

Single skill for detecting and fixing AEM CS code-quality issues, **entirely against the local workspace** — no external services or network calls. Findings reach the runbook from one of two sources; everything downstream is identical.

## Findings sources

| Source | When | Target versions (deps) |
|---|---|---|
| **User-named** | the user names files or coordinates | user-supplied |
| **Discover** | the user asks to scan, or names no files | user-supplied (per the pattern's resolution contract) |

Discovery runs through the deterministic **analyzer** ([`scripts/analyze.sh`](scripts/README.md)):
it parses the workspace once and runs the enabled detectors, emitting the shared findings shape.
Every `ready` pattern has an analyzer detector. One detector — `remove-deprecated-api` — loads
its rules dynamically from a preflight-produced cache
([`remove-deprecated-api/scripts/detect.sh`](remove-deprecated-api/scripts/detect.sh) runs the
AEM Analyser Maven Plugin and writes the cache TSV before the analyzer is invoked); the
detector's shape and integration are otherwise identical. Patterns without a detector are
`planned` only — not yet detectable and not yet built; there is **no LLM-scan fallback** in this
version (see Scope & limitations) — the `scan` value on `planned` rows in
[`references/patterns.md`](references/patterns.md) marks the intended future detection method,
not an active code path.

## Routing

1. **User named files / coordinates** → run the runbook in `with_findings` mode against those paths.
2. **"Scan my repo" / no files named** → run the runbook in `discover` mode (per-pattern Discovery, workspace roots only).

Then follow the runbook: [`references/runbook.md`](references/runbook.md).

## Manual Pattern Hints (classification → expert skill)

Route the request to one expert skill. Two pattern families share this skill:

**Mechanical fixes** (analyzer-driven detection, deterministic edits — follow the runbook flow):

| User said / saw | Expert skill |
|---|---|
| "update aem sdk", "upgrade mockito", stale `<version>` or `${property}` in pom | [`outdated-dependencies/`](outdated-dependencies/SKILL.md) |
| "fix @Inject", "modernize Sling Models", `javax.inject.Inject` on `@Model` fields | [`inject-in-sling-model/`](inject-in-sling-model/SKILL.md) |
| "add HTTP timeouts", "outbound/external call has no timeout", `HttpClient` / `HttpClients` / `OkHttpClient` built without a timeout | [`outbound-call-timeouts/`](outbound-call-timeouts/SKILL.md) |
| "bound my query", "unbounded query", "query causing OOM", `p.limit=-1`, `setLimit(-1)` | [`unbounded-query/`](unbounded-query/SKILL.md) |
| "query is slow", "traversal warning", "is my query indexed", "tune oak index", index coverage of a JCR/Oak query | [`tuning-oak-query-indexes/`](tuning-oak-query-indexes/SKILL.md) |
| "remove deprecated API", "fix deprecated imports", "Cloud Manager deprecated API failure", `region-deprecated-api` / `api-regions-check` / `Import-Package not satisfied` pipeline failures, log4j migration, commons-lang/collections upgrades, deprecated Maven deps, unmodifiable OSGi configs | [`remove-deprecated-api/`](remove-deprecated-api/SKILL.md) _(analyzer detector with dynamic rules — preflight runs `aemanalyser-maven-plugin`; hint-driven fixes; see recipe.md)_ |

**Architectural migration patterns** (guided remediation — full before/after, troubleshooting, modern alternatives; invoked directly or via `migration` for BPA/CAM-driven discovery):

| User said / saw | Expert skill | BPA pattern ID |
|---|---|---|
| `org.apache.sling.commons.scheduler.Scheduler` or `scheduler.schedule(` with `Runnable` | [`scheduler/`](scheduler/SKILL.md) | `scheduler` |
| `implements ResourceChangeListener`, lightweight listener + JobConsumer | [`resource-change-listener/`](resource-change-listener/SKILL.md) | `resourceChangeListener` |
| `com.day.cq.replication.Replicator`, `org.apache.sling.replication.*`, "publish/preview activation" | [`replication/`](replication/SKILL.md) | `replication` |
| `javax.jcr.observation.EventListener`, `org.osgi.service.event.EventHandler` on non-resource topics (replication, workflow, custom) | [`event-migration/`](event-migration/SKILL.md) | `eventListener` / `eventHandler` |
| `com.day.cq.dam.api.AssetManager` create/upload/delete APIs, `createAssetForBinary`, `removeAssetForBinary` | [`asset-manager/`](asset-manager/SKILL.md) | `assetApi` |
| HTL build warning `data-sly-test: redundant constant value comparison` | [`references/data-sly-test-redundant-constant.md`](references/data-sly-test-redundant-constant.md) | `htlLint` (reference, no expert skill subdirectory) |

**Broad / correctness-review asks** ("check my Sling Models are implemented correctly", "review my code", "is my AEM project healthy", "assess this project") are not a single pattern: run the runbook in `discover` mode with intent `report` — the analyzer runs every detector and the report covers all built patterns, explicitly noting aspects not yet supported. Only narrow to one pattern when the user targets a specific fix.

If nothing matches, say the issue is not yet supported and offer to file a request for a new expert skill.

**Full catalog** (built + `planned` patterns, with severity / detection / fix): [`references/patterns.md`](references/patterns.md).

## Invocation from the `migration` skill

`migration` performs BPA/CAM/MCP discovery and handles batching + one-pattern-per-session workflow. After it has identified `(pattern, file)` pairs from BPA findings, it hands off here for the actual transformation. When invoked with `(pattern, file)` from `migration`:

- **Skip** HA/analyzer discovery (caller already identified the pattern + file)
- Open the pattern's expert skill directly (per the Manual Pattern Hints table above)
- Apply the steps in the expert skill against the named file(s)
- Return the result; `migration` continues with the next finding in its batch

The pattern guides themselves are agnostic about who invoked them — they apply identically whether reached from `migration` (BPA/CAM) or from the runbook in this skill (HA / analyzer).

## Runbook

All detection, planning, edits, verification, git/in-place handling, and the run log live in
[`references/runbook.md`](references/runbook.md). The runbook is the **sole owner** of repo-environment
detection (`edit_mode`, git snapshot) — this control plane does not duplicate it.

## One pattern per session

Report may span every pattern found; **apply touches one pattern per session** (atomic revert,
single-story diff). Refuse "fix everything" for the apply phase. Rationale:
[`references/shared-principles.md`](references/shared-principles.md#one-pattern-per-session).

## Critical rules

- **Local only** — no network calls or external services; operate solely on the workspace.
  **Documented exception:** `remove-deprecated-api` is plugin-driven and needs Maven Central
  (to resolve `aemanalyser-maven-plugin` and, transitively, the AEM SDK's api-regions data) plus
  optionally Adobe Experience League as a fallback source for successor guidance. If offline,
  that one pattern is skipped with a clear message; all other patterns remain local-only.
- **Requires a local JDK** (Java 11+) for detection — the analyzer compiles/runs in memory; no
  install beyond the JDK, no network. If absent, detection stops with a clear message.
- **The analyzer is detection — never substitute external tooling.** Do not run
  `mvn versions:display-dependency-updates` / `mvn versions:display-property-updates`,
  `npm outdated`, or Maven Central / registry lookups in place of analyzer discovery. Those answer
  "what is the latest on the network" — outside this skill's local-only contract. If the user
  explicitly wants a live registry comparison, say it needs network and offer it as a separate step
  **after** delivering the skill report. `remove-deprecated-api`'s preflight
  (`remove-deprecated-api/scripts/detect.sh`) is the one documented exception: it invokes the AEM
  Analyser Maven Plugin against the project to populate its rules cache, then hands off to the
  shared analyzer.
- **Never commit, push, or open a PR** — branch (git) or in-place edits only; the developer reviews and commits.
- **Surgical edits** — no reformatting / re-serialization.
- **Skip with a reason** — record un-applicable findings as `skipped` with an exact reason; never silently drop.
- **One pattern per session** for apply.

Full rationale: [`references/shared-principles.md`](references/shared-principles.md).

## Scope & limitations

Local static detection and remediation only — no external services, no network, no live AEM instance. Issues that require runtime or live-repository state, telemetry, or history across runs are out of scope for this skill.
Detection requires a local JDK (Java 11+); there is no remote or LLM-scan fallback in this version.
A large apply (e.g. an `@Inject` migration across 100+ files) is processed in **resumable batches**: the run checkpoints each file to `.autofix/last-run.json` and pauses at a per-pass cap, so it survives context limits — reply **apply `<pattern>`** to continue (see [`references/git-workflow.md`](references/git-workflow.md)).

## Adding a new pattern

Full end-to-end procedure — detector → fixtures/tests → catalog + routing → expert skill → verify:
**[`references/adding-a-pattern.md`](references/adding-a-pattern.md)**. The `[wiring]` test keeps the
detector, catalog row, and expert-skill directory in sync.

**Triggering scales without touching the description.** The `description` above is intentionally
broad (intent verbs + AEM domain), so it already fires on "check / review / fix my &lt;AEM thing&gt;";
a new pattern is reached by its **Manual Pattern Hints + `patterns.md` rows**, not by editing the
description. Update the description **only** if the new pattern introduces a domain keyword it does
not already cover (a new subsystem or file type). The `[wiring]` test keeps the detector, catalog
row, and expert-skill directory in sync.

## Related skills

- **`migration`** — drives BPA/CAM/MCP-based legacy-AEM migration workflow. Discovers findings, batches them, enforces one-pattern-per-session, and hands off `(pattern, file)` pairs to this skill for transformation. See the "Invocation from the `migration` skill" section above.
Pliki w paczce (60)
  • README.md 1 KB
  • SKILL.md 11 KB
  • asset-manager/SKILL.md 42 KB
  • event-migration/SKILL.md 45 KB
  • inject-in-sling-model/SKILL.md 3 KB
  • inject-in-sling-model/recipe.md 12 KB
  • outbound-call-timeouts/SKILL.md 6 KB
  • outbound-call-timeouts/recipe.md 10 KB
  • outdated-dependencies/SKILL.md 5 KB
  • outdated-dependencies/recipe.md 5 KB
  • references/_template.md 3 KB
  • references/adding-a-pattern.md 7 KB
  • references/aem-cloud-service-pattern-prerequisites.md 1 KB
  • references/data-sly-test-redundant-constant.md 10 KB
  • references/git-workflow.md 12 KB
  • references/patterns.md 6 KB
  • references/resource-resolver-logging.md 7 KB
  • references/runbook.md 19 KB
  • references/scr-to-osgi-ds.md 5 KB
  • references/shared-principles.md 4 KB
  • references/troubleshooting.md 2 KB
  • remove-deprecated-api/README.md 2 KB
  • remove-deprecated-api/SKILL.md 10 KB
  • remove-deprecated-api/recipe.md 26 KB
  • remove-deprecated-api/scripts/detect.sh 14 KB
  • replication/SKILL.md 38 KB
  • resource-change-listener/SKILL.md 33 KB
  • scheduler/SKILL.md 8 KB
  • scheduler/path-a.md 13 KB
  • scheduler/path-b.md 12 KB
  • scripts/README.md 4 KB
  • scripts/analyze.sh 1 KB
  • scripts/analyzer/Analyze.java 10 KB
  • scripts/analyzer/Corpus.java 1 KB
  • scripts/analyzer/Detector.java 1 KB
  • scripts/analyzer/Finding.java 1 KB
  • scripts/analyzer/JavaUnit.java 2 KB
  • scripts/analyzer/OsgiUnit.java 1 KB
  • scripts/analyzer/PomUnit.java 2 KB
  • scripts/analyzer/Registry.java 1 KB
  • scripts/analyzer/detectors/AssetManager.java 2 KB
  • scripts/analyzer/detectors/EventMigration.java 2 KB
  • scripts/analyzer/detectors/InjectInSlingModel.java 2 KB
  • scripts/analyzer/detectors/OakQueryIndexCoverage.java 5 KB
  • scripts/analyzer/detectors/OutboundCallTimeouts.java 8 KB
  • scripts/analyzer/detectors/OutdatedDependencies.java 2 KB
  • scripts/analyzer/detectors/RemoveDeprecatedApi.java 6 KB
  • scripts/analyzer/detectors/Replication.java 1 KB
  • scripts/analyzer/detectors/ResourceChangeListener.java 2 KB
  • scripts/analyzer/detectors/Scheduler.java 6 KB
  • scripts/analyzer/detectors/UnboundedQuery.java 6 KB
  • scripts/analyzer/util/Annotations.java 1 KB
  • scripts/analyzer/util/Poms.java 2 KB
  • scripts/analyzer/util/Types.java 3 KB
  • tuning-oak-query-indexes/SKILL.md 6 KB
  • tuning-oak-query-indexes/recipe.md 26 KB
  • tuning-oak-query-indexes/references/ai-agent-indexing-guide.md 110 KB
  • tuning-oak-query-indexes/references/extracting-jcr-queries.md 13 KB
  • unbounded-query/SKILL.md 6 KB
  • unbounded-query/recipe.md 8 KB

Wersje

W bazie nie ma innych skilli o nazwie code-assessment.

Migawka bazy z 13.11.2026 · wersja paczki 6e130e5499b5 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100inject-in-sling-model
    Migruje pola javax.inject.@Inject w klasach Sling Model (@Model) w AEM Cloud Service na adnotacje właściwe dla wstrzykiwaczy (@ValueMapValue, @OSGiService, @SlingObject), dobierane według typu pola.
  • 100workflow-debugging
    Diagnozuje problemy z AEM Workflow w AEM as a Cloud Service: zablokowane workflowy, nieudane kroki, brakujące zadania w Inbox, awarie launcherów, wyczerpanie puli wątków, zaległości kolejek i błędy uprawnień.
  • 100aem-doctor
    Sprawdza stan infrastruktury projektu AEM: definicje komponentów, konfiguracje OSGi, reguły dispatchera i strukturę treści, na przykład po zmianach w infrastrukturze.
  • 95pr-review
    Przegląda pull request pod kątem poprawności, bezpieczeństwa, jakości kodu i testów oraz zwraca uwagi do poprawy.
  • 90Code Review
    Przegląda kod projektów AEM Edge Delivery Services przed commitem lub w pull requestach, z sugestiami zmian w GitHub.
  • 95osgi-ai-migrator
    Migruje moduły Liferay 7.x OSGi do Liferay Objects i Client Extensions, z walidacją formatów dla DXP 2026.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.