MooTool Next Compose Cursor 驱动开发指南:可直接投喂的任务提示词与工程落地实践
MooTool Next Compose Cursor 驱动开发指南:可直接投喂的任务提示词与工程落地实践
导读
docs/cursor-prompts.md 是 MooTool Next Compose 产品线为 Cursor 类 AI 编码代理准备的六段「可直接复制投喂」的任务提示词。它覆盖了独立 Compose Multiplatform Desktop 产品的启动(P0/P1/JSON 纵向切片)、单工具完整交付、编辑器与多窗口专项、布局与现代 UI 校准、独立安装与更新验收,以及「继续上次工作」六类高频协作场景。读完本文,你将掌握如何给 Cursor 划定 next-compose/ 工作边界、如何让代理按证据驱动的方式实施编码、验证与记录进度,并能对照仓库中的 AGENTS.md、验收文档 和源码逐条理解每段提示词背后的工程约束。
一、为什么需要一份「可直接投喂」的提示词
MooTool Next Compose 是一个与 Java、Electron、Tauri、Flutter、macOS Native 并列的独立产品线。它的开发约束和根 Java 工程不同:桌面 UI 壳、导航、面板、设置与工具页面全部用 Compose 编写;只复制有授权的代码;不得把相邻产品变成构建或运行依赖。这种「产品独立」边界如果不在会话第一条消息里讲清楚,AI 代理很可能下意识去读 ../next 的 Electron 源码、引入根 src 的 Java 类,甚至把数据写到别的产品目录。
因此 cursor-prompts.md 在正文之前先用两段话固化了两个协作约定:
- 工作区范围:建议打开
next-compose/;如果打开整个仓库根,则必须明确「所有路径以仓库根的next-compose/为工作范围」。 - 文档读取不能省略:嵌套
.cursor/rules是否启用取决于工作区打开方式,所以第一条消息始终明确要求读取文档,不能赌规则文件会自动加载。
文档还特别注明「任务描述默认会实施编码;本次文档编写没有执行这些后续任务」,并且建议「根据准备开展的阶段复制相应段落,不必一次要求完成整个产品」——这是提示词集最核心的使用方法论:按阶段增量推进,一次只推进一个最小完整工作流。
二、使用前的准备:Cursor 的阅读入口与文档顺序
cursor-prompts.md 提到的所有文档都在仓库中真实存在,提示词里让代理先读的清单正好对应 next-compose/README.md 中「给 Cursor 的阅读入口」表格:
| 文档 | 解决的问题 |
|---|---|
| AGENTS.md | 开发约束:产品边界、真实功能、完成标准 |
| 编码开发主指南 | 目标、范围、优先级、开发阶段和第一轮任务 |
| 源码基线与参考地图 | Electron/Java 的实际版本、源码位置、已核实差异 |
| UI 与交互规格 | 窗口布局、视觉 Token、页面结构、现代化规范 |
| 逐工具功能规格 | 首页、25 个工具、设置及通用能力的功能与验收要求 |
| Compose 技术架构 | Kotlin/JVM、编辑器、线程、状态、多窗口和算法选型 |
| 数据、平台与发布 | 独立安装、数据、Vault、系统能力、更新和发行 |
| 验收与进度记录 | 可执行检查、逐项状态、视觉与平台验收 |
AGENTS.md 把「开始工作」固定为三步:先读 README 与开发主指南、再读本次涉及的 UI/功能/架构/验收章节;检查 Git 状态并保留其他产品的未提交工作;首次开发记录真实版本组合和源码基线,工程建立前不声称 Gradle 命令已通过。这些约束的意图很明确——AI 代理的完成报告必须区分「代码存在」和「功能已验收」。
仓库中已锁定的工具链也应当作为提示词的一部分背景信息传递给代理:JDK 21(Zulu 21.0.12.1)、Gradle Wrapper 8.14.3、Kotlin 2.2.21、Compose Multiplatform 1.12.0,版本来源是 gradle.properties 中的 appVersion=0.1.0,全部依赖写在 libs.versions.toml。
三、提示词一:启动 —— P0、P1 与 JSON 纵向切片
这是最完整、信息密度最高的一段提示词,原文如下:
请在 /Users/zhoubo/IdeaProjectsCE/MooTool/next-compose 开发 MooTool Next Compose。
先读 AGENTS.md、README.md、docs/cursor-development-guide.md、docs/baseline.md、
docs/ui-spec.md、docs/architecture.md、docs/data-platform-release.md、
docs/feature-parity.md、docs/acceptance.md。检查 Git 状态并保留已有修改。
目标是独立 Compose Multiplatform Desktop 产品,主要对齐当前 next/ Electron 的
布局、操作和功能,用 Java 版补充 JVM 算法;在此基础上统一现代桌面 UI。
各版本产品线独立,允许重复代码,禁止依赖相邻产品构建/运行/资源/数据库。
本轮完成 P0 + P1 + JSON 最小真实纵向切片,不要一次铺满 25 个假工具。
先冻结可构建的 Kotlin/Compose/Gradle/JDK 组合并创建独立 Wrapper 工程。
验证编辑器的中文输入、列编辑、undo、弹层与窗口转移;验证动态 proto 和打包风险。
完成 26 入口注册、导航、搜索、modern 明暗、基础设置、会话/分离收回与自有数据路径。
JSON 切片要能真实导入、编辑、校验、格式化/压缩、查找、复制/导出、undo、历史恢复。
其余工具可以明确显示“尚未实现”,不能返回 mock 成功。
使用本产品临时 profile 测试,不能写其他版本个人数据。完成本机测试、独立目录构建、
安装镜像启动与必要 UI 检查;把真实版本、命令结果、截图及未测平台记入 docs/evidence。
更新 docs/acceptance.md 和 README。不要把 JSON 切片标记成完整 P2/F04 通过。
在已有授权范围内持续完成工作,最终报告结果、验证证据、限制和下一轮具体任务。
3.1 这段提示词背后的阶段划分
从 cursor-development-guide.md 的分阶段路线图看,P0 的退出条件是「本机独立目录构建/启动/打包成功 + 关键实验有真实证据」,P1 是「重启恢复、设置同步、分离/收回、键盘流程可用」,P2 的完整 JSON 工作流(含 JSONPath、Vault Git 高级能力)属于后续阶段。所以提示词要求「不要把 JSON 切片标记成完整 P2/F04 通过」——切片只是 P2 的起点。
3.2 为什么「不要一次铺满 25 个假工具」
这是防止 AI 代理最常见的失败模式:为了快速产出大量页面而用统一 TextField 替换每个工具,或者用固定提示文案冒充真实功能。AGENTS.md 的「完成标准」明确写了「功能必须真实执行;按钮不能以固定提示、示例输出或空实现假装成功」。当前仓库的 release-notes/0.1.0.md 也如实记录了首版切片范围:独立 Gradle 工程、产品身份、26 入口壳、modern 明暗、设置基础项和真实 JSON 工作区,其余工具明确保持未实现状态。
3.3 源码佐证:26 入口注册、产品身份与数据路径
提示词要求「完成 26 入口注册、导航、搜索……与自有数据路径」,这三件事都能在源码中找到对应实现:
- 26 入口注册:ToolRegistry.kt 中
ToolRegistry.tools按Home/Text/Dev/Network/Encode/Daily/System六个分组注册了 26 个条目(首页 + 25 工具),每个条目带稳定ToolId、三语标题 key、本地化/英文/日文关键词、字形图标、历史/收藏能力标志与开发状态。search()用Locale.ROOT稳定的方式匹配 ID、本地化标题和关键词,这正是提示词里「导航、搜索」的落地。 - 自有数据路径:AppPaths.kt 按 macOS/Windows/Linux 分别解析
configRoot、dataRoot、cacheRoot、logRoot,支持MOOTOOL_COMPOSE_DATA_DIR环境变量覆盖到隔离 profile——正是提示词「使用本产品临时 profile 测试,不能写其他版本个人数据」的机制。 - 产品身份:ProductIdentity.kt 集中了
PRODUCT_ID = "next-compose"、DISPLAY_NAME = "MooTool Next Compose"、APPLICATION_ID = "com.rememberber.mootool.next.compose"、LINUX_PACKAGE、WINDOWS_UPGRADE_UUID等全部身份常量,单一来源、不在工具页面散落字符串。
3.4 动态 proto 与打包风险的前置验证
提示词要求「验证动态 proto 和打包风险」。architecture.md 第 8 节给出了具体路线:随产品按 OS/arch 分发 protoc 4.29.3,启动受控子进程输出 descriptor set,再由 JVM DynamicMessage 编解码。composeApp/build.gradle.kts 中可以看到 protocHelpers 配置把 osx-x86_64、osx-aarch_64、linux-x86_64、linux-aarch_64、windows-x86_64 五个 classifier 的 protoc 复制进 classpath helpers/ 的真实实现。
打包风险对应 ADR-001:JDK 21 的 macOS jpackage 拒绝 --app-version 0.1.0(首个数字不能为 0),因此构建脚本把 0.x.y 映射为 1.x.y,UI 内仍显示 0.1.0——这是「冻结可构建的工具链组合」时最容易踩的坑,提示词让代理先验证打包正是为了尽早暴露它。
四、提示词二:完成一个工具 —— 按 <F编号/ToolId> 交付真实功能
继续 next-compose 的 <F编号/ToolId>。先读本产品约束、对应功能/UI/架构/验收章节。
查阅 docs/baseline.md 指向的 Electron 当前页面、相关算法/服务/测试及 Java 对照。
先列出实际 Tab、按钮、选项、默认值、数据字段、主流程、错误与取消语义,再实施。
完成真实算法/IO、UI、会话、历史或收藏、设置联动、保存恢复和键盘行为。
不要只做默认 happy path,也不要用一个通用 TextField 替换该工具原有多面板工作流。
复杂参数以源测试冻结;源实现错误可修正,但保留 sourceObserved 与 composeExpected。
构建和运行必须仅依赖 next-compose;可授权参考代码可复制后独立维护。
运行与本功能相关的 fixture、集成、UI 和必要平台检查,补明暗/默认/错误截图。
更新逐项验收及证据,说明具体未完成项;未运行的检查明确写未测。
4.1 「先列规格,再实施」的防漂移策略
工具编号对应 feature-parity.md 中的 F00–F25 与 Tool ID 表:F01 quickNote(随手记)、F02 textDiff、F03 reformat、F04 json、F05 java(代码运行)、F06 ymlProperties、F07 protobuf、F08 variables、F09 http、F10 host、F11 net、F12 uaParse、F13 encode、F14 crypto、F15 regex、F16 cron、F17 qrCode、F18 timeConvert、F19 messageBoard、F20 translation、F21 calculator、F22 colorBoard、F23 image、F24 pdf、F25 hardware。
提示词要求第一步先「列出实际 Tab、按钮、选项、默认值、数据字段、主流程、错误与取消语义」,这与 cursor-development-guide.md 第 3 节「阅读与实施方式」一致:从功能规格找条目 → 按 UI 规格定面板关系 → 先完成一条真实输入到输出路径 → 用验收记录结果。这一顺序能有效阻止代理跳过规格直接写一个通用输入框。
4.2 验收分层:fixture、集成、UI 与平台检查
提示词强调「复杂参数以源测试冻结;源实现错误可修正,但保留 sourceObserved 与 composeExpected」——这是 MooTool Next Compose 记录跨产品差异的标准做法。仓库 docs/diff/ 下 450+ 篇 DIFF 文档的编号约定(如 DIFF-018 HTTP 重复 Header、DIFF-003 正则 Java Pattern)就是这种「原行为 vs 新行为 + 理由 + 证据 + 影响范围」四段式记录的载体。
acceptance.md 第 1 节定义了严格的状态规则:状态只使用「未开始、开发中、待验收、已验收、明确差异」;已验收必须有具体证据;明确差异必须有 DIFF 记录。第 3 节给出了完整测试命令链:
cd /path/to/next-compose
export JAVA_HOME="$(/usr/libexec/java_home -v 21)" # macOS 示例
./gradlew --version
./gradlew :composeApp:printTooling
./gradlew :composeApp:desktopTest --offline --no-daemon # macOS 若 daemon 下 exit 134,保留 --no-daemon
./gradlew :composeApp:run
./gradlew :composeApp:createDistributable
./gradlew :composeApp:runDistributable
./gradlew :composeApp:packageDistributionForCurrentOS
验收文档同时给出了「测试层级」矩阵:纯逻辑/fixture 不能代替输入法和真实文件系统;临时目录/DB 集成不能代替真正安装/卸载;受控网络/进程不能代替在线服务真实可达性;Compose UI 测试不能代替 Swing 编辑器内部节点完整覆盖;安装镜像/目标 OS 验证不能代替 run 或 IDE 预览。这正是提示词「未运行的检查明确写未测」的底层逻辑。
4.3 当前仓库中工具的落地形态
从 acceptance.md 第 2 节可以看到,多数工具已进入「待验收/开发中」状态并配有证据帧:F02 文本对比已实现行/字符 Myers 差异、三种高亮、忽略空白与统一补丁;F03 格式化已实现 Nginx/Java/XML/HTML 真实解析;F04 JSON 已有检查器结构面板、Schema 推断、JSONPath 查询;F09 HTTP 已有 OkHttp 引擎、cURL 解析、10 MiB 上限与冻结 GET/表单语义;F15 正则用 Java Pattern + 独立 worker 子进程超时终止。每条都链接到对应 DIFF 与 docs/evidence/2026-09-15-inspector-screencapture/windows/ 下的运行截图,体现「每项完成至少包含正常结果、关键错误、持久化/状态验证、必要视觉检查」的维护规则。
五、提示词三:编辑器与多窗口专项 —— EditorHost 与 Swing 互操作
请完成 next-compose 的 EditorHost 和多窗口所有权验收。
重点读取 docs/architecture.md 第 5–6 节和 docs/acceptance.md T04–T07。
验证 5 MiB 中文/emoji/Tab 文本、中文预编辑、普通/矩形选择、块粘贴、查找替换、
格式化一次 undo、软换行、选区/滚动、自动保存、深色与 DPI。
执行编辑→分离→编辑→收回→undo,并检查只存在一个文档写入者和一套事件监听。
检查搜索/设置/菜单/对话框是否被 Swing 遮挡;关闭后焦点是否返回。
先修复当前实现,不将功能困难直接改成“兼容差异”;如首选组件确实无法满足,
做具体替代实验并形成 ADR,说明已验证能力与尚缺能力。不得以普通文本框交差。
使用实际桌面交互证据补充测试,不能仅靠 headless 单元测试宣称输入法通过。
5.1 编辑器方案:RSTA + SwingPanel 的验收契约
architecture.md 第 5 节定义了 EditorHost 契约:文本/语言、只读、字体主题、软换行、行号、语法、选区、滚动、聚焦、查找/替换、事务编辑、undo/redo、状态快照、图片/文件拖放转交。首选实验是 RSyntaxTextArea + SwingPanel,ADR-002 记录了这一决定:EditorBuffer 持有 RSTA 的 Document 与 UndoManager;Compose SwingPanel 只托管已有的 RTextScrollPane,不因重组重建文档;格式化/替换/列编辑通过 CompoundEdit 记为一次 undo。
5.2 列编辑是硬性验收项,不是可选项
提示词里列出的「普通/矩形选择、块粘贴」对应 architecture.md 5.3 节「列编辑不能省略」:矩形选择基于可视行列,本产品按逻辑行处理并在开启换行时提示;列单位按等宽网格,Tab 展开遵循 tabSize,宽字符按 Unicode 宽/窄启发式(汉字/emoji 计 2 宽),不截断 surrogate/组合字符。实现细节见 DIFF-024,列编辑引擎、Alt 拖选、换行切换清列选、IME 提交写入列选择的实现状态记录在 acceptance.md P0/P2 行。
5.3 多窗口所有权与 Swing 遮挡问题
提示词「执行编辑→分离→编辑→收回→undo,并检查只存在一个文档写入者和一套事件监听」对应架构第 6 节的多窗口会话模型:状态转移是 Docked → Transferring → Detached → Transferring → Docked,转移过程冻结重复命令,旧宿主停止接收事件后才挂新宿主;同一个 JComponent 不能同时加入两个父容器。
「检查搜索/设置/菜单/对话框是否被 Swing 遮挡」在仓库中有明确解法:DIFF-058 记录 SwingPanel 是重型组件会盖住同窗口里的 Compose 遮罩,因此 ModalOverlayState 在打开 overlay 时暂时卸下 EditorHost 的 SwingPanel,关闭后恢复同一 EditorBuffer;应用内遮罩统一采用 MooOverlay(实底 + 点遮罩关闭 + Esc),见 DIFF-057 至 DIFF-060。
提示词最后强调「不能仅靠 headless 单元测试宣称输入法通过」——acceptance.md 反复标注「系统 IME 预编辑仍未手工验收,不能标 F04 已验收」,且明确 compact-960-focus-ring.png、70-column-edit-jframe.png 等 Compose 测试场景图不能代替产品窗口 IME 手工验收。
六、提示词四:布局与现代 UI 校准
按 docs/ui-spec.md 审查并修复 next-compose 的实际页面。
保持当前 Electron 的入口顺序、主要面板关系与操作位置;改善层级、对齐、密度、
明暗对比、焦点、tooltip、错误就近反馈和窄窗口行为。
使用相同测试内容,核对 1440×920 与 1080×720、三语言和适用 DPI;重点检查
JSON/随手记/HTTP/设置/独立窗口,不把沉浸式工具区改成大标题/大卡片。
调整公共 Token 和组件以保证一致,避免逐页硬编码。截图必须来自运行的程序。
最终提供变更前后、已检查状态和仍受平台限制的行为;更新验收证据。
6.1 UI 规格的可执行内容
ui-spec.md 提供了大量可直接核对的具体数值:
- 窗口尺寸:Electron 主窗口默认 1440×920、最小 1080×720,Compose 沿用默认并以 1080×720 为必须完整可用尺寸,960×640 作为紧凑布局目标。
- 侧栏与分栏:侧栏初始 248、折叠 84,拖动范围 208–300;拆出工具窗口不再渲染总侧栏。
- 视觉 Token:
MooTheme统一提供 workspace/surface、sidebar、toolbar、border、textPrimary、accent、focusRing、success/warning/danger 等 Token 的明暗两套值,并明确「不能逐页使用近似色」。 - 密度:圆角对照各风格
--desktop-control-radius;正文 13 sp/Medium、控件 12 sp/SemiBold;状态栏 10 sp;动效 80–140 ms。
6.2 「截图必须来自运行的程序」
提示词这一约束对应 ui-spec.md 第 9 节「视觉验收」:所有截图必须来自实际程序,不用设计稿作为实现验收;文档中的文本线框只是布局约定,不代表已做视觉比对。这与 acceptance.md 的证据规范一致——仓库证据目录 docs/evidence/ 下保存的是真实 screencapture -l 截取的窗口帧。
6.3 避免逐页硬编码:Token 与 LayoutPolicy
提示词「调整公共 Token 和组件以保证一致,避免逐页硬编码」在仓库中对应 MooTheme/MooButton/MooIconButton/MooGhostButton 等公共组件与 LayoutPolicy(现代/quiet 风格下非 p5 工具栏 7dp 圆角、13sp/500 字体等),以及 DIFF-501~DIFF-505 一批「样式对齐 Electron CSS 变量」的增量记录。六套导航风格(classic/card/grouped 与 modern/hero/quiet/smartisan/miui/claude 视觉风格)的 token 决策也集中在这些 DIFF 中。
七、提示词五:独立安装与更新验收
按 docs/data-platform-release.md 完成 next-compose 的打包和并存验收。
检查 ProductIdentity、bundle/AppUserModelID、安装名、快捷方式、升级 UUID、
数据/缓存/日志/凭据/锁、helper 和更新 next-compose 节点,不能只检查包名。
在隔离系统中与 Java/Electron 并存,验证各自主题/草稿/历史不互相影响,
Compose 升级及卸载不改其他产品。启动自带 runtime 的最终镜像,确认无相邻产品依赖。
更新只比较 next-compose 的 SemVer,错误架构/坏大小或 hash 不得安装。
首版是下载校验后打开安装包;无真实自动安装服务时不要显示“自动安装成功”。
各 OS 在对应 runner 构建/启动。准确记录已测/未测平台、签名和权限状态。
若本轮未要求公开发布,只完成可审查的包、配置和证据,不创建线上 Release。
7.1 身份表与「不能只检查包名」
data-platform-release.md 第 1 节的身份表规定了全部身份值:Product ID next-compose、完整名称 MooTool Next Compose、bundleID/AppUserModelID com.rememberber.mootool.next.compose、Linux 包 mootool-next-compose、Git tag next-compose-v{semver}、更新节点 update-manifest.json 的 products.next-compose。提示词「不能只检查包名」的原因在文档里写得很清楚:应用 ID、安装目录、可执行名称、快捷方式和卸载注册项必须分别验证,不能只改一个 bundleID 就声称隔离完成。
源码中这些常量集中在 ProductIdentity.kt 与 composeApp/build.gradle.kts 的 p7* 系列变量(packageName、bundleID、macOS minimumSystemVersion = "12.0"、Windows upgradeUuid 与 perUserInstall、Linux packageName),并有 verifyNativePackageMetadata 任务对它们做构建期断言。
7.2 数据隔离与路径布局
data-platform-release.md 第 2 节的路径表给出了三平台目录:macOS ~/Library/Application Support/com.rememberber.mootool.next.compose/、Windows %APPDATA%/MooToolNextCompose/、Linux $XDG_CONFIG_HOME/mootool-next-compose/(缺省回退 ~/.config 等)。开发/测试用 MOOTOOL_COMPOSE_DATA_DIR 覆盖到隔离 profile,凭据用测试 backend,禁止访问真实 Keychain。这些在 AppPaths.kt 中逐平台实现。
7.3 更新通道:校验后打开安装包
提示词「首版是下载校验后打开安装包;无真实自动安装服务时不要显示‘自动安装成功’」对应的实现是 DIFF-027:UpdateEngine 只读 products.next-compose;节点未登记或 status != active 时结果为 Unpublished 并打开本产品 release 页;稳定版忽略 prerelease;只选当前 OS/arch;HTTPS 下载到 cache/updates,校验字节数与标准 Base64 SHA-512,成功后写 {fileName}.ready,校验失败删除临时文件不打开。autoCheckUpdates 默认 true(启动 2.5s 后、每小时一次),autoDownloadUpdates 默认 false。
7.4 三平台矩阵的诚实记录
acceptance.md 第 6 节平台矩阵如实标注:macOS arm64、Windows x64、Linux x64 均未测,不可声明已支持;macOS x64 仅「开发机可用,非正式支持」。提示词「各 OS 在对应 runner 构建/启动。准确记录已测/未测平台」正是为了维持这种不夸大的验收纪律。
八、提示词六:继续上次工作 —— 证据驱动的续接
继续 next-compose。先检查实际 Git 状态、README、docs/acceptance.md、最近 evidence
和相关 ADR,核实已完成的代码及测试,不从头重建,也不相信没有证据的完成标记。
选取当前阶段最小且完整的未完成工作流,保持产品独立边界和既定 UI/功能规格。
修复本轮问题并完成相应检查后更新进度;不要批量把其他未验证功能标成完成。
最终说明本轮真实变化、验证、剩余问题和下一步。
8.1 「不从头重建」与「不相信没有证据的完成标记」
这是 AI 代理协作中最关键的一条防呆规则。仓库的 acceptance.md 记录了大量「有代码但未验收」的条目,例如 F04 JSON 行「系统 IME 预编辑仍未手工验收,不能标 F04 已验收」。如果不先读 acceptance 与 evidence,代理很可能把「代码已存在」误判为「功能已完成」,或者把其他版本的测试通过误当成 Compose 测试通过。baseline.md 对此有明确警告:Electron 注册表里的 in-progress/parity-review/complete 是 Electron 作者的状态,不是 Compose 完成证据。
8.2 续接任务的推荐动作序列
结合提示词与仓库维护规则,一次健康的续接应该包含:
- 检查 Git 状态、README 与 acceptance.md 的最新进度表;
- 浏览
docs/evidence/最近的证据目录,确认哪些状态有截图/命令结果支撑; - 阅读与当前条目相关的 ADR 与 DIFF(如编辑器问题先看 ADR-002);
- 选取一个「最小且完整」的未完成工作流推进,如某个工具的
*ActionEnabled接线或一条快捷键链路; - 完成后只更新本条目状态,不批量标记其他未验证功能完成;
- 最终报告「本轮真实变化、验证、剩余问题和下一步」。
九、把提示词与仓库证据连起来:一条可复用的工作流
综合六段提示词,MooTool Next Compose 的 Cursor 协作可以抽象为一条固定工作流:
- 划定边界:明确
next-compose/为唯一工作范围,第一条消息要求读 AGENTS.md 与 开发主指南。 - 读取规格:按基线 → 功能 → UI → 架构 → 数据/发布 → 验收的顺序读完相关章节,先列细粒度控件再动手。
- 锁定证据:复杂参数以 Electron/Java 源测试冻结;出现差异按
sourceObserved/composeExpected写 DIFF;技术困难先做实验并形成 ADR。 - 真实实施:不铺假工具、不用通用 TextField 顶替多面板工作流、不把编译通过当验收通过。
- 分层验证:fixture → 临时目录集成 → 受控网络/进程 → Compose UI → Swing/原生 → 安装镜像,每层不能互相替代。
- 如实记录:版本组合、命令结果、运行截图、未测平台全部写入
docs/evidence/,更新 acceptance.md 的逐项状态。 - 增量续接:下一次任务从 acceptance/evidence 而不是从零开始,只推进一个最小完整工作流。
这套工作流的意义在于把「AI 辅助开发」从「生成代码」提升为「在真实验收标准约束下的增量交付」。对任何希望用 Cursor 稳定推进 Compose Desktop 独立产品的团队,docs/cursor-prompts.md 本身就是一份可以直接复制进会话的首条消息模板——前提是明确工作区、强制读文档、坚持证据驱动。