스킬 검색.../

Formax Surface Reset Workflow | Skills Pool

스킬 파일

Formax Surface Reset Workflow

Use when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions). Enforces single-owner reset transaction and prevents black-screen/flicker/duplicate-row regressions.

yusifeng148 스타2026. 3. 18.

직업
카테고리: 데이터베이스 도구

스킬 내용

Goal

Use this skill when changing REPL clear/reset/resume behavior or any transcript surface transition that can remount Static.

Read First

docs/contracts/transcript-surface-contract.md
docs/runbooks/repl-surface-debugging.md
docs/contracts/invariants.md when ownership or sequencing is unclear

These docs are canonical. If stable surface behavior changes, update them before or with code.

Code Map

Reset helpers / queue owner:
- replaceTranscript
- queueTranscriptSurfaceReplace
- resetTranscriptSurface
- queueTranscriptSurfaceReset
- surfaceOpQueueRef
High-risk flows:
- packages/core/src/features/repl/controller/ui/

관련 스킬

빠른 설치

Formax Surface Reset Workflow

npx skills add yusifeng/formax

Skill 다운로드 저장소 열기

작성자: yusifeng
스타: 148
업데이트: 2026. 3. 18.
직업

이 페이지의 내용

packages/core/src/features/repl/controller/session/

packages/core/src/features/repl/useReplController.ts

packages/core/src/screens/repl/

packages/core/src/runtime/bootstrap/runLegacyCli.tsx

Call sites to watch:

onClearTerminal
clearTerminal
resetInkStaticOutputForStdout
transcriptSeq remount behavior in ReplTranscript / ExpandedReplTranscript

Trigger Conditions

Use this skill whenever the change touches any of:

/resume, /clear, compact boundary transitions
Ctrl+O / Ctrl+E transcript view switches
onClearTerminal, clearTerminal, or resetInkStaticOutputForStdout
replaceTranscript, queueTranscriptSurfaceReplace, resetTranscriptSurface, queueTranscriptSurfaceReset, or surfaceOpQueueRef
files under packages/core/src/features/repl/controller/ui/, packages/core/src/features/repl/controller/session/, packages/core/src/features/repl/useReplController.ts, packages/core/src/screens/repl/, or packages/core/src/runtime/bootstrap/runLegacyCli.tsx

Minimal Workflow

Identify the exact path (/resume, /clear, Ctrl+O / Ctrl+E, compact boundary, etc.).
Route it through replaceTranscript / resetTranscriptSurface instead of local clear / remount sequencing.
Treat reset as one transaction, not scattered side effects.
Add or extend regression tests for ordering and surface reset ownership.
Run the minimum regression set below and at least one real surface smoke path.

Minimum Regression

bun run test -- packages/core/src/features/repl/controller/ui/surfaceReset.test.ts
bun run test -- packages/core/src/features/repl/useReplController.test.tsx -t "resume|clear|compact"
bun run test -- packages/core/src/screens/repl/surfaceSmoke.test.tsx
bun run type-check
If change touches compact / expanded toggles broadly: bun run test:surface-screen-model

Guardrails

Keep one surface owner; do not add a second independent clear / remount path.
Do not stack replInstance.clear() and ANSI clear in legacy paths unless ownership is explicit and serialized.
Do not accept a Vitest-only fix without running a real surface smoke path.

References

docs/pitfalls/summary.md sections covering /clear, compact + Ctrl+O, and resume black-screen regressions
docs/pitfalls/repl-transcript-surface-handoff-pitfall.md
docs/pitfalls/repl-transcript-static-rootcause.md

Read First

04Trigger Conditions

05Minimal Workflow

06Minimum Regression

소프트웨어 개발자

데이터베이스 도구

Database Migrations

数据库迁移最佳实践，涵盖模式变更、数据迁移、回滚以及零停机部署，适用于PostgreSQL、MySQL及常用ORM（Prisma、Drizzle、Django、TypeORM、golang-migrate）。

데이터베이스 도구

Database Migrations

Şema değişiklikleri, veri migration'ları, rollback'ler ve PostgreSQL, MySQL ve yaygın ORM'ler (Prisma, Drizzle, Django, TypeORM, golang-migrate) arasında sıfır kesinti deployment'ları için veritabanı migration en iyi uygulamaları.

데이터 엔지니어링

Postgres Patterns

PostgreSQL database patterns for query optimization, schema design, indexing, and security. Based on Supabase best practices.

데이터베이스 도구

Frontend Query & Mutation

Guide for implementing Dify frontend query and mutation patterns with TanStack Query and oRPC. Trigger when creating or updating contracts in web/contract, wiring router composition, consuming consoleQuery or marketplaceQuery in components or services, deciding whether to call queryOptions() directly or extract a helper or use-* hook, handling conditional queries, cache invalidation, mutation error handling, or migrating legacy service calls to contract-first query and mutation helpers.

langgenius138.3k

데이터베이스 도구

Db Migrations

Use when generating or regenerating Drizzle migration files, changing database schema tables or columns, resolving migration sequence conflicts after rebase, reviewing migration SQL for idempotent patterns, or renaming migration files.

CMS 및 플랫폼

Drizzle

Drizzle ORM schema and database guide. Use when working with database schemas (src/database/schemas/*), defining tables, creating migrations, or database model code. Triggers on Drizzle schema definition, database migrations, or ORM usage questions.

소프트웨어 개발자