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:
- Markdown zuerst, Board zweitens. Aktualisiere zuerst die Markdown-Quelle oder die
_ai-Notiz. Erst dann synchronisierePROJECT_BOARD.html. - Das Board ist eine Karte, kein Log.
PROJECT_BOARD.htmlzeigt 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 Benutzers | Zielort | Mögliche Board-Ansicht |
|---|---|---|
| „Das ist eine Diskussion / Methode / Entscheidung / Vergleich“ | 1-Docs/<Datum>_<Thema>.md + aktualisiere 1-Docs/README.md | Dokumentenlandkarte (文档地图) |
| „Das ist ein konkretes Experiment / ein konkreter Versuch“ | 0-Project/<Datum>_<Slug>/; versuchsinterne Notizen unter docs/ ablegen | Aufgaben (任务尝试) |
| „Das ist eine Notiz über einen bestehenden Versuch“ | 0-Project/<Versuch>/docs/<Datum>_<Thema>.md | normalerweise 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 konkret | normalerweise 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 Ersatz | archivierte/eingeklappte Aufgaben-Spur |
| „Das sind Daten / Benchmark-Informationen“ | 2-Data/DATA.md | Materialien (数据材料) |
| „Das ist ein Paper / eine externe Quelle / ein Beleg“ | 3-Paper_Survey/README.md + Evidenzmatrix | Referenzen (参考文献) |
| „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.md | Obenliegende Ü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 Dashboardmit Link zur Stammseite/; eigenständig entweder weglassen oder auf das eigeneREADME.mddes Projekts verweisen. Behalte bei, was du beim Erstellen, Kopieren, Veröffentlichen oder Aktualisieren der Seite wählst. -
Versionsstatus: Seitenversion
YYYY-MM-DD-vNund 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:
Ansicht Gespeist von Zeigt 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 NamenAufgaben (任务尝试) 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
- Stelle den Kontext wieder her aus
_ai/project_overview.md,_ai/project_board_spec.md,_ai/task_plan.md,_ai/findings.md,_ai/progress.mdund dem entsprechenden Ordner-README. - Bestätige die Git-Identität des Bedieners, bevor du Projektdateien bearbeitest; falls nicht vorhanden, bitte den Benutzer, seine eigene zu konfigurieren, und pausiere.
- Benenne die aktuelle Iteration in einem Satz: Frage, Versuch oder Entscheidung.
- Erstelle oder aktualisiere zuerst die engste Quelldatei.
- Dokumentiere Erkenntnisse, die die Richtung ändern, in
_ai/findings.md; dokumentiere Aktionen, Validierung und fehlgeschlagene Pfade in_ai/progress.md. - Aktualisiere
_ai/task_plan.md, wenn sich Phase, Blocker oder nächste Aktion ändert. - Schreibe vor der Kontextkompression, nach Abschluss eines kleinen Schritts oder vor Thema-/Unterprojektwechsel eine kompakte Übergabe in die engste passende Markdown-Datei.
- Wende die Sync-Skala an, um zu entscheiden, ob
PROJECT_BOARD.htmlberü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 Methodennotiz | 1-Docs/<Datum>_<Thema>.md |
| Versuchsstufe: Schritt, Beobachtung oder lokale Diskussion | 0-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-Kontext | das <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.
| Stufe | Auslöser | Aktualisierung |
|---|---|---|
| 0 | Nur-Lesen-Erkundung, keine neue Entscheidung | Nichts |
| 1 | Kleinere Erkenntnis, kleiner fehlgeschlagener Zweig, temporäre Notiz | Nur Markdown oder _ai |
| 2 | Neues Artefakt/Pfad/Qualitätskontrollergebnis, Blocker, nächste Aktion, Status, Dokumentenlandkarte, Strukturbaum, Datengrenze, Referenz oder Versuch geändert | Quell-Markdown oder _ai, dann PROJECT_BOARD.html synchronisieren |
| 3 | Phase, Meilenstein, öffentliche Behauptung, Eigentümer, Priorität oder öffentlicher Zustand geändert | Quell-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.mdfü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 in2-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.mdfü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.mdbeim Erstellen der Projektstruktur, von Einstiegsdateien, Unterprojekten, Arbeitsgedächtnisdateien oder Synchronisationsregeln. - Lies
references/project-board.mdbeim Erstellen, Überprüfen oder Synchronisieren vonPROJECT_BOARD.html. - Lies
references/data-and-literature.mdvor der Bearbeitung von Datennnotizen, Benchmark-Herkunft, Literaturzusammenfassungen oder Beleg-zu-Entscheidungs-Aktualisierungen.