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 määrata AI agendile ja kommenteeritud lõik koos su märkusega läheb AI külgribale, nii et sa ei pea teksti kunagi kopeerima ega konteksti uuesti seletama.
Uus versioonis 1.8.6: kommentaarid on agentide juhtimiskeskus. Tööriistariba märgis näitab dokumendi tegelikku kommentaaride arvu, mainimine loetakse üles kõikjalt märkuse seest ja saatmine käivitab iga agendi kohta ühe järjestatud ülesande koos elavate olekutäppidega marginaalis. Vaata Kommentaaride saatmine AI-le.
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.
Kommentaaride saatmine AI-le
Just see teeb kommentaaridest enama kui ülevaatusmärgistuse.
Maini kommentaaris @claude, @codex või @opencode ja sellest kommentaarist saab ülesanne agendile, kelle nimetasid. Alates versioonist 1.8.6 loetakse mainimine üles kõikjalt märkuse seest, mitte ainult algusest, nii et "see algus on liiga järsk, @claude pehmenda seda" töötab täpselt samamoodi nagu märkus, mis algab mainimisega. Mainimine ilmub kommentaaris inline-kiibina, nii et sa näed kohe, millisele agendile märkus on suunatud.
Kommentaaride hüpikaken
Ava kommentaaride hüpikaken dokumendi tööriistariba kommentaarinupust. Selle nupu märgis kannab dokumendi tegelikku kommentaaride arvu ja hüpikakna päis jaotab arvu laiali: 4 total · 2 assigned · 2 unassigned.
Määratud kommentaarid on rühmitatud agentide kaupa, üks rida agendi kohta ja märkuse tekst selle all, nii et enne käivitamist on näha, mida Claude saab ja mida Codex saab. Mainimiseta kommentaarid jäävad rühmadest välja, lihtsa rea alla, mis ütleb Unassigned comments are never sent. Märkus, mille jätsid iseendale, jääbki märkuseks.
Kinnitussamm
Klõpsa Send assigned comments to AI ja veel ei käivitu midagi. Ilmub kinnitussamm, kus on iga agendirühma juures märkeruut ja lihtne lause selle kohta, mis täpselt juhtuma hakkab: Starts 2 tasks (2 comments) — one per agent, in document order. Võta rühmalt linnuke ära, et jätta see käivitusest välja, ja klõpsa siis Start 2 tasks.
Iga agent saab ühe järjestatud ülesande, mis on koostatud tema enda kommentaaridest, selles järjekorras, nagu need kommentaarid dokumendis paiknevad. Ülesanded lähevad AI külgriba päringujärjekorda, nii et need jooksevad üksteise järel, mitte kõik korraga, ja sa näed neid järjekorras ootamas, kui parasjagu üks töötab.
Elav olek marginaalis
Kui käivitus algab, ilmub igale saadetud marginaalimärkusele olekutäpp. Täpp jälgib selle kommentaari ülesannet, nii et saad dokumenti edasi lugeda ja näha, millised märkused on juba tehtud ja millised alles ootavad. Kui ülesanne valmib, seletab agendi vastus külgribal, mida ta muutis, ja vastava kommentaari täpp muutub roheliseks.
Näiteks tõsta esile lõik, mis loeb kohmakalt, lisa kommentaar @claude tihenda seda ja kärbi kordused ja saada see ära. Claude Code saab lõigu ja su juhise koos ning töötab täpselt selle lõiguga. Pole kopeerimist. Pole konteksti ümberseletamist.
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 |
| Määra kommentaar agendile | Kirjuta @claude, @codex või @opencode kuhu tahes märkuse sees (v1.8.6) |
| Vaata, mitu kommentaari dokumendis on | Märgis tööriistariba kommentaarinupul (v1.8.6) |
| Saada määratud kommentaarid AI-le | Ava kommentaaride hüpikaken, klõpsa Send assigned comments to AI, kinnita ülesannete arv |
| Hoia märkus endale | Jäta mainimine välja — määramata kommentaare ei saadeta kunagi |
| Jälgi jooksvat kommentaariülesannet | Olekutäpp marginaalimärkusel (v1.8.6) |
| Kuhu kommentaarid salvestatakse | Markdown-faili sisse — need püsivad üle salvestuste |
Seotud
- AI külgriba — Neli agenti ühes külgribas; kus kommentaariülesanded järjekorda lähevad ja tööle hakkavad
- Põhiredaktor — Redaktori võimalused ja kaldkriipsukäsklused
- Agentide kogu — Sirvi kõiki agente ühes kohas