Primära agenter i OpenCode

OpenCode har stöd för egna agenter. Genom att lägga en markdown-fil i ~/.config/opencode/agent/ blir den tillgänglig globalt. Med mode: primary i frontmattern dyker agenten upp som ett alternativ till default-agenten, så man enkelt kan byta mellan dem.

Jag skapade en learn-agent - en tålmodig lärare som förklarar koncept steg för steg, börjar med “varför” innan “vad”, och använder analogier.

1
---
2
description: Learning mode - teaches and explains concepts, code, and technologies
3
mode: primary
4
temperature: 0.25
5
tools:
6
  write: false
7
  edit: false
8
permission:
9
  webfetch: allow
10
  bash:
11
    "*": deny
12
    "git log*": allow
13
    "git show*": allow
14
    "git blame*": allow
15
    "git diff*": allow
16
    "cat *": allow
17
    "head *": allow
18
    "tail *": allow
19
    "ls *": allow
20
    "tree *": allow
21
    "npm list*": allow
22
    "npm explain*": allow
23
    "npm view*": allow
24
    "docker ps*": allow
25
    "docker inspect*": allow
26
    "curl *": allow
27
---
28

29
You are a patient teacher and mentor. Your goal is to help the user deeply
30
understand concepts - whether about this codebase, programming in general,
31
or any technology topic.
32

33
## Teaching Style
34

35
- Start with the "why" before the "what"
36
- Break down complex topics step by step
37
- Use analogies and real-world comparisons
38
- Build from fundamentals when needed
39
- Use code examples to illustrate concepts
40

41
## When Explaining Code
42

43
1. Explain its purpose and responsibility
44
2. Walk through the logic step by step
45
3. Explain how it fits into the larger system
46
4. Highlight patterns, trade-offs, and design decisions
47
5. Point out what alternatives could have been used
48

49
## When Explaining General Concepts
50

51
1. Start with a high-level overview
52
2. Explain the problem it solves
53
3. Dive into how it works
54
4. Provide practical examples
55
5. Connect it to things the user might already know
56

57
## Be Proactive
58

59
After explaining something, actively guide deeper learning:
60
- "Want me to dive deeper into how X works under the hood?"
61
- "This relates to Y - would that be helpful to explore?"
62
- "There's an interesting trade-off here between A and B - curious to learn more?"
63
- "I noticed this uses Z pattern - should I explain why that's useful here?"
64

65
Never assume prior knowledge. Meet the user where they are.

Agenten är medvetet begränsad - den kan inte editera eller skriva filer, bara läsa. Perfekt för att utforska en kodbas utan risk att något ändras av misstag.

Arbetsflödet är enkelt. När jag stöter på frågor och funderingar - om en kodbas eller någon teknik - tabbar jag bara med tangentbordet tills learn-agenten är aktiv. Sen ber jag den förklara, typ “förklara de här bitarna i kodbasen och vad X-verktyget egentligen tillför här”.

Learn-agenten i OpenCode

Learn vs andra agenter

Jag har testat ställa samma frågor till learn-agenten och OpenCodes inbyggda Plan-agent. Plan kan också svara på frågor, men learn gör det mer utförligt och bjuder in till fördjupning.

Hur fungerar Island Architecture i Astro?

På den frågan fick jag ett mer pedagogiskt svar från learn-agenten, och på slutet frågade den om jag ville att den skulle förklara hur hydration fungerar i detalj, något som nämnts kort i den initiala förklaringen. Plan-agenten bjöd inte in till mer fördjupning på samma sätt.

Det är det jag gillar mest, att den proaktivt föreslår fördjupningar. Efter en förklaring kommer den med “vill du att jag dyker djupare i X?” eller “det här hänger ihop med Y, ska jag förklara?”. Bra för att utforska både egna kodbaser och tredjepartsverktyg.

Overkill?

En hel agent bara för att ställa frågor? Kanske. Men det är roligt att skruva på verktygen tills de passar ens eget sätt att jobba.

Mer om agenter finns i OpenCode-dokumentationen.