Kommentaarid
Märgi dokument üles nii nagu paberil, seejärel saada täpne lõik ja oma märkus otse AI agendile.
Versioonist 1.8.3 on Ritemarkis kommentaarid. Vali lõik, lisa märkus ja see ilmub marginaalimärkusena su teksti kõrvale. Kommenteeritud lõik saab ankru esiletõstu, nii et sa näed alati, mille kohta märkus käib. Kommentaarid salvestatakse Markdown-faili enda sisse, seega jäävad nad iga salvestamise juures alles ja liiguvad kaasa koos dokumendiga.
Kommentaarid pole siin ainult ülevaatuse jaoks. Kommentaari saab ühe klõpsuga anda AI agendile — kommenteeritud lõik ja su märkus lähevad AI külgribale koos, nii et sa ei pea teksti kunagi kopeerima ega konteksti uuesti seletama.
Kommentaari lisamine
Märkuse jätmiseks on kaks viisi.
Valitud teksti peale. Vali lõik, mida tahad kommenteerida, ja klõpsa tööriistaribal Comment. Valitud lõik saab ankru esiletõstu ja paremale avaneb marginaalimärkus, kuhu kirjutad oma kommentaari.
Iseseisev märkus ///-ga. Kirjuta /// kuhu tahes dokumendis, et jätta kiire iseseisev märkus ilma midagi eelnevalt valimata. Kasuta seda, kui märkus käib pigem selle koha kohta kui kindla tekstilõigu kohta — meeldetuletus, küsimus, hilisem tegemata töö.
Mõlemal juhul asub märkus paremal marginaaliribal, joondatuna dokumendi kohaga, mille kohta ta käib.
Olemasoleva kommentaari muutmine
Juba jäetud kommentaari muutmiseks klõpsa selle mullil marginaaliribal ja muuda teksti kohapeal. Eraldi muutmisrežiimi pole vaja avada — klõpsad märkusel ja hakkad kirjutama.
Kommentaari saatmine AI-le
Just see teeb kommentaaridest enama kui ülevaatusmärgistuse.
Kirjuta kommentaari sisse @claude, @codex või @opencode ja märkusele ilmub Send to AI nupp. Klõpsa sellel ja Ritemark annab kommenteeritud lõigu ning su märkuse AI külgribale, suunatuna agendile, keda mainisid. @mention ilmub kommentaaris inline-kiibina, nii et sa näed kohe, millisele agendile märkus on suunatud.
Pole kopeerimist. Pole konteksti ümberseletamist. Agent saab täpselt selle lõigu, mida kommenteerisid, ja märkuse, mille selle kohta kirjutasid — ühe sammuga.
Näiteks tõsta esile lõik, mis loeb kohmakalt, lisa kommentaar @claude tihenda seda ja kärbi kordused ja klõpsa Send to AI. Claude Code saab lõigu ja su juhise koos ning töötab täpselt selle lõiguga.
Kommentaarid salvestatakse Markdowni
Kommentaarid püsivad, sest need kirjutatakse Markdown-faili enda sisse, mitte ei salvestata eraldi andmebaasi. Kommenteeritud lõik teeb edasi-tagasi teekonna <mark data-comment> elemendina ja iseseisvad märkused salvestatakse failis HTML-kommentaaridena.
See tähendab, et su kommentaarid jäävad iga salvestamise juures alles, tulevad täpselt sellisena tagasi, nagu need jätsid, kui dokumendi uuesti avad, ja liiguvad failiga kaasa, kui selle commitid või ümber liigutad. Kuna nad on faili osa, ilmuvad kommentaarimuudatused git diff-i nagu iga muu redaktsioon, nii et saad neid üle vaadata või tagasi võtta samamoodi nagu mistahes muud dokumendimuudatust.
Tuntud piirangud
Kaks konarust versioonis 1.8.3, mõlemad parandatud v1.8.3-ext.1 laienduse uuenduses:
- Mitme punktiga kommentaarid jagunevad punkti kaupa (#150). Kui valid mitme loendipunkti ulatuses ja kommenteerid neid koos, jaguneb kommentaar praegu eraldi märkuseks iga punkti kohta, selle asemel et jääda üheks.
- Comment-nupu madala kontrastiga hover (#151). Comment-nupu hover-olek on tööriistariba taustal raskesti nähtav. Nupp töötab, on lihtsalt kahvatu.
Mõlemad on lahendatud v1.8.3-ext.1 laienduse uuenduses, nii et laienduste ajakohasena hoidmine eemaldab need.
Kiirjuhend
| Mida tahad teha | Kuidas teha |
|---|---|
| Kommenteeri lõiku | Vali tekst, klõpsa tööriistaribal Comment |
| Kiire iseseisev märkus | Kirjuta /// kuhu tahes dokumendis |
| Muuda kommentaari | Klõpsa selle mullil marginaaliribal ja kirjuta |
| Saada kommentaar AI-le | Kirjuta kommentaari @claude, @codex või @opencode, klõpsa Send to AI |
| Kuhu kommentaarid salvestatakse | Markdown-faili sisse — need püsivad üle salvestuste |
Seotud
- AI külgriba — Neli agenti ühes külgribas; kuhu "Send to AI" jõuab
- Põhiredaktor — Redaktori võimalused ja kaldkriipsukäsklused
- Agentide kogu — Sirvi kõiki agente ühes kohas