‹ 首页

formax-expanded-transcript-workflow

@yusifeng · 收录于 5 天前 · 上游提交 3 周前

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

场景repl调试转录视图开发

适合你，如果在 REPL 中实现或调试 Ctrl+O 展开转录视图与思维持久化功能

/ 下载安装
https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-expanded-transcript-workflow ↗
/ 通过 npx 安装 校验哈希
npx oh-my-skill add yusifeng/formax/formax-expanded-transcript-workflow
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- yusifeng/formax/formax-expanded-transcript-workflow
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify yusifeng/formax/formax-expanded-transcript-workflow
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
192GitHub stars
~661上下文体积 · 单文件
索引托管

怎么用

商店整理自技能原文 · 版本 5a48573 · 表述以原文为准
它做什么

装了这个技能，Claude在REPL中按 Ctrl+O 时，会按照文档规则更新扩展转录本的显示，仅显示模型实际产生的思考（thinking_delta），保持思考历史持久化，并正确切换紧凑/展开视图。同时防止转录本干扰输入或覆盖其他界面。

什么时候触发

当你在REPL中按 Ctrl+O 切换扩展转录本，或需要调试思考持久化、紧凑/展开视图边界时触发。

装好后可以这样说
技能会按规则更新转录本并验证布局。
技能会检查持久化逻辑并运行回归测试。
技能原文 SKILL.md作者撰写 · MIT · 5a48573

formax-expanded-transcript-workflow

Goal

Use this skill when changing Ctrl+O expanded transcript behavior, thinking persistence, or compact / expanded projection boundaries in the REPL.

Read First
  • docs/contracts/transcript-surface-contract.md
  • docs/contracts/semantics-contract.md
  • docs/runbooks/repl-surface-debugging.md when the change can affect clear / remount behavior

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

If the change touches clear / remount ownership directly, also use formax-surface-reset-workflow.

Code Map
  • Key handling: packages/core/src/screens/repl/hotkeys.ts
  • View wiring + footer: packages/core/src/screens/REPL.tsx
  • Compact projection: packages/core/src/screens/repl/compactProjection.ts
  • Transcript rendering: packages/core/src/screens/repl/transcript.tsx
  • Thinking persistence: packages/core/src/features/repl/controller/streaming/streaming.ts
  • Expanded Transcript panels: packages/core/src/screens/repl/panels.tsx
  • Compact command lifecycle: packages/core/src/features/repl/controller/send/send.ts
  • Surface reset owner: packages/core/src/screens/repl/useSurfaceTransitionManager.ts
High-Signal Patterns
  • No fake thinking:
  • thinking_delta is the only source of truth
  • never synthesize thinking rows from timers or summaries
  • Avoid Static hacks for toggles:
  • Static is append-only; if content must disappear, use reset / remount ownership instead of trying to "unrender" it
  • One footer:
  • prefer a single global footer; avoid per-panel footer duplication
  • Compact ordering contract:
  • keep banner -> summary (expanded only) -> > /compact ... -> compact subline
  • UI vs LLM orthogonality:
  • transcript slicing and ui.kind remain independent from prompt-history packing and reminder injection
Minimal Workflow
  1. Lock the semantic source first: thinking_delta persistence and transcript projection rules before renderer polish.
  2. Keep default transcript low-noise and Expanded Transcript read-only.
  3. Preserve compact / expanded ordering before adjusting footer or panel layout.
  4. If clear / remount logic changes, route through the shared surface reset path instead of local Static workarounds.
  5. Run the regression set below before review.
Minimum Regression
  • bun run test -- packages/core/src/screens/repl/compactProjection.test.ts packages/core/src/screens/repl/expandedTranscript.test.tsx packages/core/src/screens/repl/hotkeys.test.tsx
  • bun run test -- packages/core/src/screens/repl/surfaceSmoke.test.tsx
  • bun run test:surface-screen-model
  • bun run type-check
Guardrails
  • Do not introduce synthetic thinking or show thinking when the model did not emit thinking_delta.
  • Do not let Ctrl+O steal input while prompt mode or overlays are active.
  • Do not move header / messages outside Static to “fix” duplication; solve ownership and remount boundaries instead.
  • Expanded Transcript stays read-only; do not quietly turn it into an interactive input surface.
按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。
…