tools

Use when setting up or maintaining GitHub Actions release automation for an Electron project. Covers first-time setup (workflow file, .npmrc mirror issues, tag management) and ongoing release maintenance (when to cut a release, editing draft releases, versioning). For projects with a self-rolled 国内加速 auto-updater, also covers the update-manifest.json / sync:manifest step and the version-alignment red lines. Examples: 'set up release workflow', 'publish a new version', 'Actions build failed', 'how do I release', '发版要改哪几个地方', 'update-manifest 怎么同步'.

当某项工作需要用户在 Windows 机器上手动执行（命令、火绒/杀软操作、系统设置、文件检查等），而对话窗口只在另一台机器（如 macOS）上看得到时，把操作步骤整理成一份独立的 md 指导文件写进仓库，让用户切到 Windows 后照着做、回填结果。适用于安全排查、环境配置、打包部署等跨机器协作场景。触发词：「需要在 Windows 操作」「我在 Windows 看不到这个窗口」「写个 md 指导我」「整理成文件」。

在现有页面设计基础上添加新功能时，如何让新元素自然融入而不是强行插入按钮或入口。

Apply SemVer rules (MAJOR.MINOR.PATCH) for software releases. Use when determining version numbers for application updates.

在项目根目录维护以「idea 阶段」为单位的开发日志，解决跨设备、多项目并行时的上下文恢复问题。当用户要求为某个项目初始化这套体系（创建 docs/ideas/ 和第一个 md）、为已有项目补建、新增一个 idea 阶段文件、或归档当前阶段开启新阶段时使用。每个项目独立维护,按 idea 周期累积编号文件，序号最大的文件即为当前进行中。

Writing user-facing release notes for MapleTools (or similar desktop apps). Use when drafting or revising changelog/release note documents intended for end users, not developers.

Package / build an npm (Electron) project on Windows reliably. Use when writing or debugging build / dist / package automation that runs on Windows.

Standard operating procedure and best practices for converting raw HTML/Tailwind mockup files into modular React pages within the Maple Tools project.