Agent skill

Windows macOS Test Package

by swjybky in swjybky/deepwrite

构建并验证 DeepWrite Windows、macOS 测试安装包,按失败阶段诊断和恢复。用于打包、测试包、Win/Mac 包及相关流程修改;版本递增和发布另用 package-patch-release。

Apache-2.0Auto-check passed

Install Windows macOS Test Package

skills CLI
$ npx skills add swjybky/deepwrite --skill windows-macos-test-package -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install swjybky/deepwrite windows-macos-test-package --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/swjybky/deepwrite.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/windows-macos-test-package .claude/skills/windows-macos-test-package && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
windows-macos-test-package
GitHub stars
597
Token cost
~999 tokens
SKILL.md length
175 words
Files
2 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

构建并验证 DeepWrite Windows、macOS 测试安装包,按失败阶段诊断和恢复。用于打包、测试包、Win/Mac 包及相关流程修改;版本递增和发布另用 package-patch-release。

  • SKILL.md covers 选择一个构建批次, 按失败阶段恢复, 观察执行进度 and 验收与交付
  • Calls pnpm

What it does

Windows macOS Test Package is an agent skill from swjybky/deepwrite. 构建并验证 DeepWrite Windows、macOS 测试安装包,按失败阶段诊断和恢复。用于打包、测试包、Win/Mac 包及相关流程修改;版本递增和发布另用 package-patch-release。

Its SKILL.md is about 1000 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/troubleshooting.md`).

It works with macOS, pnpm and Linux. The licence is Apache-2.0.

Example prompts

  • “/windows-macos-test-package”

What it can do on your machine

Read from SKILL.md and the folder at commit bca32cb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Windows macOS Test Package loads about 999 tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 33 tokens; SKILL.md has 175 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~999
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from swjybky/deepwrite at commit bca32cb, republished under its Apache-2.0 licence (© swjybky). 175 words, ~999 tokens.

Download SKILL.mdSave it as .claude/skills/windows-macos-test-package/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
windows-macos-test-package
description
构建并验证 DeepWrite Windows、macOS 测试安装包,按失败阶段诊断和恢复。用于打包、测试包、Win/Mac 包及相关流程修改;版本递增和发布另用 package-patch-release。

DeepWrite 测试安装包

默认只生成本地测试包,保持当前版本。用户要求递增或发布时再读 package-patch-release;正式签名、公证、上传发布须有明确授权及所需凭据。

选择一个构建批次

先核对两个 package.json 的版本、工作区修改和已有产物。记录本轮平台、源码变更及验证结果,避免把同版本旧包当成新包。不要先单独执行 pnpm verify 再启动打包,编排器已包含完整验证。

从仓库根目录执行,选择覆盖请求的最小组合:

请求目标命令
Mac ARM、Mac Intel、Windowspnpm pack:test:desktop
两种 Mac 架构pnpm pack:test:mac
macOS ARMpnpm pack:test:mac:arm64
macOS Intelpnpm pack:test:mac:x64
Windows x64pnpm pack:test:win
Linux x64pnpm pack:test:linux
全部(含 Linux)pnpm pack:test
  • 三平台请求优先用 pack:test:desktop,同一批次完整验证一次,两种 Mac 架构一起构建,再构建 Windows。不要拆成三个各自执行全量验证的命令,也不要额外构建未请求的 Linux。
  • 保留 tools/run-test-package.mjs 的完整验证、Electron 版本锁定和退出前开发运行时恢复。不要直接调用 electron-builder 绕过检查;并行打包会共享 out、release 和 Electron 运行时,构建批次应串行执行。
  • macOS 原生验收必须在 assertElectronLaunchAllowed() 允许的环境执行。已确认是 Codex Seatbelt 时,直接为具体组合命令申请沙盒外执行;不要先在沙盒内失败一次,不隐藏沙盒状态,也不用 --no-sandbox 绕过检测。
  • 使用 apps/desktop/electron-builder.yml,产物放 apps/desktop/release/,保留版本、平台和架构文件名。Mac 在 macOS 构建;Apple Silicon 运行 Intel 包需 Rosetta。Windows 跨平台构建时如实注明目标平台运行验证限制。
  • Mac 完整 .app 保持 identity: "-"、hardenedRuntime: false、notarize: false;Windows 测试包允许不签名。运行时依赖继续由 electron-vite 编译到 out,保留 before-build 钩子。

按失败阶段恢复

打包授权包含修复直接阻塞的问题。先读具体错误和 卡顿与超时诊断,最小修复、确认失败步骤通过后继续。保留用户已有修改,不降低断言或跳过必要检查。

失败阶段 / 本轮变化恢复方式
格式、类型、边界或测试失败先运行相关检查或失败测试文件;确认修复后,再启动一个完整打包批次。不要每改一个超时就重跑全部平台。
安装包冒烟失败,包内容和构建输入未变用下方验收命令只重跑对应架构,不重新执行全量测试和构建。必须有日志或环境诊断支持重试。
仅修改外部验收脚本验证脚本后复验现有包;Main 内的 smoke*.ts 是包内容,改动后必须重新构建。
修改 Main、Preload、Renderer、Utility、契约或构建输入旧包失效;经相关检查后重新走编排器,更新所有受影响的请求产物。
构建、签名或下载失败先定位配置、缓存、网络或目标环境,再走编排器重建所需目标。当前入口没有构建续跑或验证缓存参数,不臆造 --resume / --skip-verify。

仅复验已有 Mac Intel 包的示例(ARM 改为 arm64):

sh
pnpm --dir apps/desktop exec node scripts/verify-test-package.mjs mac x64

单独验收或中断后,执行 pnpm electron:ensure,记录恢复结果。正常打包已自动执行后置检查,无需重复。重新验证不能替代源码变化后的重建;复用包须确认它来自本轮成功构建,版本和输入未变。

同一失败没有新诊断依据时,不反复重跑整条流水线。确实缺少目标环境、凭据或授权时,完成不受阻塞的目标并报告剩余步骤;未通过验证的包不能报为成功或发布。重试沿用本轮版本,不再次递增,只清理明确的失败生成物。单架构重建后核对完整 Mac 清单,避免丢失另一架构引用。

观察执行进度

  • 跟踪 PACKAGE_STEP、测试总结、builder 进度和 PACKAGE_*_OK 标记。开始等待前说明当前阶段;更新应包含新阶段、已确认结果或新的诊断,不连续发送“仍在等待”。
  • 工具等待采用约 30 秒一次的有界等待。长时间无输出先检查当前子进程、CPU、经过时间及测试已有超时,不能把静默直接判断为卡死,也不能依据 CPU 活动宣称测试已通过。
  • 已确认本轮失败且需要重跑时,可结束该轮测试子进程,让编排器完成运行时恢复;核对其子进程已退出再重启。不要误杀用户开发应用,或直接杀掉编排器导致 finally 不执行。具体判断见诊断参考。

验收与交付

  • verify-test-package.mjs 检查安装包非空及包内运行时完整;可运行的目标完成首次启动和重新打开冒烟,覆盖 Main、Renderer、Preload、Core / Agent / Tool Utility。PACKAGE_SMOKE_SKIPPED 表示未完成运行验证。
  • Mac 同时通过 DMG 校验、codesign --verify --deep --strict、顶层 Signature=adhoc 和挂载后包内应用验证;ZIP 也检查压缩完整性。仅清除本轮 DMG 意外残留的隔离属性。
  • 核对请求目标的文件名、版本、大小、生成时间及 latest*.yml 的引用和 SHA-512;两种 Mac 架构清单应完整保留。开发运行时恢复必须通过,但它不等于开发桌面已启动。
  • 简洁报告版本、产物链接、验证结果及必要修复;跨平台包写明“只完成构建和完整性检查,未完成目标平台运行验证”。Mac ad-hoc 签名不等于 Developer ID 或公证,不承诺下载后无提示打开。

© swjybky, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .codex/skills/windows-macos-test-package of swjybky/deepwrite.

  • SKILL.md
  • references/troubleshooting.md

Open the folder on GitHubat commit bca32cb

Compare with similar skills

Windows macOS Test Package next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Windows macOS Test Package compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Windows macOS Test Package this skillswjybky/deepwrite597—~999Automated safety check: PassApache-2.0
Crabboxopenclaw/gogcli8.5k—~8kAutomated safety check: NotesMIT
Tauri Packagingbkywksj/knowledge-base330—~3.3kAutomated safety check: PassCustom licence
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT

Similar skills

  • Crabbox

    openclaw/gogcli

    Use the Crabbox wrapper for OpenClaw remote validation across Linux, macOS, Windows, and WSL2, including delegated Blacksmith Testbox proof.

    8.5k GitHub stars~8k tokensUpdated today
    Auto-check: notes
  • Tauri Packaging

    bkywksj/knowledge-base

    Tauri 打包与分发技能,指导桌面端(Windows/macOS/Linux)与移动端(Android/iOS)的构建、签名和分发。

    330 GitHub stars~3.3k tokensUpdated today
    MobileAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated today
    Testing & QAAuto-check passed
  • Native Feel Cross Platform Desktop

    yetone/native-feel-skill

    A skill your agent uses when the user is designing, prototyping, or rewriting a desktop app that must run on multiple OSes (macOS + Windows, optionally Linux) AND feel indistinguishable from a…

    1.9k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed

More from swjybky/deepwrite

  • Package Patch Release

    swjybky/deepwrite

    为 DeepWrite 桌面端递增一个 SemVer 补丁版本,安全清理上一个版本的测试打包残留,使用项目规定的 pnpm pack:test 命令构建并验证新安装包,按用户要求决定是否创建并发布 GitHub Release;Release 完整可下载后更新根目录 update.json,并通过路径限定提交和推送,保证该提交只包含…

    597 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Package Patch Release

    swjybky/deepwrite

    为 DeepWrite 递增补丁版本、清理旧产物、修复错误并继续打包;按授权发布 GitHub Release,发布验证后仅提交推送 update.json。用于打包新版本、提高一小个版本、清理旧包发布或更新发布清单。

    597 GitHub stars~675 tokensUpdated today
    Auto-check passed
  • Git Commit

    swjybky/deepwrite

    在 DeepWrite 创建 Git 提交、推送、Pull Request 或合并时使用,核对变更范围、项目校验、提交身份与署名。

    597 GitHub stars~250 tokensUpdated today
    Auto-check passed
  • 按 DeepWrite 桌面端约定构建 Windows 与 macOS 测试安装包:使用 electron-builder 与 pnpm pack:test:,经 tools/run-test-package.mjs 编排,Mac 测试包做 ad-hoc 签名且不做 Apple 公证。用于用户提出“打包”“打测试包”“打 Win 包”“打 Mac…

    597 GitHub stars~778 tokensUpdated today
    Auto-check passed

Works with

Questions about Windows macOS Test Package

What does Windows macOS Test Package do?

构建并验证 DeepWrite Windows、macOS 测试安装包,按失败阶段诊断和恢复。用于打包、测试包、Win/Mac 包及相关流程修改;版本递增和发布另用 package-patch-release。. Windows macOS Test Package is an agent skill from swjybky/deepwrite.

How do I install Windows macOS Test Package in Claude Code?

Run `npx skills add swjybky/deepwrite --skill windows-macos-test-package -a claude-code`. Or copy the skill folder (.codex/skills/windows-macos-test-package in swjybky/deepwrite) into .claude/skills/windows-macos-test-package in your project. Claude Code loads it when a task matches its description.

How do I install Windows macOS Test Package in Codex?

Run `npx skills add swjybky/deepwrite --skill windows-macos-test-package -a codex`. Or copy the skill folder (.codex/skills/windows-macos-test-package in swjybky/deepwrite) into .agents/skills/windows-macos-test-package in your project. Codex loads it when a task matches its description.

Can I use Windows macOS Test Package in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add swjybky/deepwrite --skill windows-macos-test-package -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/windows-macos-test-package, .gemini/skills/windows-macos-test-package, .github/skills/windows-macos-test-package and .opencode/skills/windows-macos-test-package in your project.

What does Windows macOS Test Package need to run?

Going by SKILL.md and its folder, Windows macOS Test Package needs the command-line tools its instructions call (pnpm).

Does Windows macOS Test Package access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Windows macOS Test Package safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Windows macOS Test Package use?

Windows macOS Test Package is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Windows macOS Test Package use?

About 999 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Windows macOS Test Package?

Skills that share tags, products or a category with Windows macOS Test Package: Crabbox (openclaw/gogcli, 8.5k stars), Tauri Packaging (bkywksj/knowledge-base, 330 stars), Engine Whats New (flutter/flutter, 179k stars) and Openclaw Live Updater (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Windows macOS Test Package?

swjybky (a GitHub user) maintains it in swjybky/deepwrite, which has 597 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.

Source: swjybky/deepwrite on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.