From cd6d53a3b636cde6a37d0cabf5ab937fdfe94036 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B4=94=E9=B2=81=E6=AD=A3?= <13780741225@163.com> Date: Thu, 10 Sep 2026 12:33:32 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E6=AD=A3=20Task=2014=20?= =?UTF-8?q?=E7=9A=84=20docs=20=E4=BB=93=E5=BA=93=E8=B7=AF=E5=BE=84?= =?UTF-8?q?=E3=80=81=E6=9A=82=E5=AD=98=E6=96=B9=E5=BC=8F=E4=B8=8E=E9=AA=8C?= =?UTF-8?q?=E6=94=B6=E8=AE=B0=E5=BD=95=E4=B8=AD=E7=9A=84=E4=B8=8D=E5=AE=9E?= =?UTF-8?q?=E9=99=88=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plans/2026-09-10-ring-health-app-m0-m1.md | 44 ++++++++++++++----- 1 file changed, 33 insertions(+), 11 deletions(-) diff --git a/superpowers/plans/2026-09-10-ring-health-app-m0-m1.md b/superpowers/plans/2026-09-10-ring-health-app-m0-m1.md index eb13764..cb91ae8 100644 --- a/superpowers/plans/2026-09-10-ring-health-app-m0-m1.md +++ b/superpowers/plans/2026-09-10-ring-health-app-m0-m1.md @@ -4757,7 +4757,7 @@ Expected: `BUILD SUCCESSFUL`，生成 `app/build/outputs/apk/debug/app-debug.apk > （Android SDK 只装了 `platform-tools` / `platforms;android-36` / `build-tools;36.1.0`）。 > 因此下面这份清单**要交给人在有设备时执行**，不要由 agent 尝试 `installDebug`、 > 也不要临时去下模拟器镜像（约 1–2 GB）。执行 agent 在本步的动作是： -> 把清单原样抄进验收报告，明确标注「未执行 —— 无设备」，然后继续 Step 4。 +> 把清单原样抄进验收报告，明确标注「未执行 —— 无设备」，然后继续 **Step 5**（写验收记录）。 > 本条是**已知且有意的覆盖缺口**，不要在其他任何地方把它当成已通过。 在设备上逐项确认： @@ -4811,7 +4811,9 @@ Expected: `BUILD SUCCESSFUL`，生成 `app/build/outputs/apk/debug/app-debug.apk + `DeviceViewModelTest` 2 + `MetricDetailViewModelTest` 3 + `RoutesTest` 2） - 构建：`./gradlew clean assembleDebug` —— `BUILD SUCCESSFUL`， 产物 `app/build/outputs/apk/debug/app-debug.apk` -- IDE Preview：各页面的 `@Preview` 在 Android Studio 中可渲染（这是没有设备时唯一的界面检查手段） +- **未执行**：各页面的 `@Preview` 在 Android Studio 中渲染。本机没有 IDE GUI，agent 无法打开 + Preview 面板，**这一项与人工验收一样是未执行的** —— 不要把它写进「已执行」段落 + （旧稿把它列在上面这一节里，那等于声称验证过一件没做过的事）。 ## 人工验收（未执行 —— 无设备） @@ -4869,27 +4871,47 @@ Expected: `BUILD SUCCESSFUL`，生成 `app/build/outputs/apk/debug/app-debug.apk - [ ] **Step 7: 提交并推送全部仓库** +**只 add 本任务改过的文件**（Global Constraints：不要 `git add -A`）。三个仓库的**实际路径**是： + +| 仓库 | 路径 | 本任务改动的文件（相对仓库根） | +|---|---|---| +| ring-health-app | `/d/cherry/repos/ring-health-app` | `README.md`、`docs/verification-m1.md`、`app/src/main/res/values/strings.xml`、`app/src/main/java/com/placeholder/ringhealth/data/mock/MockRingDeviceRepository.kt` | +| ring-health-docs | `/d/cherry/docs` | `superpowers/plans/2026-09-10-ring-health-app-m0-m1.md`、`superpowers/specs/2026-09-10-ring-health-app-design.md`（**仅当确有偏差需要改**） | + ```bash -cd /d/cherry/repos/ring-health-app && git add -A && git commit -m "docs: 补充 M1 验收记录与页面清单" && git push -cd /d/cherry/docs && git add -A && git commit -m "docs: 补充 M1 实施计划" && git push +cd /d/cherry/repos/ring-health-app +git add README.md docs/verification-m1.md \ + app/src/main/res/values/strings.xml \ + app/src/main/java/com/placeholder/ringhealth/data/mock/MockRingDeviceRepository.kt +git commit -m "docs: 补充 M1 验收记录与页面清单" +git push + +cd /d/cherry/docs +git add superpowers/plans/2026-09-10-ring-health-app-m0-m1.md +# 仅当 Step 5 确实改了设计文档时才追加它： +# git add superpowers/specs/2026-09-10-ring-health-app-design.md +git commit -m "docs: 补充 M1 实施计划" +git push ``` +> **注意 docs 仓库在 `/d/cherry/docs`，不是 `/d/cherry/repos/docs`** —— 三个仓库分别是 +> `/d/cherry/repos/ring-health-app`、`/d/cherry/repos/ring-health-api`、`/d/cherry/docs`。 +> 旧稿下面的核对循环把 docs 写成了 `repos/$r`，那是错的路径，已改为逐条显式写。 + 逐个确认三个仓库都没有未推送的提交（`ring-health-api` 在 Task 13 已推过，这里只做核对）： ```bash -for r in ring-health-app ring-health-api docs; do +for r in /d/cherry/repos/ring-health-app /d/cherry/repos/ring-health-api /d/cherry/docs; do echo "--- $r" - git -C /d/cherry/repos/$r status -sb | head -1 - git -C /d/cherry/repos/$r log --oneline origin/main..HEAD | sed 's/^/ 未推送: /' + git -C "$r" status -sb | head -1 + git -C "$r" log --oneline origin/main..HEAD | sed 's/^/ 未推送: /' done ``` Expected: 三行都是 `## main...origin/main`（不带 `[ahead N]`），且每条「未推送」下都没有输出。 若 app 或 docs 显示 `[ahead N]`，说明 push 没成功 —— 先查 credentials / 网络，**不要 `--force`**。 - -> `repos/docs` 不对 —— docs 仓库在 `/d/cherry/docs`（独立仓库 `ring-health-docs`）， -> 上面循环里的 `docs` 路径要写成 `/d/cherry/docs`。三个仓库分别是： -> `/d/cherry/repos/ring-health-app`、`/d/cherry/repos/ring-health-api`、`/d/cherry/docs`。 +（`ring-health-api` 若报 `fatal: unknown revision origin/main`，说明 Task 13 的 `-u` 没推上去， +回 Task 13 处理，不要在核对待办里改这个仓库。） ---