Agent skill
formax-test-stability-workflow
Use when adding or fixing Formax tests (especially Ink UI tests) and you need deterministic synchronization in test interactions.
Install this agent skill to your Project
npx add-skill https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-test-stability-workflow
SKILL.md
Formax Test Stability Workflow
Goal
- Write stable UI tests with explicit state sync.
Do
-
Wait for target state before next key (example: wait
❯ 3.before typing feedback). -
Assert final behavior, not transient cursor frames (example: assert feedback
aXb, nota▏b). -
In multi-step input flows, wait for idle state between steps (example: placeholder/queue-hint settled).
-
Extract repeated sync steps into local helpers (example:
selectFeedbackRow,queueMessageWhileLoading).
Don't
- Do not fix flakes by only increasing timeout.
- Do not use long sleep as synchronization.
- Do not bind assertions to fragile render glyphs/spacing.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
formax-dev-loop-workflow
Use when working on Formax code changes and you need a disciplined dev loop: keep a single mainline task, avoid scope drift, run only targeted tests (no coverage), avoid partial staging (MM), run mandatory review before commit, include an incremental optimization check, and keep commits small and reviewable.
formax-rework-convergence-workflow
Use when code has gone through repeated rework and may contain redundant logic, style drift, or tangled structure. Trigger when user asks for "返工收敛", "cleanup-pass", or requests a focused cleanup pass that reduces churn without changing behavior.
formax-tool-ui-blocks-workflow
Implement or refactor Formax tool transcript UI using the Tool UI Blocks (C-lite) pattern (ToolUiBlocks renderer + blocks presenters) to avoid touching many tool presenter files; use when adjusting ⏺/⎿ spacing, indent rules, or migrating additional tools to blocks presenters with targeted Ink/Vitest tests and Codex review before commit.
formax-web-css-convergence-workflow
Use when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn.
formax-config-settings-workflow
Use when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity.
formax-semantics-parity-workflow
Use when implementing or modifying behavior that must stay consistent across TUI and Web (mode/input/tool/replay/order). Require canonical semantics first, then TUI/Web adapters, then renderer-specific UI.
Didn't find tool you were looking for?