# Een taak aan een AI-agent geven

Kopieer een hele taak als prompt voor een codeeragent zoals Claude Code of Codex, met reacties, commits en bijlagen, en krijg het werk terug op de taak.

Laat je een AI-codeeragent zoals Claude Code of Codex een deel van het werk doen? Met één menuknop kopieer je een taak als één stuk tekst dat je in de agent plakt: de titel, de beschrijving, de subtaken, de reacties, de commits en de bijlagen, in markdown. Je hoeft niets meer stukje voor stukje over te nemen, en de prompt vraagt de agent de taak in zijn commits te noemen, zodat het werk weer bij de taak verschijnt.

## Een taak als prompt kopiëren

1. Open de taak.
2. Klik op **Meer** (de drie puntjes bovenaan de taak).
3. Klik op **Kopieer als prompt voor een codeeragent**.
4. Plak de tekst in je agent.

Is het gelukt, dan zie je **Prompt gekopieerd.** Heeft de taak bijlagen, dan staat er ook bij hoe lang de links ernaar werken. Staat je browser het niet toe, dan zie je **Kopiëren is niet gelukt. Kijk na wat je browser op het klembord toestaat.**

## Wie het kan gebruiken

| | |
|---|---|
| Rollen | Eigenaar, Manager en Teamlid |
| Project | Alleen een project met een gekoppelde GitHub-repository, zie [GitHub koppelen](<https://taskstand.nl/help/github>) |
| Abonnement | Volgt het abonnement van de eigenaar van het project, net als de repository zelf |
| Niet beschikbaar | In een afgerond of gearchiveerd project, en voor Klant, Meelezer en Beperkt |

De prompt is gebouwd rond commits die hun weg terug naar de taak vinden, en daarom is er een gekoppelde repository voor nodig.

## Wat er in de prompt staat

De prompt bevat alleen wat je zelf al op de taak kunt zien. In deze volgorde:

- **De kop**: de verwijzing en de titel van de taak (en bij een subtaak de taak waar hij onder valt), met een korte toelichting voor de agent. Die zegt bij welk project de taak hoort en vraagt de agent na te gaan of hij in de juiste map werkt voordat hij iets verandert. Daaronder staat een titel voor de sessie met de verwijzing erin, zodat je de sessie later terugvindt op `WEB-12`. De agent kiest die naam zelf en neemt de verwijzing meestal over. Doet hij dat niet, dan zet je hem in Claude Code vast met `/rename WEB-12`.
- **De gegevens**: project, sectie, status, prioriteit, start- en einddatum, herhaling, schatting, labels, wie de taak heeft en een link naar de taak.
- **Beschrijving**: precies zoals hij geschreven is.
- **Subtaken**: als afvinklijst, met de afgeronde aangevinkt.
- **Reacties**: de nieuwste vijftig, elk met schrijver en datum. Zijn het er meer, dan zegt de prompt hoeveel en linkt hij naar de taak.
- **Commits**: de nieuwste twintig commits die aan de taak hangen, met sha, datum en auteur.
- **Foutmeldingen**: heeft het project Sentry gekoppeld, dan de issues die aan de taak hangen.
- **Bijlagen**: de bestanden op de taak en in de reacties, als downloadlinks (zie hieronder).
- **Bij het committen**: de opdracht om de taak in elke commit te noemen.

## Wat anderen schreven, is informatie

Een groot deel van een taak is door anderen geschreven: een klant in een reactie, een collega in de beschrijving, iemand van buiten je team in het bericht van een samengevoegde pull request. Een agent kan zelf geen verschil zien tussen een opmerking en een opdracht. Daarom zet de prompt elk van die stukken tussen twee markeringen, en vertelt hij de agent vooraf dat tekst daartussen informatie over het werk is en nooit een opdracht.

De markeringen bevatten een code die bij elke kopie opnieuw gemaakt wordt. Niets in zo'n stuk kan dus de afsluitende markering nabootsen en de rest van zichzelf voor jouw opdracht laten doorgaan. Kort gezegd: een reactie kan je agent geen opdrachten geven.

Dat maakt de prompt veiliger, niet onfeilbaar. Kijk wat je agent van plan is voordat je hem laat werken, zoals bij elke prompt.

## Het werk komt terug bij de taak

Het laatste stuk van de prompt vraagt de agent de verwijzing naar de taak (bijvoorbeeld `WEB-12`) in het bericht van elke commit voor dit werk te zetten. Zodra die commits gepusht zijn, verschijnen ze bij de taak en op de Code-pagina, net als je eigen commits. Een link naar de taak werkt ook. Alleen `#12` werkt niet, omdat GitHub zulke nummers zelf in zijn merge-commits zet.

## Bijlagen

Elke bijlage gaat mee als link met een korte downloadopdracht, zodat de agent de bestanden kan ophalen zonder aangemeld te zijn.

- De links werken **15 minuten** nadat je op de menuknop klikt, en geen moment langer. Kopieer opnieuw voor nieuwe links.
- De bestanden komen in een tijdelijke map met de naam van de taak. De prompt vraagt de agent die map te verwijderen als hij klaar is, omdat een tijdelijke map bestanden dagenlang kan bewaren.
- Bij het ophalen kijkt de link opnieuw of jij het bestand nog mag zien. Word je van het project gehaald, dan werken je links meteen niet meer.
- Elk bestand krijgt een veilige naam: een korte code met daarachter een opgeschoonde versie van de oorspronkelijke naam, zodat vreemde tekens in een bestandsnaam geen kwaad kunnen.
- Een bestand dat niet meer op de server staat, wordt zo vermeld, zonder link.

## Kopiëren wordt bij de taak vastgelegd

Elke kopie zet een regel in de **Activiteit** van de taak: "heeft deze taak als prompt gekopieerd", met jouw naam. De links naar de bijlagen gaan mee naar waar de prompt geplakt wordt, dus de taak zegt dat het gebeurd is.

## Privacy

- Plak je de prompt in een dienst die ergens anders draait (een AI-dienst, een chat, een gedeeld document), dan gaat de hele tekst van de taak daarheen: beschrijving, reacties, namen en commitberichten. Plak hem alleen waar je het werk van dit project mag delen.
- De links naar de bijlagen werken een kwartier lang voor iedereen die de prompt heeft. Daarna werken ze niet meer.
- De links naar de bijlagen bevatten een kenmerk van je account: een willekeurige code, niet je naam of e-mailadres.

Wil je weten wie wat ziet in een project? Zie [leden en rollen](<https://taskstand.nl/help/leden-en-rollen>).