본문으로 건너뛰기
cccskills
무료GitHub에 공개

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

yusifeng/formax
설치 방법 보기

포함된 파일(1)

  • SKILL.md3.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Formax Surface Reset Workflow

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/
    • 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

  1. Identify the exact path (/resume, /clear, Ctrl+O / Ctrl+E, compact boundary, etc.).
  2. Route it through replaceTranscript / resetTranscriptSurface instead of local clear / remount sequencing.
  3. Treat reset as one transaction, not scattered side effects.
  4. Add or extend regression tests for ordering and surface reset ownership.
  5. 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

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

analyze-task

무료

Use when a Formax repository task is non-trivial and you should analyze goals, non-goals, boundaries, data/type/interface impact, contract impact, test strategy, and whether an xhigh subagent is actually needed before writing a todo or code.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

yusifeng/formax1942026년 7월 25일 업데이트

formax-approval-ui-workflow

무료

Use when adding or changing any Approval prompt/presenter.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

yusifeng/formax1942026년 7월 25일 업데이트

formax-config-settings-workflow

무료

Use when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

yusifeng/formax1942026년 7월 25일 업데이트

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

yusifeng/formax1942026년 7월 25일 업데이트

formax-expanded-transcript-workflow

무료

Use when implementing/debugging Ctrl+O Expanded Transcript (second view) and thinking persistence in the REPL.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

yusifeng/formax1942026년 7월 25일 업데이트

formax-permissions-workflow

무료

Use when implementing or debugging Formax permissions/policy/approval behavior and UI (allow/ask/deny rules, workspace boundaries, approval prompts, and /permissions overlay parity with Claude Code).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

yusifeng/formax1942026년 7월 25일 업데이트

yusifeng의 스킬 모두 보기

이 스킬의 문제 신고