AI i agenci · Integracja z narzędziem
opencode-delegation-lessons
/opencode-delegation-lessons
Przekazuje kodowanie do OpenCode CLI przez Hermesa i zapisuje wnioski z wcześniejszych zleceń.
Dla kogo
- Autor
- kaiffeetasse ↗
- Repozytorium
- agent-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 10.11.2026
Ocena i bezpieczeństwo
96/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność21 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Przestarzałość
Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.
Licencja
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Przekazuje kodowanie do OpenCode CLI przez Hermesa i zapisuje wnioski z wcześniejszych zleceń.
Oryginalny opis (EN)
Use when delegating coding to OpenCode CLI via Hermes.
Jak działa
- Core recommendation
- TUI failure modes observed (and fixes)
- Monitoring pattern that works
- Verification discipline (orchestrator role)
- Related project
Sekcje z nagłówków SKILL.md, w oryginale · 78 linii, 695 słów
Podgląd SKILL.md
---
name: opencode-delegation-lessons
description: "Use when delegating coding to OpenCode CLI via Hermes."
---
# OpenCode Delegation — Field Lessons
Companion to the bundled `opencode` skill (which documents commands/flags). This skill captures what actually went wrong and worked in real delegation sessions. Read it before starting any `opencode` background/TUI session.
## Core recommendation
**Prefer `opencode run '<task>'` for delegated coding tasks** — including multi-step tasks with commits and verification. It streams the final report to stdout and avoids every TUI failure mode listed below. Reserve the interactive TUI for genuinely iterative back-and-forth the user participates in.
## TUI failure modes observed (and fixes)
### 1. Prompt sits unsent in the input box
`process(action="submit", ...)` writes the text but often doesn't submit. Fix: follow with `process(action="write", data="\n")`. Sometimes even that fails silently — if the log shows no new session created after ~1 min, assume not submitted.
### 2. Invisible permission dialogs = silent hang
If the task references files OUTSIDE the workdir (e.g. a plan at `~/.hermes/plans/...`), opencode fires an `external_directory` permission ask. The TUI shows a spinner; nothing progresses for 10+ minutes.
**Fix:** Copy context files INTO the project first (`cp ~/.hermes/plans/x.md docs/plan.md && git add && git commit`), then reference them by relative path in the prompt. Tell the agent explicitly: "bleibe im Projektverzeichnis".
Diagnose with:
```bash
grep -E "asking|permission" $(ls -t ~/.local/share/opencode/log/*.log | head -1) | tail -5
```
(`permission=external_directory ... message=asking id=...` = this hang.)
### 3. Model IDs drift
An invalid model ID (`opencode/deepseek-v4-flash-free`) produces "Model is not valid" or silent stalls/fallbacks. Always verify first:
```bash
opencode models deepseek # list provider's models
```
Working default as of 2026-08: `deepseek/deepseek-v4-flash` (direct DeepSeek provider).
### 4. Turn ended without work ("exiting loop")
Check newest log for `"exiting loop"`; then verify on disk (git log, generated files, cache dirs). If the turn ended without side effects, re-dispatch — don't wait longer.
### 4b. Long `opencode run` can die mid-deliverable (observed 2026-10-08)
A background `opencode run --auto ... | tee logs/run.log` on a multi-part task (decompile jar →
build → dual-mode E2E verify → report) processed part of the brief and then the process simply
disappeared: the log stopped mid-command at 11:39, `ps` showed nothing, no "exiting loop", and
several required outputs (screenshots, updated verify script, report update) were missing while
others (patcher edits to source files, a partial build script) were already on disk.
Fix / discipline:
- Treat the log tail as *not* proof of completion. Check every named deliverable on disk
(`ls screenshots/`, `grep -c <section> docs/REPORT.md`, expected scripts present+executable).
- Expect a partially-applied change set; inspect the diff before re-dispatching so a second run
doesn't undo work. Finishing the leftovers yourself is usually faster than a new agent round.
- Split large briefs into phases so each phase is a complete, independently checkable deliverable.
### 5. Input buffer corruption on kill/restart
Killing a stuck TUI can leave queued input garbled (` `, literal `\n` mixed into the prompt text). Don't try to salvage the buffer — kill the process and start fresh, resending the full task cleanly.
## Monitoring pattern that works
Watch progress via the **filesystem**, not the TUI spinner:
```bash
git -C <workdir> log --oneline | head -3 # commits landed?
find <workdir>/build/cache -name "*.png" | wc -l # long downloads progressing?
du -sh <dir> # size growing?
tail -20 $(ls -t ~/.local/share/opencode/log/*.log | head -1) # current activity
```
Long-running agent sub-tasks (tile downloads, builds) keep running while the agent turn is open — poll these counters every few minutes rather than killing prematurely.
## Verification discipline (orchestrator role)
Never trust the agent's self-report alone:
- Re-run its verification yourself (open generated files with PIL, check manifest counts against formulas, `node --check`).
- Do visual spot-checks of generated assets (stitch two neighbors side-by-side, screenshot the app headless) — the agent can be right about counts and wrong about rendering.
- Sanity-check the agent's math against your own plan numbers; in one real session the agent correctly caught an off-by-100 error in the orchestrator's plan (z13 tile estimate) — verify claims both ways.
## Related project
The full worked example (map-puzzle: OSM tile pipeline + puzzle web app, built entirely via opencode delegation) lives in `~/workspace/map-puzzle/` with its plan in `docs/plan.md` there.
Wersje
W bazie nie ma innych skilli o nazwie opencode-delegation-lessons.
Migawka bazy z 13.11.2026 · wersja paczki 38cc9f4002f2 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100opencode-delegation
Deleguje zadania do OpenCode przez opencode run za pośrednictwem delegation-core, gdy ten wybierze OpenCode albo potrzebna jest uprząż niezależna od dostawcy. - 100opencode-delegate
Przekazuje zadania kodowania do OpenCode CLI tylko na wyraźne żądanie użytkownika, a orkiestrator odpowiada za przegląd i włączenie wyników. - 100opencode-delegate
Zleca zadanie programistyczne CLI OpenCode jako implementatorowi w tle, po czym przegląda jego diff i samodzielnie scala zmiany. - 100working-with-opencode
Opisuje asystenta kodowania OpenCode: wtyczki, skille, hooki i konfigurację na podstawie oficjalnej dokumentacji. - 100code-mate-opencode
Uruchamia OpenCode nieinteraktywnie do zadań programistycznych, gdy użytkownik chce przekazać pracę do OpenCode. - 100opencode-delegate
Deleguje zadania programistyczne do OpenCode CLI wyłącznie na wyraźną prośbę użytkownika, a przegląd i wdrożenie wyników zostają po stronie orkiestratora.