CommunitySchreiben & Editierengithub.com

Forschungsprojekt iterieren — Skills für das Forschung-Portfolio

Skill zum Führen eines einzelnen Forschungsprojekts mit iterativen Experimenten, Projektboard und optionaler Portfolio-Synchronisation.

Was ist Forschungsprojekt iterieren — Skills für das Forschung-Portfolio?

Dieser Skill definiert ein vollständiges System zur Verwaltung eines Forschungsprojekts mit wiederholten Experimenten (Attempts). Er zwingt zu einer klaren Klassifikation neuer Arbeiten: Diskussionen und Methodennotizen landen in `1-Docs/`, konkrete Experimente in `0-Project/<Datum>_<Slug>/`. Ein zentrales `PROJECT_BOARD.html` wird nur dann aktualisiert, wenn sich Status, nächste Aktion, Blocker oder andere für Kollaborateure relevante Zustände ändern (Sync-Skala Level 0–3). Alle dateibasierten Quellen (`_ai/project_overview.md`, `_ai/findings.md`, `_ai/task_plan.md`) sind der Board-Vorlage übergeordnet; das Board ist eine Karte, kein Log. Der Skill kann standalone für ein einzelnes Projekt oder als Teil eines Portfolios (`<slug>-project/<project>/`) verwendet werden, wobei dann mit dem `manage-research-portfolio` Skill eine optionale Synchronisation auf das Portfolio-Dashboard erfolgt. Drei Unterprojekt-Spuren organisieren den Fortschritt: Mainline (aktive Attempts), Parked (zukünftige Ideen) und Archived (aufgegebene oder abgelöste Attempts mit Stoppgrund und Beleg).

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add jiangjin1999/codex-research-project-skills

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Iteriere Forschungsprojekt

Verwende diesen Skill, um ein Forschungsprojekt ehrlich zu halten, während es sich verändert. Die Kerngewohnheit ist: klassifiziere die Arbeit, schreibe an den engsten dauerhaften Ort, dokumentiere Belege, und synchronisiere nur die Zusammenfassungen und das Board, die Kollaborateure brauchen.

Zwei Regeln durchziehen alles:

  1. Markdown zuerst, Board zweitens. Aktualisiere zuerst die Markdown-Quelle oder die _ai-Notiz. Erst dann synchronisiere PROJECT_BOARD.html.
  2. Das Board ist eine Karte, kein Log. PROJECT_BOARD.html zeigt den aktuellen Stand und verweist auf Belege. Es speichert niemals Rohlogs, private Daten oder absolute Pfade.

Und eine Gewohnheit, die die Iteration vorantreibt: neue Idee → neues Unterprojekt. Versuchsversuche sind das Herz der Arbeit. Wenn etwas ausprobiert werden soll, erstelle ein frisches 0-Project/<Datum>_<Slug>/ und iteriere dort, anstatt einen Versuch zu überschreiben oder endlos zu wiederholen. Halte Unterprojekte klein und zweckgebunden; fürchte keine Duplikate. So bleibt die Geschichte append-only und vergleichbar (siehe references/project-iteration-system.md).

Unterprojekte haben auch Spuren:

  • Mainline — aktuelle Versuche, die den aktiven Pfad definieren.
  • Parked — zukünftige Versuchsideen, die früh erfasst werden, weil Forschung nicht vollständig seriell abläuft, aber noch nicht ausgeführt werden. Standardnotiz: 0-Project/_parking-lot.md.
  • Archived — aufgegebene oder abgelöste Versuche, die mit einem Stoppgrund und Beleg aufbewahrt werden. Standardordner: 0-Project/_archive/.

Parke günstig. Eine zukünftige Idee kann ein kurzer Eintrag in _ai/task_plan.md, 1-Docs/ oder 0-Project/_parking-lot.md sein; erstelle einen vollständigen Versuchsordner nur, wenn die Idee genügend Eingaben, Kriterien oder Übergabewert hat.

Leite Diskussion und Versuche getrennt: Diskussion, Entscheidung, Vergleich und Methodenerklärung gehen nach 1-Docs/<Datum>_<Thema>.md; konkrete Versuche mit Eingaben, Kriterien, Ausgaben oder Ergebnissen gehen nach 0-Project/<Datum>_<Slug>/; versuchsinterne Diskussion geht nach 0-Project/<Versuch>/docs/<Datum>_<Thema>.md.

Eigenständig oder innerhalb eines Portfolios. Dieser Skill ist in sich abgeschlossen: Verwende ihn allein für ein einzelnes Projekt an einem beliebigen Pfad – kein Portfolio erforderlich. Alles, was das Projekt braucht (Ordner, Einstiegsdateien, Board, Arbeitsgedächtnis, Git-Richtlinien), lebt innerhalb des Projektordners. Optional, wenn das Projekt in einem Portfolio liegt (<slug>-project/<project>/), synchronisiere Status, Eigentümer, Priorität und öffentlichen Zustand mit dem manage-research-portfolio Skill auf das Portfolio-Dashboard. Im eigenständigen Betrieb überspringe jeden „Portfolio-Dashboard“ und „Registry“-Schritt in diesem Skill – sie sind optionale Integrationen, niemals Voraussetzungen.

Projektvertrag

Verwende diese Struktur, sofern das Projekt nicht bereits äquivalente Namen hat. Es ist das kopierbare _PROJECT_TEMPLATE-Grundgerüst.

<projekt>/
├── README.md              Einstieg: Ein-Satz-Ziel, Ordnerkarte, Schnellstart, aktueller Status
├── PROJECT_GUIDELINES.md  projektspezifische Synchronisationsregeln, Ordnergrenzen, HTML-Klassifikation
├── PROJECT_BOARD.html     das Board (看板): Karte des aktuellen Zustands und Navigation
├── GIT_WORKFLOW.md        Git-Identität + Commit-Richtlinie pro Änderung für dieses Projekt
├── scripts/
│   └── init_project_git.sh   optionaler Helfer, um Identität und ersten Commit zu setzen
├── 0-Project/             konkrete Versuche / Experimente (ein 0-Project/<Datum>_<Slug>/ pro Versuch)
├── 1-Docs/
│   └── README.md          der einzige feste Docs-Eintrag + Themenindex
├── 2-Data/
│   └── DATA.md            Quelle, Herkunft, Berechtigungen, Versionen, Schema, Qualitätskontrolle, Grenzen
├── 3-Paper_Survey/
│   └── README.md          Leseliste, Paper-Notizen, Evidenzmatrix, Methodenquellen
├── 4-Skills/
│   └── PROJECT_SKILLS.md  projektspezifische Prompts, KI-Regeln, wiederverwendbare Verfahren
└── _ai/
    ├── project_overview.md   Ziel, Umfang, Status, Eigentümer, Priorität, Nächstes
    ├── project_board_spec.md Wie PROJECT_BOARD.html aus Quellen erzeugt/synchronisiert wird
    ├── task_plan.md          Aktuelle Phase, Plan, Blocker, Nächstes
    ├── findings.md           Stabile Erkenntnisse, offene Fragen
    └── progress.md           Letzte sinnvolle Synchronisation, Aktionen, Validierung, Commit

Die Wurzeldateien sind Einstieg + Regeln + Board + Git-Richtlinie. Alles Konkrete geht in den am besten passenden nummerierten Ordner; häufe niemals Materialien im Projektstamm an und lege niemals die Projektübersicht, Board-Regeln oder langfristige Richtlinien in 0-Project/ ab (dieser Ordner ist nur für konkrete Versuche).

Vor dem Schreiben klassifizieren

Wenn der Benutzer neues Material bereitstellt, wähle einen Zielort und entscheide dann, ob das Board geändert werden muss.

Absicht des BenutzersZielortMögliche Board-Ansicht
„Das ist eine Diskussion / Methode / Entscheidung / Vergleich“1-Docs/<Datum>_<Thema>.md + aktualisiere 1-Docs/README.mdDokumentenlandkarte (文档地图)
„Das ist ein konkretes Experiment / ein konkreter Versuch“0-Project/<Datum>_<Slug>/; versuchsinterne Notizen unter docs/ ablegenAufgaben (任务尝试)
„Das ist eine Notiz über einen bestehenden Versuch“0-Project/<Versuch>/docs/<Datum>_<Thema>.mdnormalerweise Aufgaben, manchmal Dokumentenlandkarte, falls sich der projektweite Index ändert
„Das ist eine Idee für einen zukünftigen Versuch“_ai/task_plan.md, 1-Docs/ oder 0-Project/_parking-lot.md; vollständigen Versuchsordner nur, wenn konkretnormalerweise keine, oder eine geparkte Aufgaben-Spur
„Dieser Versuch wird aufgegeben / abgelöst“Behalte den Versuchsordner oder verschiebe ihn unter 0-Project/_archive/; archiviere mit Stoppgrund, Beleg und Ersatzarchivierte/eingeklappte Aufgaben-Spur
„Das sind Daten / Benchmark-Informationen“2-Data/DATA.mdMaterialien (数据材料)
„Das ist ein Paper / eine externe Quelle / ein Beleg“3-Paper_Survey/README.md + EvidenzmatrixReferenzen (参考文献)
„Das ist ein wiederverwendbarer Workflow / Prompt / eine KI-Regel“4-Skills/PROJECT_SKILLS.md(normalerweise keine)
„Das ändert Status / nächste Aktion / Blocker“_ai/project_overview.md, _ai/task_plan.mdObenliegende Übersicht + Fortschritt (项目进度)

Wenn die Klassifikation den Projektumfang, Bewertungskriterien, Datengrenzen, öffentliche Sichtbarkeit oder die Zugehörigkeit eines Versuchs zum Projekt ändert, frage nach, bevor du sie als bestätigt behandelst. Bei risikoarmer Benennung/Formatierung wähle die konservative Option und dokumentiere die Annahme in _ai/progress.md.

Das Board (看板)

PROJECT_BOARD.html ist das einzelne Projektboard. Es beantwortet auf einen Blick: Was ist dieses Projekt, was ist aktuell, was hat sich geändert, wo sind die Belege und wo geht es weiter. Es ist mit den Ordnern koordiniert – jede Ansicht wird von einem bestimmten Ordner oder einer _ai-Datei gespeist.

Grundelemente:

  • Startseite / Zurück-Link (dauerhaft): ein Link ganz vorne auf der Seite im oberen linken Markenbereich. Innerhalb eines Portfolios gestalte ihn als Zurück zum Dashboard mit Link zur Stammseite /; eigenständig entweder weglassen oder auf das eigene README.md des Projekts verweisen. Behalte bei, was du beim Erstellen, Kopieren, Veröffentlichen oder Aktualisieren der Seite wählst.

  • Versionsstatus: Seitenversion YYYY-MM-DD-vN und letzter Synchronisationsmarker (optional ein Aktualitäts-/Aktualisierungssteuerelement).

  • Obere Übersicht (immer sichtbar, leicht): Projektname, Ein-Satz-Beschreibung, Status, Eigentümer, letzte Synchronisation, aktueller Fokus und höchstens eine kurze Fortschrittszeile. Quelle: _ai/project_overview.md. Führe hier keine Phasenlisten, Versionskarten, Versuchslisten oder langfristigen Routen auf.

  • Fünf sich gegenseitig ausschließende Ansichten, jede einem Ordner zugeordnet:

    AnsichtGespeist vonZeigt
    Fortschritt (项目进度)_ai/progress.md, _ai/findings.md, 1-Docs/README.mdnur projektweite größere Änderungen: Ziel, Umfang, Phase, Schlüsselergebnis, Urteil, öffentlicher Zustand, kompakte Versionszusammenfassung
    Dokumentenlandkarte (文档地图)1-Docs/README.md + WurzelstrukturThemenindex der Dokumente + ein Strukturbaum im VS Code-Explorer-Stil (Wurzelebene-1-Dateien/-Ordner und Ebene-2 über <details>/<summary>), nur öffentlich sichere Namen
    Aufgaben (任务尝试)0-Project/<Versuch>/zuerst Mainline-Versuche; geparkte zukünftige Versuche und archivierte/veraltete Versuche nur in separaten eingeklappten Spuren
    Materialien (数据材料)2-Data/DATA.mdDatenblöcke, Öffentlichkeit, Version, Qualität, Nutzungsgrenzen
    Referenzen (参考文献)3-Paper_Survey/README.mdPaper, Methodenquellen, Evidenzstatus, Auswirkungen; nur wenn es Inhalt gibt

Board-Regeln: erfinde keine Eigentümer, Status, Prioritäten oder zukünftigen Phasen; füge keine eigenständige „Nächster Schritt“-Ansicht hinzu (nächste Aktion lebt in der oberen Übersicht, _ai/task_plan.md oder einem Versuch); verwende eingeklappte <details> für Versuche und den Strukturbaum; halte es eine ruhige Forschungswerkbank, keine Landing Page. Zukünftige Ideen und aufgegebene Versuche dürfen nicht visuell mit dem aktiven Pfad konkurrieren. Die Erzeugungsregeln leben in _ai/project_board_spec.md. Siehe references/project-board.md für den vollständigen Vertrag.

Iterationsschleife

  1. Stelle den Kontext wieder her aus _ai/project_overview.md, _ai/project_board_spec.md, _ai/task_plan.md, _ai/findings.md, _ai/progress.md und dem entsprechenden Ordner-README.
  2. Bestätige die Git-Identität des Bedieners, bevor du Projektdateien bearbeitest; falls nicht vorhanden, bitte den Benutzer, seine eigene zu konfigurieren, und pausiere.
  3. Benenne die aktuelle Iteration in einem Satz: Frage, Versuch oder Entscheidung.
  4. Erstelle oder aktualisiere zuerst die engste Quelldatei.
  5. Dokumentiere Erkenntnisse, die die Richtung ändern, in _ai/findings.md; dokumentiere Aktionen, Validierung und fehlgeschlagene Pfade in _ai/progress.md.
  6. Aktualisiere _ai/task_plan.md, wenn sich Phase, Blocker oder nächste Aktion ändert.
  7. Schreibe vor der Kontextkompression, nach Abschluss eines kleinen Schritts oder vor Thema-/Unterprojektwechsel eine kompakte Übergabe in die engste passende Markdown-Datei.
  8. Wende die Sync-Skala an, um zu entscheiden, ob PROJECT_BOARD.html berührt werden muss, und committe dann die geänderten sicheren Dateien mit expliziten Pfaden.

Kontextkompression und Übergabe-Hygiene

Schreibe Kontext proaktiv nieder, bevor das Gespräch teuer zu führen wird. Tue dies, wenn das Kontextfenster groß wird, ein kleiner Schritt abgeschlossen ist, ein Unterprojekt einen Entscheidungspunkt erreicht oder die nächste Aktion zu einem anderen Thema, Projekt oder Versuch wechselt.

Wähle den engsten Heimatort:

SituationÜbergabeort
Projektweite Diskussion, Entscheidung oder Methodennotiz1-Docs/<Datum>_<Thema>.md
Versuchsstufe: Schritt, Beobachtung oder lokale Diskussion0-Project/<Versuch>/docs/<Datum>_<Thema>.md
Projektstatus, Blocker, nächste Aktion oder Validierungszusammenfassung_ai/progress.md, _ai/findings.md, _ai/task_plan.md
Projektübergreifender oder Portfolio-Kontextdas <Slug>-ai/<Datum>_<Thema>.md des Portfolios, falls ein Portfolio existiert

Minimale Übergabefelder: aktuelles Ziel, abgeschlossener Schritt, wichtige Entscheidungen, Belegpfade, ungelöste Fragen, nächste Aktion und ob eine Board-Synchronisation erforderlich ist. Halte dies kompakt; füge keine vollständigen Transkripte oder Rohlogs ein.

Sync-Skala

Bewerte jede Änderung anhand dieser Skala, bevor du das Board bearbeitest.

StufeAuslöserAktualisierung
0Nur-Lesen-Erkundung, keine neue EntscheidungNichts
1Kleinere Erkenntnis, kleiner fehlgeschlagener Zweig, temporäre NotizNur Markdown oder _ai
2Neues Artefakt/Pfad/Qualitätskontrollergebnis, Blocker, nächste Aktion, Status, Dokumentenlandkarte, Strukturbaum, Datengrenze, Referenz oder Versuch geändertQuell-Markdown oder _ai, dann PROJECT_BOARD.html synchronisieren
3Phase, Meilenstein, öffentliche Behauptung, Eigentümer, Priorität oder öffentlicher Zustand geändertQuell-Markdown, Board, PROJECT_GUIDELINES.md und – nur wenn das Projekt zu einem Portfolio gehört – das Portfolio-Dashboard

Kontextübergabenoten sind normalerweise Stufe 1. Hebe sie auf Stufe 2 nur, wenn sie nächste Aktion, Status, Blocker, Dokumentenlandkarte, Datengrenze, Referenzstatus oder Versuchsstatus ändern.

Synchronisiere das Board nicht bei jeder Bearbeitung. Synchronisiere, wenn ein Kollaborateur den neuen Zustand benötigen würde.

Unterprojekt-Datensätze

Jedes 0-Project/<Datum>_<Slug>/README.md sollte beantworten: welche Frage der Versuch testet; welche Eingaben, Paper, Datennnotizen oder Annahmen er verwendet; was ausgeführt oder durchdacht wurde (Ziel, Hypothese, Eingaben, Befehl, Metriken); was fehlgeschlagen, geändert oder stabil geworden ist; die Schlussfolgerung und nächste Aktion; und ob es den Projektstatus, Datennnotizen, Literaturnotizen oder das Board beeinflusst. Lege versuchsinterne Diskussionen, Schritthandoffs und Entwurfsnotizen im docs/-Ordner dieses Versuchs ab.

Dokumentiere fehlgeschlagene Versuche. Ein fehlgeschlagener Pfad mit einem klaren Grund ist ein nützliches Projekt-Asset. Wenn er aufgegeben oder abgelöst wird, markiere ihn als archiviert mit dem Stoppgrund, einem Ersatz, falls vorhanden, dem letzten Beleg und dem, was nicht wiederholt werden soll; zeige ihn im Board nur als sekundäres eingeklapptes Element, sobald er eine stabile Phase oder einen Entscheidungspunkt erreicht.

Daten und Literatur

  • Verwende 2-Data/DATA.md für Herkunft, Versionen, Zugangsklasse, erlaubte Orte, Schema, Qualitätskontrolle und Grenzen abgeleiteter Artefakte. Halte projekteigene Daten (Features, Verläufe, analysebereite Tabellen, Qualitätskontroll-Zwischenprodukte) unter diesem Projekt in 2-Data/, nicht im globalen Datenbereich. Schreibe niemals rohe sensible Datensätze, identitätsbehaftete Beispiele, Anmeldeinformationen oder unveröffentlichte Auszüge in Notizen, das Board oder öffentliche Kopien.
  • Verwende 3-Paper_Survey/README.md für Belege, die Methoden, Bewertung, Umfang oder Interpretation ändern können. Fasse Paper nach Problem, Methode, Daten oder Benchmark, Ergebnis, Einschränkung und Auswirkung auf dieses Projekt zusammen. Verwende eine Evidenzmatrix, wenn mehrere Quellen zu einer Behauptung beitragen. Bevorzuge prägnante Paraphrasen und Links gegenüber langen Zitaten.

Referenzen

  • Lies references/project-iteration-system.md beim Erstellen der Projektstruktur, von Einstiegsdateien, Unterprojekten, Arbeitsgedächtnisdateien oder Synchronisationsregeln.
  • Lies references/project-board.md beim Erstellen, Überprüfen oder Synchronisieren von PROJECT_BOARD.html.
  • Lies references/data-and-literature.md vor der Bearbeitung von Datennnotizen, Benchmark-Herkunft, Literaturzusammenfassungen oder Beleg-zu-Entscheidungs-Aktualisierungen.

Verwandte Skills