# Isolated App Cloud QA

> 按改动范围执行 BeeCount 隔离验收：纯 App 改动使用独立设备与本地合成数据，需要 Cloud 联调时增加新数据库和真实双向同步；交付独立报告并清理本轮资源。不用于其他项目或发版。

- Skill: `tnt-likely/isolated-app-cloud-qa` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx get-skill add tnt-likely/isolated-app-cloud-qa`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tnt-likely/isolated-app-cloud-qa/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: TNT-Likely (https://skillmd.com/u/tnt-likely)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/tnt-likely/isolated-app-cloud-qa

---


# BeeCount App 与 Cloud 隔离验收

保护现用设备与 Cloud 数据，用真实应用流程证明功能和同步结果。先确定项目的隔离入口，再执行；不能把 fake provider、HTTP 200 或预期结果写成实服验收通过。

## 先选择验收范围

- **仅 App**：纯 App 改动默认只做独立设备、本地合成数据和相关真实 UI 验收，例如通知角标、页面交互、本地计算及展示。无需启动 Cloud 测试环境，不准备 Cloud 数据库、账号、鉴权或网页，也不因使用本技能而附带执行双向同步。
- **App 与 Cloud 联调**：修改 Cloud，或验收目标明确需要证明真实接口、同步链路、跨端数据往返时，才建立隔离 Cloud 并执行对应联调。记录需要 Cloud 的具体原因；不能仅因 App 本身支持云同步就扩大验收范围。
- 身份保护、正常入口重启、独立报告及清理规则适用于两种范围。Cloud 身份、数据对照和服务恢复等要求仅适用于联调；仅 App 报告标记为“不适用（仅 App）”。

## 项目入口

- 读取 [references/beecount.md](references/beecount.md)，先按验收范围选择 App 独立入口或同仓联调 runner。skill 源码位于 `.agents/skills/isolated-app-cloud-qa`，Codex 与 Claude Code 项目入口读取同一目录。
- Flutter iOS 与 Python/FastAPI：需要创建或排查适配时读取 [references/flutter-ios-fastapi.md](references/flutter-ios-fastapi.md)。
- 验收结束或关联 PR 全部合并后，读取 [references/cleanup.md](references/cleanup.md)，完整删除本轮临时环境，包括失败、重试和已被替代的 run。
- 相关 checkout 按本次实际路径定位并核对 remote；不假定用户主目录。项目级安装见 [安装说明](../../../docs/contributing/PROJECT_SKILLS_ZH.md)。不要将本项目 skill 安装到用户全局，也不在本次迁移中扩展其他项目适配。

## 运行前必须确定的身份

| 对象 | 必须记录与核对 |
|---|---|
| 源码 | App 的提交 SHA、内容 hash 和 skill 版本；联调时另记录 Cloud SHA |
| 设备 | 已有设备保护名单；本次新设备的名称、UDID/serial、runtime、run ID |
| 产物 | 构建后的主包和扩展实际 ID、签名权限、共享容器、二进制 hash |
| Cloud（仅联调） | 独立 cwd、配置来源、实际数据库与全部写入路径、新凭证、服务 origin、PID 与启动时间 |

使用仅本次 run 拥有的资源。创建标记、manifest 与私有目录权限；设备操作指定确切设备 ID。应用包、扩展和 App Group 必须独立，不能保留正式 iCloud/共享容器权限。安装前从产物验证，不能只检查工程配置。

仅 App 使用新的本地数据库、偏好与合成 fixture，不导入现用 Cloud 配置。联调时 Cloud 使用新数据库和新存储目录；排除现用 `.env`、compose volume、默认备份/restore/RAG/rclone 路径与外部服务密钥。读取实际生效配置，在服务 import/初始化写入前拒绝越界路径。使用 loopback 或明确隔离的测试网络。

任何可能重装、替换、清空 App 的操作前，私密备份已存在的数据库、偏好、附件及共享容器。首次安装无数据时也要明确确认应用不存在。Flutter 集成测试可能卸载 App，不得对用户安装的正式包执行。

## 执行闭环

1. 将需求转换成可断言的结果：新增/修改对象的身份、笔数、字段、原数据是否改变；明确未覆盖的平台和场景。
2. 执行与改动相关的单元/widget 测试，并验证所用隔离脚本的拒绝路径；涉及同步时补充同步快速回归。快速回归与真实设备、实服结果分别报告。
3. 新建环境，核对运行时身份；源码有变化时重新生成源码副本和产物，不能沿用旧成功报告。
4. 通过生产 UI 操作被测功能。合成数据可经 fixture 准备；不可直接调用 UI 回调或 Repository 写入来替代被测用户动作。
5. 仅 App 核对本地对象、字段、笔数及原数据是否改变。联调时用实际鉴权、生产同步引擎上传，核对 Cloud snapshot 和实际数据库中的身份、业务字段、关系、标记、币种及笔数。
6. 仅联调：经真实 Cloud 写接口或实际 web UI 修改，再从 App 拉回并核对。区分“web 写 API 已测”与“web 前端已测”。
7. 按功能风险选择取消、重复操作、权限、附件等场景，不附带无关的同步或共享角色验收。联调涉及故障恢复时仅影响 QA 服务，明确是服务 503 模拟还是实际设备断网。
8. 切回正常应用入口并重启，确认仍在运行、页面可见、数据持久化。集成入口通过不能替代正常入口验证。
9. 整理脱敏证据，切回正常 App，保持本次隔离设备运行，记录运行身份与版本并交给用户人工验收；联调时同时保留实际使用的隔离服务。再次打开时复用同一环境和数据，不重装或重新准备 fixture。
   仅联调且 Cloud 有 web 前端时，交接同一源码版本的网页与实际 QA API；打开浏览器，用本次私有账号登录，选中与 App 一致的账本并展示被测对象。登录凭证不打印或进入公开包，保留页面供用户继续操作。
10. 关联 PR 全部确认已合并后，默认视为本轮验收结束，立即停止并删除本轮拥有的测试环境，无需再等待用户确认关闭。用户提前确认验收结束或要求完整清理时也执行；用户明确要求继续保留环境时遵从该要求。仅创建 PR、输出报告或结束聊天仍需保留人工验收环境。按清理参考核对身份，删除临时数据库、附件、备份、源码副本、构建产物、专用浏览器 profile 和模拟器本身，只保留 run 外的独立报告、ZIP 与最小清理回执；不能只执行保留数据的 `stop`。

## 失败与报告

隔离身份不匹配、无法备份或路径指向现用资源时，停止该操作并报告具体阻碍。业务断言失败时，在验收结束前保留失败截图和私有日志，修正后用新源码/环境重跑；不绕过断言，也不将失败标成未执行。结束时将必要的脱敏失败证据纳入独立报告，再随其他 run 一并删除临时原始数据。

逐项记录 `PASS / FAIL / 未执行 / 不适用`、实际命令与退出码、版本和产物身份、本地结果、正常入口结果及已知限制；联调另附 App→Cloud→App 对照。仅 App 无需 Cloud 对照，不能将范围外联调记为通过或失败。报告只包含合成数据和可公开证据，不提交原始日志、凭证、token、数据库、备份或 App 二进制。

执行报告、截图和 JSON 留在忽略目录或仓库外，不提交到功能分支。制作离线 HTML 与独立 ZIP：优先展示界面、操作闭环、实际适用的数据对照、按场景分组的结果及范围限制；技术身份、命令和完整证据放在折叠附录。加入打开说明、文件 manifest 与 SHA256 校验表，打包前脱敏，解压核验并检查桌面和手机宽度的可读性。

报告记录自动验收时的证据快照，另外注明当前人工验收环境是否运行。生成报告或 ZIP 不要求停止环境；人工验收产生的新数据不能被复跑 fixture 或旧报告覆盖。

清理前确认独立报告和 ZIP 已保存在 run 外并通过校验。已发布的包保持原内容与 SHA256；清理状态另写最小回执，记录关联 PR 合并状态、已删除资源与结果。交付时明确环境已删除，不能继续将旧地址作为可用验收入口。

用户授权开 PR 时，PR 保留简短验收摘要、限制、关联仓依赖和独立报告链接。已获授权上传验收包时，优先通过网页文件选择器上传独立 ZIP，将下载链接放进 PR 描述并回下载核对 SHA256；读取 [GitHub PR 附件交付](references/github-pr-attachments.md)。已有授权覆盖本次包与目标 PR 时沿用该授权。附件失败时交付本地完整包并说明限制。

此 skill 不扩展合并、发版、部署或回复他人的权限；不为报告创建应用发版，按当前用户指令结束工作。

