dkharlanau/agent-ready-web-profile

ARWP-Evidenz und CI

Verwenden Sie diesen Skill, nachdem eine Site vorbereitet wurde, oder wenn ein Team sicherstellen möchte, dass die ARWP-Qualität langfristig stabil bleibt.

Arbeitsablauf

1. Vertrag festlegen.

   • Identifizieren Sie die öffentlichen Schnittstellen, von denen der Publisher erwartet, dass sie verfügbar bleiben.
   • Verwenden Sie arwp assert für erforderliche/optionale/verbotene Absichten und Protokollerwartungen.
   • Vermeiden Sie einen universellen Bereitschaftswert.

2. Regelmäßige Qualitätsprüfungen hinzufügen.

   • Führen Sie arwp audit für quellgestützte Such-/KI-/Agentenempfehlungen aus.
   • Führen Sie arwp-growth aus, um ein priorisiertes Verbesserungs-Backlog zu erstellen.
   • Führen Sie zuerst Site-Build/Lint/Tests aus, wenn die lokale Metadatengenerierung Teil des Deployments ist.
   • Verwenden Sie einen wöchentlichen Rhythmus, es sei denn, die Site ändert sich so schnell, dass ein anderer Rhythmus gerechtfertigt ist.

3. Dauerhafte Belege für wichtige Zustände erfassen.

   • Verwenden Sie arwp-receipt capture <url> für explizite Evidenzbeobachtungen mit höherer Sicherheit.
   • Bewahren Sie Beleg-IDs und unveränderliche historische Aufzeichnungen auf.
   • Trennen Sie project-reference, independent-benchmark und andere Evidenzklassen.
   • Betrachten Sie die Beobachtung einer öffentlichen Site niemals als Beweis dafür, dass der Publisher ARWP eingeführt hat.

4. Drift verfolgen.

   • Verwenden Sie Resolver-Snapshots und arwp drift, wenn die Schnittstellenauswahl/kanonische Identität eine Rolle spielt.
   • Lassen Sie CI bei explizitem Vertragsbruch fehlschlagen, nicht bei optionalen Möglichkeiten.
   • Bewahren Sie negative Ergebnisse und Regressionen auf, anstatt sie stillschweigend zu entfernen.

5. Provenienz sorgfältig anfügen.

   • Zeichnen Sie Commit-/Workflow-/Release-IDs nur auf, wenn sie tatsächlich verfügbar sind.
   • Verknüpfen Sie SBOM-/Attestierungsnachweise nur mit dem exakt passenden Artefakt.
   • Ein gültiger SHA-256-Beleg beweist die Integrität des Belegs, nicht Wahrheit, Autorisierung, Zustimmung des Publishers oder Sicherheit.

6. Plattformmetriken extern halten.

   • Google Search Console-KI-Metriken, Bing AI Performance, ChatGPT-Referral-Daten und ähnliche nur für Eigentümer zugängliche Analysen sind Evidenzeingaben.
   • Speichern Sie Vorher/Nachher-Beobachtungen mit Daten und Umfang.
   • Behaupten Sie nicht, dass ARWP Ranking-/Zitierungsänderungen verursacht hat, ohne kontrollierte Evidenz.

7. CI-Qualität überprüfen.

   • Fixieren/genehmigen Sie Aktionsversionen entsprechend der Repository-Richtlinie.
   • Halten Sie Berechtigungen lesend, es sei denn, ein spezifischer Schreibzugriff ist erforderlich.
   • Platzieren Sie niemals Geheimnisse in Artefakten, Fixtures, Belegen oder Logs.
   • Stellen Sie sicher, dass generierte öffentliche Artefakte sich bei praktischer Anwendung mit einer Null-Differenz reproduzieren lassen.

Empfohlene GitHub Actions-Ausgaben

Veröffentlichen Sie Artefakte wie:

• arwp-audit.json
• arwp-growth.json
• arwp-receipt.json
• Resolver-Snapshot/Drift-Berichte

Verwenden Sie die Jobzusammenfassung für prägnante P0/P1-Ergebnisse. Lassen Sie den Build nicht fehlschlagen, nur weil eine rein optionale Funktion wie Preferred Sources oder ein experimentelles Protokoll fehlt.