Skip to main content

weft-debug

COMMAND, not reference: Inspect the last execution and chase the failure to one node. Run this when the user asks for this step by name, optionally naming an execution color. The sixteen `weft-` reference skills beside it are things you read; this is a procedure you carry out.

Informations de source

Dépôt
WeaveMindAI/weft
Dernière activité de la source
19 septembre 2026 à 07:09
Langue détectée de SKILL.md
anglais
Étoiles
1 982
Forks
221

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Affichage de SKILL.md

SKILL.md
Instructions source · Aperçu en lecture seule
name
weft-debug
description
COMMAND, not reference: Inspect the last execution and chase the failure to one node. Run this when the user asks for this step by name, optionally naming an execution color. The sixteen `weft-` reference skills beside it are things you read; this is a procedure you carry out.
Debug this project's latest run, or a specific execution color if the user named one. Read the `weft-running` skill if you have not this session. 1. `weft executions --limit 5 --phase fire` and pick the color: the one the user named, else the latest. 2. `weft logs <color>` first: it names the failing node and quotes the error, and for most failures that is the whole diagnosis. Then narrow the events instead of reading them all: `weft events <color> --kind failed` for the failures, `--node <id>` for what reached one node, `--kind node_skipped` for what did not run and why, `--full` on the one line whose value you need whole. 3. Chase it to one node: - A failed node: name it, quote its error, list the values that reached its inputs (its `node_started` line), and read the relevant source. - A wrong value: the motion backwards. Look at the top-level groups in `src/main.weft`, find the first whose output is already wrong in the events, descend into it, repeat, until you hold the single step whose value went wrong and the concrete input that broke it. - Suspended: say where it waits and for whom; if nobody should have been asked, the bug is the `_should_flow` that routed there. - Cancelled: read the reason on its `execution_cancelled` line. `Stopped by execution <color> (tag <tag>)` means another run asked the engine to stop everything carrying that tag; look at that run, and if no sibling was meant to, the bug is the tagging. The `weft-running` skill reads every cancel reason. - Nothing ran: nothing reached the branch; walk from the trigger (or the root) down to the first node whose `_should_flow` or required input closed. 4. Name one fix, in two or three sentences: what you will change and why that fixes the observed value, not just the symptom. Apply it, validate, and run the same case again. Ask first only when the fix changes what the program does for the user, or when it would spend money or destroy state. Report, in plain words: the color and status, the node and value at fault, the fix and whether it ran again green or waits on the user's yes. No hedging, no blaming the environment.
Voir sur GitHub