repo-architecture-research

slauger 的头像作者 slauger

编号. 仓库管理工具(APT、RPM、PyPI)的架构研究和分析。在apt-mirror、aptly、reposync、bandersnatch、devpi或类似工具的研究任务中自动激活。

📖 中文导读:编号. 仓库管理工具(APT、RPM、PyPI)的架构研究和分析。在apt-mirror、aptly、reposync、bandersnatch、devpi或类似工具的研究任务中自动激活。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: repo-architecture-research description: Strukturierte Architektur-Recherche und -Analyse für Repository-Management-Tools (APT, RPM, PyPI). Automatisch aktiviert bei Recherche-Aufgaben zu apt-mirror, aptly, reposync, bandersnatch, devpi oder ähnlichen Tools.

Repository-Architektur-Recherche Skill

Dieser Skill führt strukturierte Recherche und Analyse von Repository-Management-Tools durch, wie in PROMPT.md spezifiziert.

Anwendungsbereich

Aktiviere diesen Skill automatisch wenn:

  • Analyse bestehender Tools (apt-mirror, aptly, reposync, bandersnatch, devpi, etc.)
  • Vergleich von Repository-Sync-Architekturen
  • Recherche zu Metadaten-Formaten (APT InRelease, RPM repodata, PyPI Simple Index)
  • Untersuchung von Deduplikations- und Storage-Strategien
  • Design-Entscheidungen für das Unified Repository Sync Tool

Workflow

1. Recherche-Struktur

Für jedes Tool analysiere systematisch:

A. Funktionsübersicht

  • Kernfunktionen (Mirror, Snapshot, Publish, etc.)
  • CLI-Interface und Kommandos
  • Konfigurationsmechanismus

B. Architektur

  • Storage-Layout (wie werden Artefakte gespeichert?)
  • Metadaten-Handling (original oder regeneriert?)
  • State-Management (DB, Files, oder beides?)
  • Deduplikation (wenn vorhanden)

C. Repository-Typ-Spezifika

APT:

  • Umgang mit InRelease/Release/Release.gpg
  • Signaturen (übernommen oder neu?)
  • Multi-Arch Handling

RPM:

  • repodata-Handling (kopiert oder regeneriert?)
  • modules.yaml, comps.xml Behandlung
  • DeltaRPM Support

PyPI:

  • Simple Index API (PEP 503)
  • JSON API vs. Simple Index
  • Wheel vs. Source Distributions
  • Package Metadata (PKG-INFO, METADATA)
  • Hash-Verifizierung (SHA256)

D. Snapshot-Konzept

  • Hat das Tool Snapshot-Funktionalität?
  • Wie werden Snapshots erstellt? (Metadaten-Kopie, Symlinks, etc.)
  • Sind Snapshots konsistent und reproduzierbar?

E. Stärken & Schwächen

  • Was macht das Tool besonders gut?
  • Welche Limitierungen existieren?
  • Wartbarkeit und aktuelle Entwicklung

2. Dokumentation in findings.md

Nach jeder Tool-Analyse:

  1. Erstelle strukturierten Abschnitt in .planning/findings.md:
## Tool: [Name] - [Datum]

### Funktionsübersicht
- ...

### Architektur
**Storage:**
- ...

**Metadaten:**
- ...

**State:**
- ...

### APT-Spezifika / RPM-Spezifika
- ...

### Snapshot-Konzept
- ...

### Bewertung
**Stärken:**
- ...

**Schwächen:**
- ...

**Lessons Learned für unser Tool:**
- ...

3. Vergleichsmatrix

Nach Analyse mehrerer Tools erstelle Vergleichstabelle:

Kriterium apt-mirror aptly reposync bandersnatch devpi
Storage-Modell ... ... ... ... ...
Deduplikation ... ... ... ... ...
Metadaten ... ... ... ... ...
Snapshots ... ... ... ... ...
CLI-Design ... ... ... ... ...
Aktiv maintained ... ... ... ... ...

4. Design-Implikationen

Leite aus den Findings konkrete Design-Empfehlungen ab:

## Design-Entscheidungen aus Recherche

### [Thema, z.B. "Metadaten-Handling für APT"]

**Problem:**
- ...

**Optionen aus Tool-Analyse:**
1. Ansatz von [Tool]: ...
   - Pro: ...
   - Contra: ...
2. Ansatz von [Tool]: ...
   - Pro: ...
   - Contra: ...

**Empfehlung:**
- ...
- Begründung: ...

Integration mit Planning

  • Aktualisiere .planning/task_plan.md Phase-Status nach jeder Tool-Analyse
  • Markiere offene Fragen in findings.md mit **FRAGE:**
  • Verweise auf spezifische Zeilen in Quellcode oder Dokumentation wenn möglich

Recherche-Quellen

Nutze systematisch:

  1. Offizielle Dokumentation (Websites, man pages)
  2. Source Code (GitHub, GitLab - Architektur-Analyse)
  3. Issue Trackers (bekannte Probleme und Limitierungen)
  4. Community Discussions (Reddit, Mailing Lists für praktische Erfahrungen)

Qualitätskriterien

  • Konkrete Beispiele statt vage Beschreibungen
  • Quellenangaben (URLs, Commit-Hashes, Versionen)
  • Annahmen explizit markieren
  • Technisch präzise, keine Floskeln
  • Deutsch für Dokumentation

Ausgabeformat

Während der Recherche:

  • Kurze Updates über Fortschritt
  • "Analysiere [Tool] - [Aspekt]"
  • Keine langen Zwischenberichte

Nach Abschluss:

  • Kompakte Zusammenfassung der Kernerkenntnisse
  • Verweis auf .planning/findings.md für Details
  • Nächste empfohlene Schritte