Paweł Domański
161 lines
12 KiB
Markdown
161 lines
12 KiB
Markdown
---
|
||
title: "Przestań tracić najlepsze rozmowy AI: archiwizuj Obsidian z umiejętnością"
|
||
source: "https://medium.com/@bulentg/stop-losing-your-best-ai-conversations-archive-to-obsidian-with-a-skill-49aa0f0e3477"
|
||
author:
|
||
- "[[Bulent Gorkem]]"
|
||
published: 2026-05-06
|
||
created: 2026-05-20
|
||
description: "More"
|
||
tags:
|
||
- "clippings"
|
||
---
|
||
|
||
|
||
Zdjęcie: Maksym Kaharlytskyi na Unsplash
|
||
|
||
Praktyczny samouczek: zbuduj osobisty korpus rozmów AI w Obsidian do przyszłych referencji, a następnie przejdź od bezpośrednich rozmów MCP do wielokrotnego użytku Claude Skill.
|
||
|
||
**TL; DR**
|
||
|
||
- Rozmowy AI pełne są decyzji, działającego kodu i kompromisów, które znikają w momencie zamknięcia zakładki. Zarchiwizuj przydatne w Obsidian jako uporządkowane notatki markdownowe, a zbudujesz osobisty, przeszukiwalny korpus, na którym możesz polegać przez miesiące.
|
||
- Rozpocznij manual: użyj serwera Obsidian MCP i poproś Claude'a, żeby podsumował + zapisał rozmowę w spójnym formacie. Gdy format się ustabilizuje, promuj przepis na **umiejętność** Claude'a, aby workflow przebiegał tak samo za każdym razem, bez ponownego tłumaczenia.
|
||
- Skróty do tworzenia umiejętności: dziedzina to twój prawdziwy interfejs — pisz to jak prompt engineering. Umieść zależności na początku (nie w głównej części ciała). Uwzględnij i. Trzymaj się poniżej 500 linij. I nie oceniaj siebie tego, co wywołuje w rozmowie, która napisała tę umiejętność — przetestuj ją na zimno.`description` `compatibility` `## Examples` `## Troubleshooting`
|
||
|
||
Przykładowy (z kodem) mieszka na [github.com/bgorkem/bgorkem-skills](https://github.com/bgorkem/bgorkem-skills).
|
||
|
||
Prawdopodobnie masz teraz otwartą zakładkę Claude (albo ChatGPT, albo Kursor), gdzie dzieje się coś przydatnego. Przełom w debugowaniu. Decyzja projektowa, w której trzy dobre opcje są ze sobą zestawione. To była czysta fraza z zabawy, którą dopracowywałeś czterdzieści minut.
|
||
|
||
Jutro ta karta zniknie. Albo nadal jest otwarta, ale zakopana pod dziewięcioma innymi. Tak czy inaczej, *wgląd* — rozumowanie, kompromisy, ten jeden fragment, który faktycznie zadziałał — znika.
|
||
|
||
Ten wpis przedstawia workflow, którego używam, aby to naprawić:
|
||
|
||
1. Archiwizować przydatne rozmowy AI w moim skarbcu Obsidian jako trwałe, przeszukiwalne notatki.
|
||
2. Zacznij od ręcznego zrobienia tego przez serwer Obsidian MCP.
|
||
3. Gdy wzór się ustabilizuje, awansuj go do **Claude'a**, żeby następnym razem pojawił się automatycznie.
|
||
|
||
Druga część to mini-tutorial na temat tworzenia umiejętności — nauka przenosi się do dowolnego workflow, który chciałbyś, aby Claude obsługiwał w ten sam sposób za każdym razem.
|
||
|
||
## Dlaczego w ogóle archiwizować rozmowy o AI
|
||
|
||
Kilka powodów, dla których ten nawyk się opłaca:
|
||
|
||
- **Decyzje przetrwały sesje.** "Wybraliśmy X zamiast Y, bo Z" jest złotem sześć miesięcy później, gdy zastanawiasz się, dlaczego kod wygląda tak, a nie inaczej.
|
||
- **Działający kod jest cenny.** Bash-one-liner, który w końcu zadziałał, SQL, który zwracał to, czego chciałeś — łatwiej znaleźć to w własnych notatkach niż w historii czatu.
|
||
- **Łączenie się między rozmowami.** Obsidian pozwolił, by dzisiejsza sesja debugowania odwołała się do zeszłomiesięcznego wywołania architektonowego. Narzędzia AI nie potrafią tego robić w różnych sesjach; Twój skarbiec może.`[[backlinks]]`
|
||
- **Szukaj swojej kontroli.** Twój skarbiec jest offline, zwykły markdown i można go indeksować przez cokolwiek (wyszukiwanie Obsidian, ripgrep, Dataview, cokolwiek).
|
||
- **Przyszły ty trenuje na tym.** Wklejenie starej zarchiwizowanej notatki z powrotem do nowej rozmowy to najtańsza możliwa "pamięć" dla asystenta AI.
|
||
|
||
Dobre notatki archiwalne mają kształt: krótkie podsumowanie na początku, potem "Kluczowe decyzje", "Kod, który zadziałał", "Follow-ups" oraz "Powiązane linki". Kształt ma znaczenie, bo pozwala na późniejsze skanowanie notatek — nie chcesz ściany transkrypcji czatu, tylko referencji.
|
||
|
||
|
||
|
||
Od ulotnej rozmowy do trwałej, powiązanej notatki w twoim skarbcu.
|
||
|
||
## Krok 1: Zrób to ręcznie z Obsidian MCP
|
||
|
||
Najprostsza konfiguracja korzysta z [serwera Obsidian MCP](https://github.com/MarkusPfundstein/mcp-obsidian) (każdy z dobrze utrzymanych serwerów działa). Po połączeniu Claude może wymieniać twój skarbiec, czytać pliki, dodawać, łatać i tworzyć nowe notatki.
|
||
|
||
Ręczny przepływ wygląda tak. Na końcu użytecznej rozmowy mówisz coś w stylu:
|
||
|
||
> *Podsumowaj tę rozmowę i zapisz ją w moim sejfie Obsidian jako* *plik markdown o nazwie* *. Użyj frontmaterii z datą i tagami. Sekcje: Streszczenie, kluczowe decyzje, kod, który się sprawdził, dalsze kroki, powiązane.*`*AI/Conversations/*` `*YYYY-MM-DD - <slug>.md*`
|
||
|
||
Claude czyta rozmowę, dekonsumuje ją i wywołuje narzędzie do tworzenia pliku na serwerze MCP, aby zapisać notatkę. Gotowe.
|
||
|
||
To działa. Robiłem tak przez jakiś czas. Jednak szybko pojawiły się dwa punkty tarcia:
|
||
|
||
**Format się zmienia.** Jednego dnia dostawałem notatkę z, następnego dnia, następnego dnia bez żadnego podsumowania. Instrukcje były w mojej głowie, nie w miejscu trwałym.`## Summary` `## TL;DR`
|
||
|
||
**Za każdym razem musiałem od nowa tłumaczyć workflow.** Każda nowa rozmowa, nowy kontekst. "Podsumuj to... użyj frontmaterii... Folder AI/Rozmowy... nie cały zapis, tylko decyzje i kod..." Szybko się znudziło.
|
||
|
||
Kiedy zdarza się, że kopiujesz te same instrukcje do każdej sesji, to jest sygnał. Czas przejść od ręcznego promptu do Umiejętności.
|
||
|
||
## Krok 2: Czym jest umiejętność i dlaczego jej tutaj używać
|
||
|
||
Umiejętność to folder z plikiem w środku. Przednia część zawiera a i; Tekst zawiera instrukcje, przykłady i notatki dotyczące rozwiązywania problemów. Claude automatycznie ładuje umiejętność, gdy twoje żądanie odpowiada jej opisowi.`SKILL.md` `name` `description`
|
||
|
||
Innymi słowy: instrukcje "podsumować i zapisać" *piszesz raz*, w. Od tego momentu, gdy mówisz "zapisz tę rozmowę" lub "archiwizuj na później", Claude znajduje umiejętność, ładuje instrukcje i robi to, co należy — zawsze ten sam format, bez powtarzania wyjaśnień.`SKILL.md`
|
||
|
||
To prawdziwy krok naprzód z "bezpośredniego korzystania z MCP" do "workflow opartego na umiejętnościach". Serwer MCP nadal wykonuje operacje wejścia i wyjścia plików. Umiejętność to *przepis*, który mówi Claude'owi, jak używać jej konsekwentnie.
|
||
|
||
## Krok 3: Tworzenie umiejętności
|
||
|
||
Spakowałem moją wersję i umieściłem ją na GitHubie w [github.com/bgorkem/bgorkem-skills](https://github.com/bgorkem/bgorkem-skills). Oto, czego się nauczyłem, pisząc go, z notatek z [Kompletnego Przewodnika Anthropic po budowaniu umiejętności dla Claude'a](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf).`obsidian-archive`
|
||
|
||
## Frontmatter to prawdziwy interfejs
|
||
|
||
Claude patrzy na pole, by zdecydować, czy w ogóle załadować twoje umiejętności. Traktuj to jak prompt engineering — to jedyna rzecz, którą można zobaczyć na etapie dopasowania.`description`
|
||
|
||
yaml
|
||
|
||
```c
|
||
---
|
||
name: obsidian-archive
|
||
description: Distils the current conversation into a concise reference note and saves it to the user's Obsidian vault in a configurable archive folder. Use when the user asks to archive, save, log, or capture the current conversation.
|
||
license: MIT
|
||
compatibility:
|
||
mcp-servers:
|
||
- mcp-obsidian
|
||
metadata:
|
||
author: bgorkem
|
||
version: 1.1.0
|
||
---
|
||
```
|
||
|
||
Słaby opis = umiejętność niedostatecznie wyzwalana. Wspomnij o frazach, które użytkownicy faktycznie wypowiedzą ("archiwizuj to", "zapisz tę rozmowę", "zapisz ją na później").
|
||
|
||
|
||
|
||
Anatomia SKILL.md — do czego służy każda część i dlaczego jest ważna.
|
||
|
||
## Zależności należą do, a nie do ciałacompatibility
|
||
|
||
To był mój największy błąd przy pierwszym szkicu. Miałem nagłówek z listą serwera MCP, którego potrzebowałem. Kanonicznym miejscem przewodnika dotyczącym "jakie serwery MCP, wtyczki lub pakiety systemowe wymaga ta umiejętność" jest pole frontmatter. Przesuń to tam.`## Dependencies` `compatibility`
|
||
|
||
## Dodaj i ## Examples## Troubleshooting
|
||
|
||
Przykłady uczą *Claude'a, kiedy* użyć tej umiejętności — pokaż kilka wyzwalających sformułowań i jak wygląda oczekiwany efekt. Rozwiązywanie problemów wykrywa przewidywalne błędy: brakujący serwer MCP, błędna ścieżka do sejfu, folder archiwum jeszcze nie istnieje, plik już istnieje na docelowej ścieżce.
|
||
|
||
Te dwie sekcje odróżniają "działa na moim komputerze" od "działa dla każdego, kto go zainstaluje".
|
||
|
||
## Trzymaj się poniżej celu progresywnego ujawniania informacji 500 linijków
|
||
|
||
System Umiejętności opiera się na idei, że jest indeksem, a dłuższe materiały referencyjne znajdują się w folderze, który Claude czyta tylko wtedy, gdy jest potrzebny. Moja wylądowała na 181 linii. Jeśli twoja liczba powoli przekracza 500, to sygnał do wydobycia.`SKILL.md` `references/`
|
||
|
||
## Nie da się ocenić umiejętności w rozmowie, która go napisała
|
||
|
||
Rozmowa, która stworzyła tę umiejętność, ma cały kontekst przygotowany; *Oczywiście* umiejętność uruchamia się poprawnie. Aby sprawdzić, czy Twój opis faktycznie się uruchamia w praktyce, przeprowadź osobny test testowy: 10–20 różnych sformułowań ("zapisz to", "zarejestruj to", "zapisz to", "dodaj do moich notatek", "zapamiętaj to na później"). Albo ręcznie w Claude.ai, albo z kodem Claude'a. Nie pomijaj tego.`run_loop.py`
|
||
|
||
## Krok 4: Podziel się tym
|
||
|
||
Gdy umiejętność zadziała, umieszczenie jej na GitHubie kosztuje prawie nic i ułatwia instalację na różnych komputerach. Kilka drobnych wyborów, które się opłaciły:
|
||
|
||
**Nazwa repozytorium według autora.** Prawie zadzwoniłem do repozytorium. Wybrałem zamiast tego. Zakres repozytorium będzie się zmieniał z czasem — dziś Obsidian, może NestJS scaffolds lub szablony n8n w następnej fazie. Imię przypisane autorowi przetrwa zmiany zakresu; nazwa o tematyce wymusza późniejszą zmianę nazwy lub podział.`devx-skills` `bgorkem-skills`
|
||
|
||
**Zrób odzwierciedlenie** **konwencji.** Poziom repozytorium dla ludzkich odwiedzających (oddzielnie od każdej umiejętności ), jedna umiejętność na każdy najwyższy folder, MIT,.`**anthropics/skills**` `README.md` `SKILL.md` `LICENSE``.gitignore`
|
||
|
||
```c
|
||
bgorkem-skills/
|
||
├── .gitignore
|
||
├── LICENSE
|
||
├── README.md
|
||
└── obsidian-archive/
|
||
└── SKILL.md
|
||
```
|
||
|
||
Przenieś na github
|
||
|
||
Dodaj temat o umiejętnościach claude'a na GitHubie dla wykrywalności i gotowe.
|
||
|
||
## Wzór, uogólniony
|
||
|
||
Łuk tutaj działa praktycznie przy każdym workflow AI, który robisz więcej niż dwa razy:
|
||
|
||
1. **Zrób to ręcznie kilka razy** przez podłączone serwery MCP. Zwróć uwagę, co działa, a co dryfuje.
|
||
2. **Ustabilizuj format.** Zdecyduj o dokładnej strukturze, przekrojach, konwencji nazewnictwa.
|
||
3. **Opakuj to w umiejętność.** Przenieś instrukcje z głowy i przenieś je do. Użyj frontmaterii, by była wykrywalna, a ciała, by była deterministyczna.`SKILL.md`
|
||
4. **Testuj spust** różnymi sformułowaniami.
|
||
5. **Publikuj go**, żeby przyszły Ty (i każdy inny) mógł zainstalować go raz i zapomnieć o tym.
|
||
|
||
`obsidian-archive` to pierwsza umiejętność w moim repozytorium. Drugi to już robię ręcznie zbyt często — to jedyne kryterium, które się liczy.
|
||
|
||
Jeśli zbudujesz taki, chętnie go zobaczę. |