learnwy/learnwy-dispatch

learnwy-dispatch

Single-process coordinator for the three IDE-hook events shared by the learnwy-* skills.

Why

Before this skill, every event fired N separate hook commands — one Node process per skill — and the user saw N back-to-back <system-reminder> blocks per turn. That multiplies the per-turn hook startup cost (~50 ms × N vs ~50 ms) and clutters context.

This skill replaces those entries with one hook per event that imports each skill's pure scanner function, runs them in-process, and emits a single combined reminder.

What runs per event

UserPromptSubmit (hooks/user-prompt-submit.cjs)

| Order | Module | Returns reminder when | |---|---|---| | 1 | english-learner/lib/prompt-scan.scanPrompt | English ratio ≥ 0.6 OR Chinese learn-intent OR Chinese ratio ≥ 0.3 | | 2 | llm-wiki/lib/prompt-scan.scanPrompt | wiki/topics.txt has any keyword overlapping a 4+ char word in the message | | 3 | prompt-optimizer/lib/prompt-scan.scanPrompt | explicit "optimize my prompt" trigger OR long structured prompt-shape |

Stop (hooks/stop.cjs)

| Order | Module | Returns reminder when | |---|---|---| | 1 | english-learner/lib/stop-scan.scanStop | Assistant response has 2–4 advanced English words worth surfacing | | 2 | knowledge-consolidation/lib/stop-scan.scanStop | Response shows substantive resolution signals (race condition / regression / "subtle"), not session-local trivia |

SessionStart (hooks/session-start.cjs)

| Order | Module | Returns reminder when | |---|---|---| | 1 | llm-wiki/lib/session-scan.scanSession | wiki/topics.txt exists — inject ≤30 topics | | 2 | english-learner/lib/session-scan.scanSession | First session of the day — push 3 due-for-review cards | | 3 | learnwy-status/lib/session-scan.scanSession | First session of the ISO week — prepend a compact cross-skill digest |

Each scanner is a pure (message | payload) => string | null (a couple have minor side effects: prompt-optimizer appends to ~/.learnwy/prompt-optimizer/events.jsonl; KC writes a debounce stamp).

If any scanner throws, the failure is swallowed and the others still run.

Installation

This skill is installed by pnpm run install:hooks like any other skill. The corresponding UserPromptSubmit entries in english-learner, llm-wiki, and prompt-optimizer hooks.json files have been removed — only this skill registers a UserPromptSubmit handler now.

After upgrading from a version without learnwy-dispatch, run:

pnpm run uninstall:hooks   # remove the old per-skill UserPromptSubmit entries
pnpm run install:hooks     # install the dispatcher (and re-register the others)

The pnpm run install:hooks orchestrator performs an uninstall sweep before installing, so you can re-run it any time as a one-shot, idempotent operation.

Not for direct invocation

There is no user-facing slash command and no cli.cjs <subcommand> other than install / uninstall. The skill description's trigger keywords exist purely so the AI surface area knows it is registered — direct invocation has no value.