Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

integration-doc-maintainer

/integration-doc-maintainer

Prowadzi dokumentację integracji między modułami przy zmianach zdarzeń, zadań w tle, kontraktów usług i zależności.

Repozytorium
paqad-ai ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
9
Skrypty
3
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

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

Skrypty: scripts/extract-events.sh, scripts/find-integration-docs.sh, scripts/lint-output.sh

Co robi i kiedy

Prowadzi dokumentację integracji między modułami przy zmianach zdarzeń, zadań w tle, kontraktów usług i zależności.

Oryginalny opis (EN)

Maintains cross-module integration documentation. Use when a request affects published or consumed events, background jobs, external service contracts or any cross-module dependency.

Jak działa

  1. What It Does
  2. Use This When
  3. Inputs
  4. Procedure
  5. Output Contract
  6. Escalate / Stop Conditions
  7. Resources
Sekcje z nagłówków SKILL.md, w oryginale · 47 linii, 283 słów
Podgląd SKILL.md
---
name: integration-doc-maintainer
description: 'Maintains cross-module integration documentation. Use when a request affects published or consumed events, background jobs, external service contracts or any cross-module dependency.'
metadata:
  model_tier: medium
  max_lines: '200'
  cacheable: 'false'
  output_format: markdown
  paqad-meta: skill.meta.yaml
---

## What It Does

Maintains cross-module integration docs by documenting events, jobs, contracts, and fallback behavior for any change that crosses module or service boundaries.

## Use This When

When a request affects published events, consumed events, background jobs, external service contracts, or any cross-module dependency.

## Inputs

- Read the current integration docs first: `integration/events.md` and `integration/contracts.md` for the affected module.
- Read the changed code and any generated event inventory or contract references.
- Read `references/integration-contract-fields.md` before updating entries.

## Procedure

1. Run `scripts/find-integration-docs.sh` to enumerate canonical events/contracts/jobs/integration docs.
2. Run `scripts/extract-events.sh <changed-files...>` to surface candidate event names; LLM confirms each before writing.
3. Update each event entry using `assets/event.template.md` (publisher, subscribers, payload, async behavior, failure expectations, versioning).
4. Update contracts with owner, versioning, and fallback/degradation behavior. Document both sides of every cross-module coupling.
5. Format report per `assets/output.template.md` and validate with `scripts/lint-output.sh`. Missing fallback / undocumented coupling → `## Consistency Warnings`, never silent.

## Output Contract

- Match `assets/output.template.md`: `## Updated Integration Docs` and `## Consistency Warnings`.
- Every updated item must name the event, contract, job, or integration path and the canonical doc path changed.
- Output must pass `scripts/lint-output.sh` (exit 0).
- Missing fallback behavior, subscriber ownership, or compatibility policy belongs under `Consistency Warnings`, never as an invented completed entry.

## Escalate / Stop Conditions

- Ask when subscriber ownership, contract versioning, or fallback policy is unclear.
- Warn when a new integration path has no documented recovery or compatibility posture.
- Do not invent event payloads or subscriber lists that are not evidenced by the code or project docs.

## Resources

- `references/integration-contract-fields.md`
- `scripts/find-integration-docs.sh`
- `scripts/extract-events.sh`
- `scripts/lint-output.sh`
- `assets/output.template.md`
- `assets/event.template.md`
- `runtime/templates/runner-scripts/extract-events.sh.hbs`
- `agents/openai.yaml`
Pliki w paczce (9)
  • SKILL.md 3 KB
  • skill.meta.yaml 1 KB
  • agents/openai.yaml 1 KB
  • assets/event.template.md 1 KB
  • assets/output.template.md 1 KB
  • references/integration-contract-fields.md 1 KB
  • scripts/extract-events.sh 1 KB
  • scripts/find-integration-docs.sh 1 KB
  • scripts/lint-output.sh 1 KB

Wersje

W bazie nie ma innych skilli o nazwie integration-doc-maintainer.

Migawka bazy z 13.11.2026 · wersja paczki ff79c2cd3789 (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

  • 90api-doc-maintainer
    Utrzymuje dokumentację API modułu: aktualizuje endpointy, ładunki, zasady uwierzytelniania i błędy po każdej zmianie.
  • 90may-tech-lead
    Ocenia kompromisy architektoniczne, kontrakty między modułami i kolejność integracji przy zmianach wymagających decyzji technicznych.
  • 90error-catalog-maintainer
    Prowadzi katalogi błędów dla modułów: dopisuje kody, aktualizuje komunikaty i ścieżki odzyskiwania po zmianach w kodzie.
  • 100architecture
    Mapuje architekturę projektu: zależności między modułami, sprzężenie, graf zależności i granice modułów.
  • 100add-integration-event
    Publikuje zdarzenie integracyjne między modułami przez Outbox i obsługuje je idempotentnie w innym module, gdy jeden moduł musi zareagować na zdarzenie z drugiego.
  • 100native-integration
    Przegląda pracę nad natywnymi modułami React Native, uprawnieniami i zadaniami w tle: integracje API platformy, kamera, biometria, pliki oraz granica mostu lub Turbo Module.

Uwagi i zgłoszenia

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