AhmedAttia3/agent-skills

Sanad installieren

Den Benutzer von der Prüfung bis zur verifizierten Sanad-Installation oder -Aktualisierung führen. Die Workflows für Release-Benutzer und Entwickler-Quelle getrennt halten.

Sicherheitsregeln

• Vor jeder Änderung prüfen. Installation, Paketaustausch, Dienstregistrierung, Anwendungsstart und Git-Updates als Mutationen behandeln, die die informierte Zustimmung des Benutzers erfordern.
• Nie das gesamte Home-Verzeichnis oder die Festplatte nach einem Checkout durchsuchen. Nur das aktuelle Verzeichnis, einen vom Benutzer angegebenen Pfad und standardmäßige installierte Befehlsorte prüfen. Nach dem Projektpfad fragen, wenn er nicht sicher identifiziert werden kann.
• Nie ein verschmutztes Repository überschreiben, zurücksetzen, bereinigen, stashen, committen oder verwerfen, es sei denn, der Benutzer autorisiert diese Aktion ausdrücklich.
• Nie Zugriffstoken, Aktualisierungstoken, Anbieteranmeldeinformationen, Signiergeheimnisse oder Benutzerinhalte anfordern, zitieren, protokollieren oder rekonstruieren. Nur für eine ausdrücklich autorisierte, agentengesteuerte Remote-Installation den vollständigen Gerät hinzufügen-Befehl des Benutzers akzeptieren, der sein kurzlebiges, einmalig verwendbares Erstellungstoken enthält. Das offizielle Bootstrap validieren, ohne es in Projektartefakten zu übertragen, zu verfolgen oder zu speichern, und sein Token nie extrahieren/rekonstruieren. Erklären, dass diese Zustimmung die Offenlegung des Erstellungsbefehls im Chat-/Tool-Verlauf abdeckt und dass der generierte Installationsbefehl Token-Argumente verwenden kann; keine Null-Offenlegung behaupten. SSH-Transportargumente ohne Anmeldeinformationen halten. Wenn der Benutzer diese Offenlegung nicht akzeptiert, ihn den Befehl direkt ausführen lassen oder die interaktive Portal-Anmeldung verwenden. Diese Ausnahme gilt nie für dauerhafte Anmeldeinformationen.
• Nur offizielle Sanad-Quellen verwenden:
  • Repository: https://github.com/EastStarAI/sanad-agent
  • Releases: https://github.com/EastStarAI/sanad-agent/releases/latest
  • Installer: https://sanad.eaststarai.com/install.sh und https://sanad.eaststarai.com/install.ps1
• Betriebssystem-Sicherheitskontrollen nicht deaktivieren. Die neuesten Versionshinweise lesen, bevor der aktuelle Signier- oder Plattform-Support beschrieben wird.
• Sanad Home und Benutzerarbeitsbereiche während Installation und Aktualisierung erhalten.

Google Cloud Schnellroute

Für eine Google Cloud / GCP / kostenlose Cloud-Server-Anfrage references/google-cloud-free-tier.md lesen und dieser spezialisierten Release-Benutzer-Route folgen, anstatt die generische lokale/Quell-Fragebogen unten zu wiederholen. Sie besitzt Voraussetzungen, maximal zwei anfängliche Fragen, Ressourcenwiederverwendung, berechtigte Bereitstellung, Just-in-Time-Paarung und minimale integrierte Überprüfung. Die Sicherheitsregeln oben beachten. Keine bedingungslose Null-Rechnung versprechen oder ein bestehendes kostenloses Guthaben duplizieren.

1. Das Zielsystem prüfen

Feststellen, ob Befehle auf dem aktuellen Rechner des Benutzers oder einem entfernten Rechner ausgeführt werden. Nicht annehmen, dass der Rechner, der den Sanad-Client hostet, auch den Sanad-Agenten hosten sollte.

Schreibgeschützte Beweise sammeln:

1. Betriebssystem und Architektur identifizieren.
2. Prüfen, ob sanad und sanad-dev im PATH aufgelöst werden.
3. Die installierte ausführbare Datei prüfen, wenn relevant:
   • macOS/Linux: ${SANAD_HOME:-$HOME/.sanad}/bin/sanad
   • Windows: $env:SANAD_HOME\bin\sanad.exe oder $HOME\.sanad\bin\sanad.exe wenn SANAD_HOME nicht gesetzt ist.
4. Wenn das aktuelle oder angegebene Verzeichnis ein Git-Checkout ist, prüfen: git rev-parse --show-toplevel, git remote -v, git status --short --branch und git worktree list. Es nur als Sanad-Quelle akzeptieren, wenn seine Repository-Identität mit EastStarAI/sanad-agent übereinstimmt oder der Benutzer einen absichtlichen Fork bestätigt.
5. Installierte Versionen und Dienststatus nur über eine aufgelöste Sanad-Ausführbare abfragen. Nicht fehlschlagen, nur weil sanad nicht im PATH ist.

Zusammenfassen, was existiert, bevor eine Änderung vorgeschlagen wird.

2. Workflow auswählen

Wenn die Anfrage des Benutzers den Workflow bereits explizit macht, das Ziel bestätigen und fortfahren. Andernfalls diese Optionen präsentieren und fragen, welche der Benutzer möchte:

Pfad	Am besten geeignet für	Ergebnis	Nachteil
Release / Benutzer	Normale tägliche Nutzung	Verpackter Client und verifizierter Agent-Release	Stabil und einfach; Quelle ist nicht bearbeitbar
Quelle / Entwickler	Beitragen, Debuggen oder Ändern von Sanad	Repository-Checkout ausgeführt über sanad-dev	Bearbeitbar und testbar; erfordert Entwicklungswerkzeuge und mehr Speicherplatz

Für den Release-Pfad die Topologie bestimmen:

• Dieser Desktop: Sanad-Client installieren; Lokal ausführen installiert und startet den passenden Agenten auf demselben Computer.
• Ein anderer Computer oder Server: Client auf Desktop, Mobilgerät oder Web belassen und nur den Sanad-Agenten auf dem Zielrechner installieren.
• Nur Client: Einen Desktop-/Mobil-Client installieren oder den Web-Client verwenden, ohne einen Agenten auf diesem Gerät zu installieren.

Die genauen Aktionen, Ziele und Auswirkungen auf Dienste angeben. Zustimmung einholen, bevor heruntergeladen, installiert, ersetzt, registriert, gestartet oder neu gestartet wird.

3. Release / Benutzer Pfad

Client und lokalen Agenten installieren

1. Das neueste offizielle Release und sein Manifest lesen. Nur das Client-Paket auswählen, das der bestätigten Plattform und Architektur entspricht.
2. Das Artefakt anhand der von diesem Release veröffentlichten Prüfsummen, Signaturen und Plattformrichtlinien überprüfen. Den Signierstatus eines älteren Releases nicht auf das aktuelle Release verallgemeinern.
3. Den Client mit dem normalen Betriebssystem-Workflow installieren. Keine Anwendungsüberprüfungs- oder Sicherheitsabfragen stillschweigend umgehen.
4. Den Benutzer bitten, den Sanad-Client zu starten und Lokal ausführen auszuwählen. Erklären, dass der Client den passenden lokalen Agenten herunterlädt, überprüft, registriert, startet und verbindet; ein Sanad-Konto und ein Paarungstoken sind nicht erforderlich.
5. Überprüfen, dass der Client den lokalen Agenten erreichen kann, bevor der Erfolg erklärt wird.

Für Android, iOS und Web der in den aktuellen Versionshinweisen angegebenen Verfügbarkeit folgen. Diese Plattformen bieten die Schnittstelle, hosten jedoch nicht den nativen Agentendienst.

Einen Agenten auf einem anderen Computer oder Server installieren

Zwei gleichwertige Optionen anbieten:

1. Über Sanad-Client paaren: Einstellungen öffnen, dann auf + neben Geräte in der Einstellungsseitenleiste klicken, um Gerät hinzufügen zu öffnen. Den Benutzer den vollständigen generierten Befehl auf dem Zielrechner ausführen lassen, oder seinen vollständigen generierten Befehl für eine autorisierte Remote-Installation unter der oben genannten Ausnahme für einmalig verwendbare Erstellungstoken akzeptieren. Nie nach den Anmeldeinformationen separat fragen oder den Befehl in Berichte übernehmen.
2. Den Agenten direkt installieren: Portal-Anmeldung oder lokalen Modus auswählen und nach Zustimmung den passenden offiziellen Installer ausführen.

Für ein agentengesteuertes macOS/Linux-Terminal eine mehrdeutige Eingabeaufforderung vermeiden:

curl -fsSL https://sanad.eaststarai.com/install.sh | bash -s -- --login

Stattdessen --no-login verwenden, wenn der Benutzer explizit den lokalen Modus wählt.

Für ein agentengesteuertes Windows PowerShell-Terminal:

& ([scriptblock]::Create((irm https://sanad.eaststarai.com/install.ps1))) -Login

Stattdessen -NoLogin verwenden, wenn der Benutzer explizit den lokalen Modus wählt. Ein Mensch, der einen der Installer interaktiv ausführt, kann die explizite Anmeldeoption weglassen und seine Eingabeaufforderung beantworten.

Die Portal-Anmeldung kann erfordern, dass der Benutzer eine URL öffnet oder einen Code eingibt. Für diese menschliche Aktion pausieren, ohne zurückgegebene Anmeldeinformationen offenzulegen. Nach der Installation die Version und den service status der aufgelösten ausführbaren Datei überprüfen. Das Gerät vom Sanad-Client aus bestätigen, wenn eine Cloud-Verbindung ausgewählt wurde.

Eine paketierte Installation aktualisieren

1. Die installierten Client- und Agent-Versionen prüfen und die neuesten Versionshinweise lesen, bevor sie geändert werden.

2. Den Sanad-Client über den plattformeigenen Aktualisierungsworkflow aktualisieren. Keinen paketierten Client durch Quellausgabe ersetzen.

3. Einen eigenständigen Agenten über die aufgelöste ausführbare Datei aktualisieren:

   sanad update
   

   Den vollständigen Pfad der ausführbaren Datei verwenden, wenn sanad nicht im PATH ist. Wenn der Aktualisierer restart_required meldet, Zustimmung einholen und sanad service restart ausführen.

4. Die endgültige Version, den Dienststatus, die Client-zu-Agent-Verbindung und die Erhaltung von Sanad Home überprüfen. Alle Plattformschritte melden, die manuell bleiben.

4. Quelle / Entwickler Pfad

Das Checkout vorbereiten

Wenn ein passendes Checkout bereits existiert, es nur nach Meldung seines Pfads, Branches, Worktrees, Remotes und schmutzigen Zustands verwenden. Kein Duplikat stillschweigend klonen.

Wenn kein Checkout existiert, ein Ziel vorschlagen und Zustimmung einholen, dann ausführen:

git clone https://github.com/EastStarAI/sanad-agent.git sanad-agent
cd sanad-agent

Die Repository-Dateien AGENTS.md, docs/llms.txt und die nächsten verschachtelten Verträge lesen, bevor weitere Arbeiten durchgeführt werden. FVM für jede Dart- oder Flutter-Operation verwenden.

Den benutzerspezifischen Entwicklungsbefehl einmal installieren.

Auf macOS/Linux:

scripts/sanad-dev install

Auf Windows PowerShell:

.\scripts\sanad-dev.ps1 install

Dann das passende Agent- und Client-Paar auf jeder Plattform ausführen:

sanad-dev run

sanad-dev run --no-cloud nur verwenden, wenn der Benutzer explizit lokale Entwicklung wünscht. sanad-dev status und begrenzte sanad-dev logs agent -n 50 und sanad-dev logs client -n 50 Aufrufe zur Überprüfung verwenden. Nie den Log-Folgemodus von einem KI-Tool-Aufruf aus verwenden.

Ein Entwickler-Checkout aktualisieren

1. Den aktiven Branch, Upstream, Worktrees und schmutzige Dateien prüfen.
2. git fetch nur ausführen, nachdem das beabsichtigte Remote bestätigt wurde. Eingehende Commits vor der Integration erklären.
3. Für ein sauberes Checkout auf dem beabsichtigten Tracking-Branch git pull --ff-only vorschlagen. Keine Merge-Commits implizit erstellen.
4. Bei einem schmutzigen Checkout anhalten und Erhaltungsoptionen präsentieren. Nicht stashen, committen, rebasen, wechseln, zurücksetzen oder verwerfen ohne ausdrückliche Autorisierung.
5. Nach einem erfolgreichen Quell-Update das plattformspezifische sanad-dev install erneut ausführen; dann sanad-dev run oder den vom Benutzer angeforderten begrenzten Überprüfungsbefehl verwenden.
6. Nie sanad update für eine Quell-/FVM-Runtime verwenden; Quell-Updates gehören zu Git und sanad-dev.

5. Ergebnis melden

Melden:

• ausgewählter Workflow und Zielrechner;
• erkannte und endgültige Versionen;
• Client-, Agent-, Repository- und Dienststatus;
• Überprüfungsbefehle und -ergebnisse;
• noch erforderliche manuelle Benutzeraktionen;
• geänderte Dateien, Dienste oder Git-Zustand.

Nie Erfolg allein aus einem Download oder Befehlsbeenden behaupten. Den relevanten Dienst- oder Client-zu-Agent-Gesundheitsnachweis verlangen. Keine Benutzerdaten committen, pushen, veröffentlichen oder entfernen, es sei denn, der Benutzer hat diese separate Aktion ausdrücklich angefordert.