RafaelFerSilva/refinement-agent-skills

Verwandelt ein Meeting-Transkript in prüfbare Protokolle: Entscheidungen und Maßnahmen mit Herkunftsnachweis, mutmaßliche Zustimmungen zur asynchronen Bestätigung, Maßnahmen in JSON und Input für die Anforderungsanalyse.

Was ist refinement-agent-skills?

Diese Fertigkeit verarbeitet Transkripte von Meetings und erzeugt daraus vollständig nachvollziehbare, prüfbare Protokolle. Sie stellt sicher, dass jede aufgezeichnete Entscheidung und jeder Aktionspunkt auf die entsprechende Stelle im Transkript zurückgeführt werden kann, und trennt explizit Gesagtes von bloßen Annahmen. Unterstützt werden die Sprachen Englisch (en-US) und Portugiesisch (pt-BR), konfigurierbar über die Datei `docs/agents/refinement.md`. Die Fertigkeit eignet sich für CI/CD-Pipelines, CLI-Umgebungen und KI-Agenten wie Claude Code, Cursor oder Codex. Sie analysiert das Transkript, identifiziert Entscheidungen und Aufgaben, erstellt ein strukturiertes Protokoll nach einer vorgegebenen Vorlage und generiert zusätzlich JSON-Ausgaben sowie Fragebögen für ungeklärte Punkte. Inhalte mit Anforderungsbezug werden automatisch in eine Discovery-Datei extrahiert. Ein abschließender Selbstprüfungsmechanismus stellt die Konsistenz zwischen Protokoll, JSON und der Transkript-Referenzierung sicher. Die Fertigkeit arbeitet streng nach den Regeln für Quellennachweise (`STATED`, `ASSUMED`, `TO BE DEFINED`), um die Integrität der Aufzeichnung zu gewährleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RafaelFerSilva/refinement-agent-skills/tree/HEAD/skills/meeting-minutes

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Meeting-Protokolle

Verarbeiten Sie ein Transkript und erstellen Sie ein strukturiertes, prüfbares Protokoll. Protokolle werden zu Tatsachen: Drei Wochen später wird jemand dieses Dokument als Beweis dafür anführen, was vereinbart wurde. Deshalb ist alles, was Sie aufzeichnen, auf das Transkript zurückführbar, und alles, was Sie annehmen, bleibt sichtbar getrennt von dem, was explizit gesagt wurde. Aufzeichnen ist Zertifizieren; Ihre Analyse darf sich niemals als Rede eines Teilnehmers tarnen.

Dieser Workflow ist Synthese ohne Befragung: Das Meeting hat bereits stattgefunden. Offene Fragen werden über Fragebögen an ihre Empfänger gerichtet, und Anforderungsinhalte fließen in /requirements-discovery.

Transkript: $ARGUMENTS

Herkunftsgrenze

Fundiert in requirements-rigor, nimmt die Herkunft hier drei Formen an:

  • [STATED: Sprecher, „kurze Paraphrase“] (en-US: [STATED: speaker, "short paraphrase"]): im Transkript gesagt. Jede Aktion, Entscheidung und Priorität trägt den Sprecher und eine 5 bis 15 Wörter umfassende Paraphrase. Eine ehrliche Paraphrase genügt für die Prüfung.
  • [ASSUMED: Basis] (en-US: [ASSUMED: basis]): Ihre Analyse hat dies aus Gesprächsmustern abgeleitet: Stille nach einem Vorschlag, mehrdeutiges „ok“, eine Aufgabe, die durch eine Entscheidung impliziert wurde, die niemand explizit übernommen hat. Angenommene Elemente gelangen nie in Entscheidungen, die Maßnahmentabelle oder das JSON; sie leben in Abschnitten für Annahmen, mit dem Auszug und der Person, die bestätigen muss.
  • [TO BE DEFINED] (en-US: [TO BE DEFINED]): Zuständiger oder Frist weder genannt noch ableitbar. Der Platzhalter ist die korrekte Antwort.

Kurztest: „Wenn ein Teilnehmer diese Zeile liest und sagt ‚Das habe ich nie gesagt‘, kann ich auf den Auszug verweisen?“ Ja: STATED. „Er hat es nicht direkt gesagt, aber impliziert“: ASSUMED. Weder noch: TO BE DEFINED, oder vom Protokoll ausgeschlossen. Weitere Markierungen aus requirements-rigor, wie [INFERENCE: Basis], bleiben gültig.

Schritte

  1. Metadaten. Lesen Sie docs/agents/refinement.md im Arbeitsbereich, um die konfigurierte Sprache (en-US oder pt-BR, Standard en-US) und den Veröffentlichungspfad zu identifizieren. Protokolle, Fragebögen und generierte Eingaben folgen dieser Sprache. Identifizieren Sie Titel, Datum, Dauer, Teilnehmer mit Rollen, Projekt und durch automatische Transkription verzerrte Glossarbegriffe. Das Datum ist zwingend erforderlich: Die Fristberechnung hängt davon ab. Wenn es fehlt, fragen Sie in einer einzelnen Zeile, bevor Sie fortfahren. Lesen Sie CONTEXT.md für Glossarbegriffe, falls vorhanden. Abgeschlossen, wenn: Datum und Teilnehmer festgestellt sind.

  2. Triage. INTACT (durchgehendes Audio, identifizierbare Sprecher), DEGRADED (unverständliche Abschnitte, falsch zugeordnete Sprecher, Schnitte), INSUFFICIENT (zu kurz oder nicht das Meeting aus den Metadaten). INSUFFICIENT: Grund nennen und anhalten; Fassadenprotokolle dürfen nicht als offizielle Aufzeichnungen in Umlauf gebracht werden. DEGRADED: Jede Lücke, die eine Aktion oder Entscheidung enthalten haben könnte, wird zu einer offenen Frage („unverständlicher Abschnitt bei ~12min nach Vorschlag von X“); Lücken werden nie rekonstruiert. Verzerrte Terminologie: Glossarschreibweise anwenden und [MÖGLICHER TRANSKRIPTIONSFEHLER: original -> übernommen] in Abschnitt 0 markieren; im gesamten Textkörper nur den übernommenen Begriff verwenden. Persönliche Details, Gesundheit, Familie, Bemerkungen über abwesende Kollegen: aus allen Abschnitten weglassen; eine Projektverpflichtung, die in einen persönlichen Kontext eingebettet ist, wird ohne die Umstände aufgezeichnet. Nicht identifizierter Sprecher mit Verpflichtung: Zuständiger [TO BE DEFINED: nicht identifizierter Sprecher bei ~Xmin] und offene Frage. Ein Hinweis, dass persönlicher Inhalt weggelassen wurde, darf ohne Details in der Triage erscheinen; Fristen, die nur im persönlichen Kontext genannt wurden, werden textlich ohne persönliche Umstände beibehalten. Abgeschlossen, wenn: die Triage in Abschnitt 0 mit erkannten Transkriptionsfehlern aufgezeichnet ist.

  3. Extrahieren. Wenden Sie die Regeln aus RULES.md an: Widerruf und Überholung, Maßnahmengranularität, Priorität mit Herkunft, was als Entscheidung zählt. Abgeschlossen, wenn: jede Entscheidung und jeder Aktionspunkt eine STATED-Herkunft trägt und Annahmen strikt in den Abschnitten 4 oder 5 leben.

  4. Protokoll schreiben gemäß TEMPLATE.md. Im „Aktionsmodus“ nur die Abschnitte 3, 6 und 7 schreiben. Abgeschlossen, wenn: die Datei unter .scratch/<Projekt>-<JJJJ-MM-TT>/minutes.md existiert (oder wo in docs/agents/refinement.md konfiguriert), mit abschließendem Haftungsausschluss.

  5. Selbstprüfung und Bericht in einer einzelnen Zeile in Abschnitt 8: Jede tatsächliche Aktion in der Tabelle hat ein passendes JSON-Objekt und kein JSON-Objekt existiert außerhalb der Tabelle; jede Zeile und Entscheidung trägt STATED; kein ASSUMED ist in Tabelle oder Entscheidungen gelangt; Prioritäten stimmen zwischen Tabelle und JSON überein; JSON-Daten sind ISO oder null. Abgeschlossen, wenn: Abschnitt 8 „Self-Audit: OK“ angibt oder Korrekturen detailliert.

  6. Offene Punkte weiterleiten. Mutmaßliche Zustimmungen und offene Fragen mit Empfängern außerhalb der Sitzung: einen Fragebogen pro Empfänger gemäß QUESTIONNAIRE.md in requirements-rigor zusammen mit dem Protokoll schreiben und von dem erzeugenden Abschnitt aus verlinken. Auszüge mit Anforderungsinhalt (genannte Bedürfnisse, Fähigkeiten, Einschränkungen): discovery-input.md zusammen mit dem Protokoll schreiben, der Vorlage am Ende von TEMPLATE.md folgend, und den Benutzer anweisen, dass /requirements-discovery damit beginnt. Abgeschlossen, wenn: jede mutmaßliche Zustimmung einen Empfänger und Fragebogen hat, und Discovery-Input existiert, wenn das Meeting Anforderungsinhalt enthielt.

Abschließender Hinweis

⚠️ Dieses Protokoll ist ein KI-generierter Entwurf, der aus einem Transkript erstellt wurde. Es erfordert die Validierung durch die Teilnehmer, bevor es als offizielle Aufzeichnung in Umlauf gebracht wird, insbesondere bei mutmaßlichen Zustimmungen, die nicht explizit geäußert wurden und einer Bestätigung bedürfen.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills