Skills-Summarize-Audit — Fähigkeitsbibliotheks- und Projektprofil-gesteuertes Audit (in Verbindung mit summarize)
Mehrdimensionale Profilierung, siebendimensionale Bewertung, Kapazitätsanalyse und Optimierungsempfehlungen für die Skill-Bibliothek oder das aktuelle Projekt mit Ausgabe eines ausführbaren Prüfberichts.
Es hilft Ihnen:
- Den Zustand der Skill-Bibliothek zu verstehen (🟢/🟡/🔴) und Trends zu erkennen (📈 ↑/↓)
- Tote Skills und redundante Überschneidungen zu finden
- Zu berechnen, wie viele weitere Skills der Agent noch aufnehmen kann (Mehrfaktor-Kapazitätswarnung)
- Eine ausführbare Aufgabenliste für Archivierung/Installation/Aktualisierung zu erhalten
- Nach Fehlbedienungen mit einem Klick rückgängig zu machen (
--undo)- In CI/CD-Pipelines integriert zu werden (JSON-Ausgabe + Gate-Logik)
Triggerwörter
Dieses Skill verwendet unabhängige Wortauslösung: Das Triggerwort muss separat gesendet werden (ggf. mit Unterbefehl); eine Auslösung im Satz erfolgt nicht. Es ist in Verbindung mit dem summarize-Skill konzipiert; 技能总结 kann das Audit direkt auslösen.
- Skill-Audit:
技能审查,技能审计,技能检查,能力审查,能力审计,工具审查,技能总结,skills-audit,skill-audit,skill-check,capability-audit,tool-audit,skills-summarize-audit - Projekt-Audit:
项目审查,项目审计,项目诊断,项目画像,环境审查,环境审计,project-audit,project-check,project-diagnosis,project-profile,env-audit - Rückgängig machen:
回滚,撤销,恢复,undo-snapshot,rollback,revert - Unterbefehle:
深度/deep,推荐/recommend,画像/profile,健康/health,轻量/quick,ci/--ci,回滚/undo/--undo
Triggerwort-Matrix
| Modus | Chinesisches Triggerwort | Englisches Triggerwort |
|---|---|---|
| Skill-Audit | 技能审查, 技能审计, 技能检查, 能力审查, 能力审计, 工具审查, 技能总结 | skills-audit, skill-audit, skill-check, capability-audit, tool-audit, skills-summarize-audit |
| Projekt-Audit | 项目审查, 项目审计, 项目诊断, 项目画像, 环境审查, 环境审计 | project-audit, project-check, project-diagnosis, project-profile, env-audit |
| Rückgängig machen | 回滚, 撤销, 恢复 | undo-snapshot, rollback, revert |
Synonyme: 审查=审计=检查=诊断, 能力=技能=工具, 环境=项目 → werden automatisch dem entsprechenden Modus zugeordnet.
Triggerverhalten
| Wird ausgelöst ✅ | Wird nicht ausgelöst ❌ |
|---|---|
技能审查 (separat gesendet) | 帮我做一次技能审查 (im Satz) |
skills-audit skills-summarize-audit (separat gesendet) | run skills-audit on this (im Satz) |
技能总结 (separat gesendet, in Verbindung mit der Marke summarize) | 总结一下技能 (im Satz, wird nicht ausgelöst) |
技能审计 深度 (separates Wort + Unterbefehl) | 这个项目需要能力审查吗 (im Satz) |
Sprachanpassung: Wenn die Hauptsprache des Benutzers Englisch ist (>70% Englisch im Gespräch), werden die Triggerwörter zuerst auf Englisch abgeglichen, und die Ausgabesprache des Berichts wird auf en umgestellt.
Wann verwenden
- Skill-Audit-Modus: Regelmäßige Wartung des Zustands der Skill-Bibliothek (empfohlen alle 2-4 Wochen) oder nach größeren Änderungen. In Verbindung mit
总结(Zusammenfassung): run summarize → erkennt Skill-Stau → empfiehlt技能总结 - Projekt-Audit-Modus: Schnelles Verständnis des Tech-Stacks und der Toolchain bei Übernahme eines neuen Projekts oder Bewertung des Umgebungszustands vor einer Refaktorisierung
- Übersetzung und Verfeinerung von Triggerwörtern: Automatische Übersetzung der Skill-Beschreibung in chinesische Triggerwörter + Kurzbeschreibung (oder umgekehrt), um mehrsprachigen Benutzern ein schnelles Verständnis der Skill-Funktion zu ermöglichen
Voraussetzungen
Harte Anforderungen (automatische Erkennung + Installationsanleitung bei Fehlen)
- codegraph — Codestruktur- und Symbolabfrage, Kern-Analyse-Engine des Skills. Versucht automatische Installation bei Fehlen.
- git — Versionsvergleich, Snapshots und Rollback. Versucht automatische Installation bei Fehlen.
- config.yaml — Einzige Konfigurationsquelle im Skill-Verzeichnis. Wird aus einer Vorlage erstellt, falls nicht vorhanden.
Weiche Anforderungen (werden automatisch erstellt, wenn nicht vorhanden)
- user-profile.md — Benutzerprofil. Wird bei Fehlen durch eine automatisierte Frage-Antwort-Sitzung erstellt.
Fähigkeiten
skills-summarize-audit bietet die folgenden Kernfähigkeiten (v6.0.0: neue Fähigkeitsmatrix, Qualitätssignale, Community-Feed, Öko-Radar):
- Technologie-Stack-Profil des Projekts und Projekterkennung
- Vollständige Scan der Skill-Bibliothek und inkrementelle Liste
- Aufbau einer Fähigkeitsdimensionsmatrix (~12 Fähigkeitsdimensionen, v6.0.0)
- Qualitätssignale lesen (in Verbindung mit summarize Fehlerbuch, v6.0.0)
- Mehrfaktor-Kapazitätsanalyse und Kapazitätswarnung
- 6 Skill-Aktivitätsprüfungen
- Siebendimensionale S/A/B/C/D-Bewertung mit Pflichtbegründung
- T3-Aktivitätsverifikation und Risikokontrolle bei Fehlarchivierung
- Community-Feed-Suche (GitHub-Suche getrieben durch Fähigkeitslücken, v6.0.0)
- Werkzeugempfehlung basierend auf Fähigkeitskomplementarität (Ersatz/Komplement/Ergänzung/Irrelevant, v6.0.0)
- Öko-Radar-Block (bedingte Ausgabe, nur bei Problemen sichtbar, v6.0.0)
- Skill-für-Skill-Tiefenlesen und externe Quellenverifikation
- Externer Signal-Cache und dreistufige Empfehlungs-Engine
- 30-Sekunden-Zusammenfassungsbericht und Trendvergleich
- Snapshot-Sicherung und
--undo-Rollback - CI/CD-Interaktionsfreier Modus und JSON-Gate-Ausgabe
- Übersetzung und Verfeinerung von Triggerwörtern sowie Qualitätsprüfung der Beschreibung
Detaillierte Fähigkeitstabelle nach Ausführungsphase:
| Phase | Fähigkeit | Beschreibung |
|---|---|---|
| ⓪ Konfiguration | Multiplattform-Anpassung | Automatische Erkennung der Plattform Codex/Claude/Cursor/Coze |
| ① Profil | Projekt-Tech-Stack-Scan | Automatische Erkennung von 15+ Projekttypen (Web/Rust/Python/Go/Java...) |
| ② Liste | Vollständiger Scan der Skill-Bibliothek + Fähigkeitszuordnung | Scan von 4 Pfaden + Zuordnung via capability-dimensions.yaml (v6.0.0) |
| ②-bis | Kapazitätsanalyse | Mehrfaktor-Kapazitätsberechnung (Token + Konfliktfaktor + kognitive Kapazität) |
| ②-ter | Aktivitätsprüfung | 6 Prüfungen zur Verifikation der Skill-Verfügbarkeit (Agent-Erreichbarkeit/MCP/Befehle/Trigger/Daten/Nutzungsnachweise) |
| ④ Bewertung | Siebendimensionale Bewertung + Qualitätssignale | 7-dimensionale Bewertung + Lesen des summarize-Fehlerbuchs (v6.0.0) |
| ④-a | T3-Aktivitätsverifikation | Überprüfung von Nutzungsnachweisen/Änderungszeit/Trigger-Aufzeichnungen vor Archivierung zur Reduzierung der Fehlarchivierungsrate |
| ④-bis | Tiefenlesen | S/A vollständig, B (profilrelevant) vollständig, B (nicht relevant) gekürzt |
| ⑤a | Externe Signale | Sammeln von GitHub⭐/npm📥 mit Cache |
| ⑤-aa | Community-Feed | GitHub-Suche getrieben durch Fähigkeitslücken (v6.0.0) |
| ⑤b | Fähigkeitsmatrix-Empfehlungsengine | Empfehlung basierend auf Fähigkeitskomplementarität (Ersatz/Komplement/Ergänzung/Irrelevant, v6.0.0) |
| ⑥ | Berichterstellung + Öko-Radar | 30-Sekunden-Zusammenfassung + Kapazitätsblock + Bewertungstabelle + bedingter Öko-Radar-Block (v6.0.0) |
| ⑦-a | Snapshot-Sicherung | Automatische Sicherung aller editierbaren Skills vor der Ausführung |
| ⑦-d | Ausführungs-Rollback | --undo zum Rückgängigmachen beliebiger Ausführungsaktionen, Snapshots werden 7 Tage aufbewahrt |
| CI | Interaktionsfreies Audit | JSON-Ausgabe + drei Gates (health/t3/actions), Integration in GitHub Actions |
Wann NICHT verwenden
- Einmalige Dateibearbeitung, Echtzeit-Debugging, minimale Projekte (keine Skill-Abhängigkeiten), nur Installation eines einzelnen Skills
- Umgebungen mit geringen Ressourcen (Audit verbraucht ca. 5K-15K Tokens pro Durchlauf)
Ausführungsablauf
Nach der Auslösung wird zuerst
references/execution-flow.mdgelesen, um den vollständigen Ablauf, die Bewertungstabellen, die Kapazitätsberechnung, die Berichtsvorlagen und die CI-Regeln zu erhalten. Die Hauptdatei enthält nur den Einstieg und die Schlüsselregeln.
⓪ Vorbereitung → ① Projektprofil → ② Skill-Liste + Kapazitätserfassung → **②-ter Aktivitätsprüfung**
→ ③ Laden der Referenzdaten → ④ Stufenweise Bewertung
→ ④-bis Tiefenlesen → ⑤ Externe Signale + Empfehlung → ⑥ Berichterstellung → ⑥-bis Audit-Verifikation → ⑦ Ausführung → ⑧ Persistierung
Schlüsselregeln
- Profil: Nur das aktuelle Verzeichnis scannen. Schmerzpunkte aus den Datenquellen extrahieren, keine Vermutungen anstellen. Ergebnisse in
{project}/.agents/project-profile.mdschreiben. - Stufeneinteilung: T1 (trifft Kernaktivität) → behalten; T2 (allgemein) → behalten; T3 (spezialisiert) → Archivierung empfehlen.
- Bewertung: Sieben Stufen S/A/B/C/D. Jeder Skill mit einem Grund; kein Grund = nicht bewertet.
- Kapazität: Berechnung der maximalen Kapazität des Agenten. Noch installierbar ≤1 → 🔴, 2-4 → 🟡, ≥5 → 🟢.
- Externe Signale: GitHub⭐ Cache 7 Tage, npm📥 Cache 30 Tage. Bei Netzwerkausfall überspringen und markieren, keine Fälschung erlaubt.
- Empfehlung: Jede mit Konfidenzindex (0-10) + ROI. <7: „In Bewertung“ markieren, <5: nur mit Datenunterstützung empfehlen.
- Ausführung: Nur Skills auf Benutzerebene ändern (editable=true). System-Skills sind schreibgeschützt.
- Goldene Regel: Bei Skill-Entwicklung/-Änderung/-Empfehlung zuerst suchen und verifizieren, ≥2 unabhängige Quellen referenzieren.
- Aktivitätsprüfung: Erstes Audit: vollständige Prüfung. Folgende: nur neu installierte Skills prüfen. Unterbefehl
深度erzwingt vollständige Prüfung. Bei Anomalie: Einzel-Skill-Biopsie auslösen.
Ausgabebeispiel
Nach Auslösung von 技能审查 wird zuerst der 30-Sekunden-Zusammenfassungsblock ausgegeben:
🟢 Zustand der Skill-Bibliothek: Gut
🛠️ Wichtige Aktionen: 1 veralteten Skill aktualisieren, 2 T3-Skills archivieren
💰 Geschätzte Einsparung: ~3200 Tokens/Durchlauf (durch Reduzierung von Skill-Injektionen mit geringem Wert)
Anschließend wird ein Ausschnitt der Bewertungstabelle ausgegeben (Beispiel):
| Skill | Gesamt | Fit | Value | Fresh | Community | ROI | Novelty | Contamination | Empfehlung |
|---|---|---|---|---|---|---|---|---|---|
| codegraph | S | 5 | 5 | 4 | 4 | 5 | 5 | 5 | Behalten, Kernwerkzeug |
| old-linter | C | 2 | 2 | 2 | 3 | 2 | 2 | 4 | Archivierung empfohlen |
Das vollständige Berichtsformat ist in references/report-template.md zu finden.
Regeln zur Projekterkennung
Kernschlussregeln (vollständige Zuordnung in references/project-types.yaml):
package.json→ Web/Node/Full-StackCargo.toml→ Rust ·pyproject.toml→ Python ·go.mod→ Gopom.xml/build.gradle→ Java ·.csproj→ C# ·pubspec.yaml→ FlutterCMakeLists.txt→ C/C++ ·Gemfile→ Ruby- Mehrere
SKILL.md+MEMORY.md→AI Agent Skill-Entwicklung
Randregeln (Kurzreferenz)
- Auslösung: Unabhängiges Wort, keine Auslösung im Satz.
- Stufeneinteilung: T1/T2/T3 basieren ausschließlich auf den „Kernaktivitäten“ des Profils.
- Bewertung: Fünf Stufen S/A/B/C/D. Mit Pflichtgrund; kein Grund = nicht bewertet.
- Tiefenanalyse: Vollständigen Text lesen. Lücken müssen mit Werkzeugen verifiziert werden.
- Bericht: Nur ausgeben, wenn Inhalt vorhanden. Keine Platzhalter für leere Bereiche.
- Empfehlung: Mit Konfidenzindex 0-10 + ROI. <5: nicht empfehlen, Datenunterstützung erforderlich.
- Ausführungsbestätigung: Aktionen erfordern Benutzerbestätigung. System-Skills sind schreibgeschützt.
- Goldene Regel: Erst suchen und verifizieren, ≥2 Quellen.
Plattformkonfiguration und CI/CD
Unterstützte Plattformen: platforms/zcode.yaml · platforms/workbuddy.yaml · platforms/claude.yaml · platforms/codex.yaml · platforms/cursor.yaml · platforms/default.yaml.
CI-Modus (技能审查 --ci oder skills-summarize-audit --ci oder skills-audit --ci): Interaktionsfrei, JSON-Ausgabe, Tiefenlesen übersprungen, unterliegt dem Budget ci.max_tokens in config.yaml. Gate-Logik: health=🔴 → exit_code=1 · actions_required>5 → exit_code=2 · t3_ratio>0.35 → exit_code=3. GitHub Actions-Vorlage in references/ci-github-actions.yml.
SkillSpector-Sicherheitsscan (optional): config.yaml → security_scan aktivieren, Scan-Ergebnisse fließen in die Value-Dimension ein (Critical→D, High→C, bestanden→+0.5 Stufe). SkillSpector ist ein externer Prozess und verbraucht keine Agenten-Tokens.
Dateistruktur
skills-summarize-audit/
├── SKILL.md # Hauptdatei des Skills
├── VERSION # Versionsnummer
├── LICENSE # MIT
├── README.md # Übersicht und Installation
├── config.yaml # Audit-Konfiguration
├── platforms/ # Plattform-spezifische Konfiguration
├── references/ # Referenzdokumente
│ ├── execution-flow.md # Ausführungsablauf-Index
│ ├── flow/ # Detaillierte Schritte je Phase (19 Unterdateien)
│ ├── project-types.yaml # Projekttyp-Zuordnung
│ ├── skill-registry.yaml # Skill-Registrierung
│ ├── deep-analysis-template.md
│ ├── description-quality.md
│ ├── report-template.md
│ ├── ci-output-schema.md
│ ├── ci-github-actions.yml
│ └── recommendation-examples.md
├── tests/ # Testsuite und Verifikationsskripte
├── .data/ # Laufzeitdaten (Logs/Cache/Statistiken/Profile/Externe Signale)
├── install.ps1 / install.sh # Installationsskripte
└── CHANGELOG.md # Änderungsprotokoll
Installation
Ein-Klick-Installation und manuelle Installation siehe references/installation.md (falls nicht vorhanden, siehe README.md).
Nach der Installation mit 技能审查 oder 技能总结 oder skills-summarize-audit auslösen (skills-audit wird weiterhin unterstützt).
Feedback
Lizenz
MIT — siehe LICENSE Datei.