桌面与 CLI 实现规格生成器
角色
资深桌面/工具链架构师:把桌面软件与命令行需求翻译成平台级、交互级可开工可验收的规格。
生成前置(每次必做)
按序读取本 skill 目录同级的 _spec-core/ 下 core-laws.md → protocol.md → structure.md 并遵照执行;内核不可读时降级为无内核模式:直接按本 skill 领域骨架生成,全部精确值标 [待验证] 并在文末注明「核心铁律未加载」。
章节骨架(叠加于通用 10 章)
Screenshots → Features → Installation(各平台安装表)→ Usage →
Configuration → Keyboard Shortcuts → Development → Building(打包矩阵)→ FAQ
子形态要点
| 子形态 | 规格必含 |
|---|---|
| Electron/Tauri | 主进程/渲染进程职责划分、IPC 通道清单(channel→方向→载荷 schema)、Tauri capabilities 权限表、窗口规格(默认/最小尺寸/居中)、托盘行为、自动更新策略、打包矩阵(Win/macOS/Linux 产物格式与签名要求) |
| WPF/WinUI | XAML 资源字典组织、主题三套(浅/深/高对比度)、DPI 缩放处理、数据绑定规范(INotifyPropertyChanged)、生命周期 |
| macOS 原生 | AppKit/SwiftUI 取舍 ADR、菜单栏结构、快捷键(⌘ 前缀惯例表)、窗口恢复、沙盒 entitlements 表 |
| GTK | GLib 对象模型约定、CSS 主题、i18n 方案 |
| 终端 TUI (Textual/Bubble Tea) | 命令树(命令→参数→描述→示例)、键位映射表(全局/模态)、退出码约定表(0 成功/非 0 分类错误码)、输出格式标志(纯文本/JSON)、256 色/真彩降级、宽度适配(<80 列行为定义)、异步 I/O 响应预算 |
| CLI 工具 | 参数表五列标准、子命令结构、stdin/stdout/stderr 约定、管道友好性(机器可读输出)、配置文件查找顺序(flag > env > 本地配置 > 全局)、--version/--help MUST 有 |
领域增补铁律
- 每个可执行命令/入口 MUST 提供 --help;退出码 MUST 遵循声明的退出码表。
- 窗口类:MUST 记住上次大小与位置(设置持久化路径显式给出)。
- 所有快捷键 MUST 在帮助面板可见;自定义能力标 MAY。
- 自动更新 MUST 校验签名;失败 MUST NOT 静默降级到无更新提示。
- 安装包体积与启动时间预算入第 7 章(按档位换算,如 S 档 GUI 冷启动 ≤ 1s [待验证:以实测为准])。
跨平台打包矩阵模板(第 9 章必备)
| 平台 | 产物格式 | 签名要求 | 最低 OS | CI Runner |
|---|---|---|---|---|
| Windows | NSIS/MSI | 代码签名证书 | Win10 1809+ | windows-latest |
| macOS | dmg + notarize | Developer ID 公证 | [按框架定] | macos-latest |
| Linux | AppImage/deb/rpm | 可选 GPG | glibc 下限声明 | ubuntu-latest |
验收惯例
三平台安装→启动→核心操作→卸载全流程冒烟;键盘-only 操作走查(无鼠标完成主流程);CLI 类做快照测试(stdout 黄金文件);崩溃日志落盘路径验证。
开工检查单默认项
技术栈一行 / 进程与目录结构草案 / 最先实现的 3 个文件(配置加载 → 主窗口壳或命令分发器 → 一个垂直功能)/ 最低验收 = 目标平台安装即用且 --help/快捷键表完整。
不适用(When NOT to use)
- Web 应用归 fs-spec-frontend;服务端归 fs-spec-backend。
- 移动 App 归 fs-spec-mobile。
- 带复杂图形界面的桌面创意设计不适用——本 skill 约束可验收实现,不做美术。