How do I install the Zterm Windows Dev skill?

Run npx skillmds@latest add jasonzhangf/zterm-windows-dev in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Zterm Windows Dev safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Zterm Windows Dev?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Zterm Windows Dev free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Zterm Windows Dev?

jasonzhangf (@jasonzhangf) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Zterm Windows Dev by jasonzhangf — Agent Skill

Name: Zterm Windows Dev
Author: jasonzhangf

File contents

zterm Windows Dev

必读

win/docs/architecture.md
win/docs/function-map.md
win/docs/windows-desktop-shell-manifest.json
win/docs/testing/windows-desktop-shell-test-design.md
win/MEMORY.md

边界

win/ 只拥有 Electron 窗口、preload、Windows 平台适配、桌面组合和打包。
复用 shared transport、sparse buffer、renderer；禁止复制 daemon、mirror、renderer、Mac IPC 或 local tmux。
daemon backend 变更仍由 daemon.windows_wezterm_backend owner 处理。

Packaged 门禁

Sandbox preload 源用 .cts，main 只加载生成的 preload.cjs。typecheck/build 不能证明 packaged preload 可加载。
connected 不等于 mirror ready。首个 buffer-sync revision 前禁止发 visible-range request，否则 daemon 会显式报 mirror not ready。
完成必须在真实 Windows packaged app 上自动证明：bridge 存在、连接无 error、输入唯一 marker、DOM rows 匹配命令和输出。
Smoke 使用固定专用 session 或唯一明确 sessionName；结束按 sessionName 清理。App/helper、CDP tunnel、SSH holder 只按明确 PID/session 关闭，禁止 broad kill。
Session discovery/create/close UI must call shared daemon control helpers. Do not fork control wire semantics in Windows UI; verify UI list and daemon final list agree after close.
Desktop pane/tab composition must use shared PaneStage, PaneTabs, and workspace-model operations. Keep one stable runtime per tab id; focus switches must not reconnect. Packaged proof records daemon attached/ready counts before and after focus switch, isolated markers in each pane, then closes one tab and proves the sibling still receives a new marker.
Windows file browser must keep provider IO in win/electron/windows-file-system.ts, UI projection in win/src/WindowsFileBrowserPanel.tsx, and preview/path policy in shared FileBrowserCore. Packaged proof opens a real Windows fixture, compares Markdown source-to-DOM, proves binary disabled, and confirms daemon session counts stay unchanged.
生成物 win/dist/、win/dist-electron/、win/out/、evidence 不进 git/MemPalace。

最小验证

pnpm --dir win run type-check
pnpm --dir win test -- --reporter dot
pnpm --dir win run build
pnpm --dir win run package

随后部署真实 Windows 包并跑 source-to-DOM marker gate；只完成本地命令不得宣称 packaged alpha 闭环。

---name: zterm-windows-devdescription: zterm Windows Electron 客户端与 WezTerm daemon 开发闭环，覆盖共享核心边界、packaged preload、真实 Windows CDP/source-to-DOM gate 和精确资源清理。---# zterm Windows Dev## 必读1. `win/docs/architecture.md`2. `win/docs/function-map.md`3. `win/docs/windows-desktop-shell-manifest.json`4. `win/docs/testing/windows-desktop-shell-test-design.md`5. `win/MEMORY.md`## 边界- `win/` 只拥有 Electron 窗口、preload、Windows 平台适配、桌面组合和打包。- 复用 shared transport、sparse buffer、renderer；禁止复制 daemon、mirror、renderer、Mac IPC 或 local tmux。- daemon backend 变更仍由 `daemon.windows_wezterm_backend` owner 处理。## Packaged 门禁- Sandbox preload 源用 `.cts`，main 只加载生成的 `preload.cjs`。typecheck/build 不能证明 packaged preload 可加载。- `connected` 不等于 mirror ready。首个 `buffer-sync` revision 前禁止发 visible-range request，否则 daemon 会显式报 mirror not ready。- 完成必须在真实 Windows packaged app 上自动证明：bridge 存在、连接无 error、输入唯一 marker、DOM rows 匹配命令和输出。- Smoke 使用固定专用 session 或唯一明确 sessionName；结束按 sessionName 清理。App/helper、CDP tunnel、SSH holder 只按明确 PID/session 关闭，禁止 broad kill。- Session discovery/create/close UI must call shared daemon control helpers. Do not fork control wire semantics in Windows UI; verify UI list and daemon final list agree after close.- Desktop pane/tab composition must use shared `PaneStage`, `PaneTabs`, and workspace-model operations. Keep one stable runtime per tab id; focus switches must not reconnect. Packaged proof records daemon attached/ready counts before and after focus switch, isolated markers in each pane, then closes one tab and proves the sibling still receives a new marker.- Windows file browser must keep provider IO in `win/electron/windows-file-system.ts`, UI projection in `win/src/WindowsFileBrowserPanel.tsx`, and preview/path policy in shared `FileBrowserCore`. Packaged proof opens a real Windows fixture, compares Markdown source-to-DOM, proves binary disabled, and confirms daemon session counts stay unchanged.- 生成物 `win/dist/`、`win/dist-electron/`、`win/out/`、evidence 不进 git/MemPalace。## 最小验证```bashpnpm --dir win run type-checkpnpm --dir win test -- --reporter dotpnpm --dir win run buildpnpm --dir win run package```随后部署真实 Windows 包并跑 source-to-DOM marker gate；只完成本地命令不得宣称 packaged alpha 闭环。

Frequently asked questions

Zterm Windows Dev