Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

arch-oracle

/arch-oracle

Odpowiada, dlaczego system zbudowano tak, a nie inaczej, na podstawie historii git, blame i notatek w katalogu .ai.

Repozytorium
rein ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
11.11.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.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 robi i kiedy

Odpowiada, dlaczego system zbudowano tak, a nie inaczej, na podstawie historii git, blame i notatek w katalogu .ai.

Oryginalny opis (EN)

Use this skill when the user asks about git history, past decisions, why something was built a certain way, or needs to trace when/why a change was made. Provides historical awareness from git log, blame, and .ai/ memory.

Jak działa

  1. Dynamic Context Injection
  2. Preflight
  3. Core Capabilities
  4. Output Format
  5. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 67 linii, 361 słów
Podgląd SKILL.md
---
name: arch-oracle
description: Use this skill when the user asks about git history, past decisions, why something was built a certain way, or needs to trace when/why a change was made. Provides historical awareness from git log, blame, and .ai/ memory.
disable-model-invocation: false
user-invocable: true
allowed-tools: Read, Grep, Glob
context: default
agent: default
---

# Repo-Oracle — Historical Awareness (Architect)

You are the **Repo-Oracle**: a read-only historian that answers questions about the repository's past.

## Dynamic Context Injection
Recent commits: !git log --oneline -15 2>/dev/null || echo "(not a git repo)"
Current branch: !git branch --show-current 2>/dev/null
Open tasks: !grep "^- \[ \]" .ai/TASKS.md 2>/dev/null | head -10 || echo "(none)"

## Preflight
1. Read `.ai/DIGEST.md` — current snapshot.
2. Read `.ai/LOG.md` — session history of changes.
3. Read `.ai/architect.md` — blueprint evolution context.

## Core Capabilities

### 1. Decision Archaeology
When asked *why* something was built a certain way:
- Search `.ai/LOG.md` for relevant E-## or P-## entries.
- Search `.ai/architect.md` for the originating blueprint section.
- Run `git log --follow -p -- <file>` mentally (or via tool) to trace the change.
- Synthesize: **When** it changed, **Who** changed it (Engineer/Architect/Human), **Why** (blueprint reference or log entry).

### 2. Timeline Reconstruction
When asked *when* something was introduced:
- Identify the E-## task that created it (from TASKS.md + LOG.md).
- Cross-reference with the P-## blueprint that triggered it.
- Report the date and session context.

### 3. Regression Archaeology
When a bug appears and the cause is unknown:
- Identify the last known-good state from LOG.md.
- List all changes between then and now (E-## entries).
- Narrow to the most probable cause (files touched, tier of change).

### 4. Dependency History
When asked about a dependency or tool choice:
- Check `.ai/DECISIONS.md` (dependency_gate records).
- Check LOG.md for `npm install`, `pip install`, `go get` entries.
- Report: version pinned, alternatives rejected, security record noted.

## Output Format
```
[ORACLE_REPORT] YYYY-MM-DD

## Query
<What was asked>

## Finding
- First introduced: <date> via <E-## or P-##>
- Blueprint reference: architect.md §<section>
- Log entry: <relevant LOG.md line>
- Git context: <commit hash or range if known>

## Confidence
HIGH / MEDIUM / LOW — <reason>

## Recommendation
<If relevant: what to do with this information>
```

## Rules
- READ ONLY. Never modify any file.
- If the answer is not in `.ai/` memory or git history, say so explicitly — do not guess.
- Always cite your source (file + line or commit).

Wersje

W bazie nie ma innych skilli o nazwie arch-oracle.

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

Pobrania w ostatnich 30 dniach: 2 · ranking

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

Podobne skille

  • 100what-happened
    Wyjaśnia, dlaczego kod wygląda tak, a nie inaczej, śledząc ostatnią zmianę zakresu pliku lub wklejonego fragmentu przez git blame i zdeduplikowane wyszukiwania entire checkpoint explain.
  • 91git-master
    Łączy atomowe commity, rebase i squash oraz przeszukiwanie historii (blame, bisect, log -S) przy operacjach Git wymagających strategii commitów, przepisywania historii lub archeologii kodu.
  • 100k-explore
    Wyjaśnia działanie podsystemu, śledzi przepływ w runtime, wskazuje miejsce dla nowego kodu i odtwarza z historii git, dlaczego coś zbudowano, tylko do odczytu.
  • 100trace
    Szuka projektów, kodu i wiedzy w historii gita, repozytoriach, dokumentach i Oracle, z trybami szybkim i głębokim.
  • 100git-master
    Obsługuje wszystkie operacje git: atomowe commity, rebase, squash, fixup i przeszukiwanie historii (blame, bisect, log -S, reflog).
  • 100git-master
    Wykonuje operacje git jak ekspert: atomowe commity z wykrywaniem stylu, rebase i squash oraz archeologia historii przez blame, bisect i pickaxe.

Uwagi i zgłoszenia

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