SuperAPI AI 工具集

app-brief

编程与开发

查看项目

更新于 11-02 16:28

技能介绍

用途:app-brief 用于在开发新 Windows 应用之前,把想法整理成一页式简报 docs/BRIEF.md,位于以应用名命名的文件夹中(<parent><AppName>\docs\BRIEF.md,需询问父文件夹,默认为 $HOME\Developer)。该简报会被后续技能读取。

主要步骤:

  1. 命名与读取已有资料:先定一个 UpperCamelCase 单词作为名称(如 Tasks、DailyLog),避免与已安装应用重名(检查开始菜单与 %LOCALAPPDATA%\Programs)。若存在 docs/research/ 或 docs/screens/INDEX.md 先读取;若用户提供 specs/ 中的规格,则把 Brief 块复制到 docs/BRIEF.md、Stories 块复制到 docs/STORIES.md,其余保留为 docs/SPEC.md,并只询问需要修改之处。
  2. 访谈:分批提问,包括当前做法与被替代的应用或习惯、最常做的三件事(对应主要页面)、持有的数据名词、是否有喜欢的参考应用、应用形态(导航窗口、托盘图标、全局快捷键快速面板或混合)、是否需要联网(默认否)、第一版明确排除的三件事、外观偏好(原生 Windows 11 风格及强调色,或类似某应用)。若用户授权代为决定,则基于调研自行填写并标注“decided by the agent”。
  3. 裁剪范围:个人应用只需一个用户,去掉账号、分享、团队、同步服务器、计费、引导、分析等;若需两台电脑同步,记为“以后通过 OneDrive 文件夹同步”。第一版规模为一个窗口、2 到 5 个主页面、一个数据模型含 2 到 4 种类型;过滤同一模型的智能列表(Today、Upcoming、Someday)算作一个页面。
  4. 写入简报:包含标题、一句话说明、Replaces、Main jobs(三条)、Data(类型与字段)、Shape(形态与 Windows 11 兼容说明、本地数据、离线、无账号)、System hooks、Reference、Look、Not in version one。
  5. 交付衔接:调用 user-stories 技能,或若用户想先看窗口则调用 new-windows-app。完成标准为 docs/BRIEF.md 存在、控制在一页内且包含所有小节。

适用场景:有应用想法、想替换付费应用、或需要在写代码前明确范围与需求时。限制:不生成代码;不涉及具体定价或平台承诺;部分信息(如官方收费、具体实现效果)暂未提供。