Wird geladen

Baue einen 'Ask the Company'-Agenten

Klartext-Antworten über dein Wiki, deinen Code und dein Data Warehouse.

10 Min.EngineeringClaude Cowork
Wird geladen

Einrichtung

Probiere ein Plugin aus

Das Engineering-Plugin wird mit /documentation als Ausgangspunkt ausgeliefert, bereits so strukturiert, dass es sich über verbundene Quellen verteilt, das Gefundene zitiert und einen Verantwortlichen nennt, wenn es sich nicht sicher ist. Wenn dein Admin Plugins verwaltet und es noch nicht verfügbar ist, überspringe diesen Schritt; nichts im Folgenden setzt es voraus.

EngineeringStreamline engineering workflows — standups, code review, architecture decisions, incident response, and technical documentation. Works with your existing tools or standalone.
Hinzufügen
/documentationWrite and maintain technical documentation.
In Cowork öffnen
/architectureCreate or evaluate an architecture decision record (ADR).
In Cowork öffnen

Verbinde deine Tools

Claude Cowork ist leistungsfähiger, wenn es direkt mit deinen Systemen arbeitet. Du kontrollierst Berechtigungen und Zugriff. Erfahre mehr über den Tool-Zugriff.

Navigiere in Cowork zu Customize → Connectors, um die Einrichtung vorzunehmen.

Confluence
Durchsuche zuerst das Wiki und die Runbooks nach der dokumentierten Antwort. Der Confluence-Zugriff erfolgt über den Atlassian-Rovo-Konnektor (Jira und Confluence).
Verbinden
GitHub
Lies Code, READMEs und CODEOWNERS, um Fragen wie „Wie funktioniert X" und „Wer besitzt X" zu beantworten.
Verbinden
SnowflakeOptional
Frage das Data Warehouse für Fragen wie „Wie viele" und „Warum hat sich die Kennzahl verändert" ab.
Verbinden

Lege deinen Arbeitsordner fest

Ziehe die Dateien, die den Agenten verankern (dein Service-Katalog-Export, das Team-Verzeichnis, das Glossar, das „Wo finde ich was"-Onboarding-Dokument), in einen Ordner und richte Cowork darauf aus. Diese werden zur Routing-Tabelle, die der Agent konsultiert, bevor er anderswo sucht. Erstelle ein Cowork-Projekt aus diesem Ordner, damit der Katalog und die Grundregeln angehängt bleiben, während sich der Agent weiterentwickelt.

Platform / ask-company
service-catalog.yamlApr 18, 202694 KB
glossary.mdMar 2, 202611 KB
team-directory.mdApr 1, 20266 KB
In der Chatleiste von Cowork:Platform / ask-company

Der Prompt

Kopiere dies in Claude Cowork

Baue einen internen „Frag alles"-Agenten für Entwickler. Wenn jemand fragt „Wie bekomme ich einen Staging-API-Key", „Was gehört zur orders-Tabelle" oder „Warum haben sich die Deployments im letzten Monat verlangsamt", finde die Antwort über unsere Systeme hinweg, gib die Quelle an, und sag ihnen, wen sie fragen sollen, wenn du dir nicht sicher bist. Finde zuerst eine gute Antwort, dann mach daraus einen gemeinsam genutzten Skill.

Platform / ask-company

Warum das funktioniert

Prompt

Gib für jeden Fragetyp ein Beispiel. Eine Anleitung, eine Eigentümer-Abfrage, ein Kennzahlen-Warum: deckt die Fragetypen ab, die Entwickler tatsächlich stellen.

Prompt

Gib jedes Mal die Quelle an. Entwickler vertrauen dem Link, nicht dem Fließtext; Zitate machen die Antwort überprüfbar.

Prompt

Nenne einen Verantwortlichen, wenn du dir unsicher bist. Die Bitte um „das zuständige Team oder den Channel" gibt Claude etwas, auf das es zurückgreifen kann, wenn es sich nicht sicher ist. Du erhältst einen Hinweis, dem du nachgehen kannst, statt eine Vermutung, die du überprüfen musst.

Quelle

Lege Referenzdokumente in den Arbeitsordner. Service-Katalog und Team-Verzeichnis sagen Cowork, wo es suchen und auf wen es verweisen soll.

Erhalte einen besseren Entwurf

Übung

Füge ein passendes Beispiel hinzu. Lege ein Beispiel, das dir gefällt, in den Ordner, und Cowork passt sich deiner Struktur und deinem Ton an.

Übung

Bitte es, Unsicherheiten zu kennzeichnen. Füge „kennzeichne alles, bei dem du dir nicht sicher bist" hinzu, damit du weißt, wo du zuerst nachsehen solltest, wenn du den Entwurf überprüfst.

Lass Cowork für dich arbeiten

Das /documentation des Plugins ist ein generischer Ausgangspunkt. Sobald Schritt 2 deine drei Fragen gut beantwortet, sag Cowork, deine Version des Skills zu schreiben. Lege fest, welche Spaces und Repos zuerst durchsucht werden sollen, die „Ich bin mir nicht sicher"-Schwelle, den Ton und die Systeme, die tabu sind. Ein paar Minuten Unterhaltung, und der Skill spricht von da an deinen Stack.

Mach aus dem, was wir in dieser Aufgabe bisher gemacht haben, einen Skill, oder bearbeite den /documentation-Skill mit meinem Feedback.

Platform / ask-company

Mach es wiederholbar

Teile es als Artefakt

Sobald der Agent deine Testfragen gut beantwortet, veröffentliche ihn als Artefakt, damit jeder in der Organisation einen Link zum Fragen hat. Das Artefakt führt im Hintergrund den gemeinsam genutzten Skill aus; das Platform-Team besitzt den Skill und optimiert ihn weiter.

Protokolliere jede Frage, die es nicht beantworten konnte

Der Agent wird besser, wenn du weißt, wo er Schwächen hat. Gib /schedule ein oder öffne Scheduled in der Cowork-Seitenleiste, und ein wöchentlicher Lauf schreibt die unbeantworteten Fragen in deinen Ordner, damit das Platform-Team die Lücken schließen kann.

/schedule Liste jeden Freitag um 16 Uhr die Fragen auf, die /documentation diese Woche nicht sicher beantworten konnte, gruppiere sie nach Thema und schreibe sie nach Platform/ask-company/gaps-<week>.md mit einem vorgeschlagenen Verantwortlichen für jede.

Platform / ask-company
Geplante AufgabeAktiv
Ask-Company-Lückenbericht

Wöchentlich listet es die Fragen auf, die der Agent nicht beantworten konnte, gruppiert sie nach Thema und schreibt einen Lückenbericht mit vorgeschlagenen Verantwortlichen.

Freitags um 16:00 UhrIn Cowork öffnen

Teile es mit deinen Teammitgliedern

Dein angepasstes /documentation trägt jetzt deine Quellen, deine Routing-Tabelle und deine Sicherheitsregeln. Teile es im gesamten Workspace, damit jeder Entwickler das Unternehmen auf die gleiche Weise fragt und die Antwort auf „Wie mache ich…" nicht mehr davon abhängt, wer im Channel ist.

Was sich für die Organisation ändert