Fähigkeiten improve-codebase-architecture

📦

improve-codebase-architecture

Name: improve-codebase-architecture
Author: mattpocock

Inhaltsrevision r1 Niedriges Risiko ⚙️ Externe Befehle📁 Dateisystemzugriff

Codebase-Architektur verbessern

Architekturreviews übersehen oft flache Module, verstreute Entscheidungen und schwache Testoberflächen. Dieser Skill leitet AI-Agenten dabei an, mit der Sprache des Projekts praktische Refactoring-Möglichkeiten zu finden.

Unterstützt: Claude Codex Code(CC)

📊 76 Angemessen

Dieser Skill ist Teil eines Skill-Pakets

Installieren Sie das gesamte Skill-Paket, um mit einem Befehl alle Skills zu erhalten, die die Aufgabe braucht.

KeywayTech Coding Skills · 18 Skills Gesamtes Paket installieren

Mit meinem Agent installieren

Kopieren Sie diese Anfrage in Ihren Agent. Sie enthält die maßgebliche Skill-Seite und das Manifest.

Agent-Anfrage

Review the Skillstore skill "improve-codebase-architecture" from https://skillstore.io/skills/mattpocock-improve-codebase-architecture.md and its manifest at https://skillstore.io/api/skills/mattpocock-improve-codebase-architecture/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ihr Agent sollte weiterhin seinen Plan anzeigen und alle von der Sicherheitsrichtlinie verlangten Bestätigungen anfordern.

Agent-lesbare Ressourcen

Verwenden Sie diese Links, wenn ein KI-Agent, Crawler oder Skript sauberen Kontext benötigt, statt die vollständige Seite zu lesen.

Markdown-Detailseite GET /skills/mattpocock-improve-codebase-architecture.md Signiertes manifest GET /api/skills/mattpocock-improve-codebase-architecture/manifest Signiertes lockfile GET /api/skills/mattpocock-improve-codebase-architecture/lockfile

Testen

„improve-codebase-architecture“ wird verwendet. Prüfe den Billing-Bereich auf Architekturprobleme.

Erwartetes Ergebnis:

Eine nummerierte Liste von Vertiefungsmöglichkeiten in Billing-Modulen.
Jeder Kandidat enthält betroffene Dateien, das Problem, die vorgeschlagene Richtung und Vorteile für die Testbarkeit.
Eine Frage, welcher Kandidat als Nächstes untersucht werden soll.

„improve-codebase-architecture“ wird verwendet. Wir haben den Kandidaten für die Auftragserfassung ausgewählt. Hilf beim Ausformen der Schnittstelle.

Erwartetes Ergebnis:

Eine kurze Einordnung von Einschränkungen und Abhängigkeiten.
Mehrere alternative Schnittstellendesigns mit unterschiedlichen Trade-offs.
Eine Empfehlung basierend auf Tiefe, Lokalität, Platzierung der Nahtstelle und Testoberfläche.

„improve-codebase-architecture“ wird verwendet. Unsere ADRs lehnen ein Repository-Pattern ab, aber das aktuelle Design ist schmerzhaft.

Erwartetes Ergebnis:

Ein fokussiertes Review des ADR-Konflikts und der aktuellen architektonischen Reibung.
Eine Empfehlung, ob es sich lohnt, die Entscheidung erneut zu öffnen.
Optionale Formulierung für eine ADR-Aktualisierung, falls der Nutzer sie dokumentieren möchte.

Sicherheitsaudit

Niedriges Risiko

v4 • 5.7.2026 Versionsbericht öffnen

The static command-execution and path-traversal alerts are false positives caused by Markdown inline code and relative documentation links. No malicious shell execution, network access, credential access, or prompt injection was found. The remaining concern is low-risk repository exploration and documentation edits that users should review.

Gescannte Dateien

214

Analysierte Zeilen

Prüfelemente

Falschmeldungen ignoriert

Bestätigte Sicherheitsbedenken (1)

Niedrig

SKILL.md:35-42 SKILL.md:73-75

Broad Repository Access and Documentation Writes

The skill tells the agent to read project context, walk the codebase with an Explore subagent, and update CONTEXT.md or offer ADR creation. This is legitimate for architecture review, but it can expose repository contents to the agent and create documentation changes.

The cited lines explicitly direct repository reading and conditional documentation edits. The behavior is expected for the skill, so the concern is operational rather than malicious.

Risikofaktoren

⚙️ Externe Befehle (7)

SKILL.md:29 SKILL.md:37 SKILL.md:38 SKILL.md:42 SKILL.md:61 SKILL.md:73 SKILL.md:74

📁 Dateisystemzugriff (3)

SKILL.md:29 SKILL.md:73 SKILL.md:75

Geprüft von: codex Audit-Verlauf anzeigen →

Diesen Bericht teilen & zitieren

Teile den versionierten Bewertungsbericht, das neutrale Badge, die Einbettungskarte und Zitate. Skillstore berichtet Nachweise, ohne zu entscheiden, ob dieser Skill sicher ist.

Versionsbericht öffnen

Berichtslink kopieren

https://skillstore.io/skills/mattpocock-improve-codebase-architecture/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown-Badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/mattpocock-improve-codebase-architecture/security.svg)](https://skillstore.io/skills/mattpocock-improve-codebase-architecture?utm_source=security_passport_badge)

HTML-Badge

<a href="https://skillstore.io/skills/mattpocock-improve-codebase-architecture?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/mattpocock-improve-codebase-architecture/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Einbettungskarte

<iframe src="https://skillstore.io/embed/skills/mattpocock-improve-codebase-architecture.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Wissenschaftliche Zitate (APA · BibTeX · CFF)

APA-Zitat

mattpocock. (2026). improve-codebase-architecture security audit report (audit version 4) [Author version unspecified]. Skillstore. https://skillstore.io/skills/mattpocock-improve-codebase-architecture/audits/4

BibTeX-Zitat

@techreport{mattpocock-mattpocock-improve-codebase-architecture-2026,
  author = {mattpocock},
  title = {improve-codebase-architecture security audit report (audit version 4)},
  institution = {Skillstore},
  year = {2026},
  number = {4},
  url = {https://skillstore.io/skills/mattpocock-improve-codebase-architecture/audits/4},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "improve-codebase-architecture security audit report (audit version 4)"
version: "unspecified"
type: report
authors:
  - name: "mattpocock"
date-released: "2026-07-05"
url: "https://skillstore.io/skills/mattpocock-improve-codebase-architecture/audits/4"
identifiers:
  - type: other
    value: "skillstore:mattpocock-improve-codebase-architecture:audit:4"
    description: "Skillstore immutable audit report identifier"

Skillstore-Score

Warum dieser Score Evidenzvertrauen: Hoch

Architektur

Wartbarkeit

Inhalt

Gemeinschaft

Spezifikationskonformität

Was Sie erstellen können

Einen verworrenen Feature-Bereich refaktorieren

Module finden, in denen Komplexität über Aufrufer verteilt ist, und eine tiefere Modulstruktur vorschlagen.

Auf AI-gestützte Wartung vorbereiten

Benennung, Lokalität und Testoberflächen verbessern, damit zukünftige Agenten zuverlässiger durch den Code navigieren können.

Architektur vor größerer Arbeit prüfen

Domain-Kontext und ADRs verwenden, um Nahtstellen zu identifizieren, die sich ändern sollten, bevor die Implementierung beginnt.

Diese Prompts ausprobieren

Architekturreibung finden

Use the improve-codebase-architecture skill to review this repository. Start with CONTEXT.md and ADRs, then list the strongest deepening opportunities.

Einen Feature-Bereich prüfen

Use the improve-codebase-architecture skill on the checkout flow. Identify shallow modules, weak seams, and tests that would improve after refactoring.

Refactoring-Kandidaten priorisieren

Use the skill to compare deepening opportunities in this module cluster. Rank them by locality, leverage, implementation risk, and test impact.

Alternative Schnittstellen entwerfen

Use the interface design workflow for the selected candidate. Generate several different interface options, compare trade-offs, and recommend one.

Bewährte Praktiken

Führe ihn auf einem fokussierten Feature-Bereich aus, wenn das Repository groß ist.
Halte CONTEXT.md und ADRs aktuell, bevor du nach Empfehlungen fragst.
Prüfe vorgeschlagene Dokumentationsänderungen, bevor du sie akzeptierst.

Vermeiden

Verwende ihn nicht als Ersatz für Produkt- oder Domain-Entscheidungen.
Füge keine Nahtstelle nur deshalb hinzu, weil sie Mocking erleichtert.
Bitte nicht um konkrete Schnittstellen, bevor du einen Refactoring-Kandidaten ausgewählt hast.

Häufig gestellte Fragen

Für welche Art von Codebase ist dieser Skill gedacht?

Er eignet sich am besten für Repositorys, bei denen Architektur, Tests oder Modulstruktur schwer nachvollziehbar werden.

Ändert er Code automatisch?

Nein. Er konzentriert sich auf Analyse und Diskussion. Er kann Dokumentationsänderungen vorschlagen, wenn der Workflow dies vorsieht.

Benötigt er CONTEXT.md?

Nein. Der Skill liest CONTEXT.md, wenn sie vorhanden ist, und fährt stillschweigend fort, wenn sie fehlt.

Wie verwendet er ADRs?

Er liest ADRs, um zu vermeiden, dass abgeschlossene Entscheidungen erneut geöffnet werden, es sei denn, aktuelle Reibung macht eine Entscheidung überprüfenswert.

Kann er neue Schnittstellen entwerfen?

Ja. Nachdem ein Kandidat ausgewählt wurde, vergleicht er mehrere Schnittstellenoptionen und empfiehlt eine davon.

Ist er mit Claude Code und Codex nützlich?

Ja. Der Skill unterstützt Claude-, Codex- und Claude Code-Workflows, die Repository-Dateien prüfen können.