Menu
把自然语言 App 需求、模块说明和参考截图一路推进到经验证的代码与当次授权交付；用于需要长时间自主开发、持续排障和跨上下文恢复的移动端或跨端 App 任务。它不固定技术栈、阶段或交付形式，也不会把无人值守理解为远端发布授权。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
在需要打包、签名、OTA、APK/IPA、GitHub Release、商店提交、部署、回滚或验活时使用；支持独立窄任务，也支持作为 app-flow 的当前行动。它核对具体渠道授权，可复用用户明确记录的项目级 preview OTA 持续授权并在验证通过后自动发布；未获授权只做预检。
在需要与生产者分离的独立评审、复核、验收，或对 App 方案、UI、代码、体验或交付准备度做质量判断时使用；支持独立窄任务，也支持作为 app-flow 的当前行动。它只做只读评判并绑定真实证据，不创建或修改产物，也不做第一方定位根因或直接改代码。
在设计、开发或交付 App 时按需参考 Happy/Paws 经验，包括移动端架构、React Native/Expo 取舍、验证、OTA、安装包与 Release 边界。用于用户明确要求参考 Happy/Paws，或当前问题与这些真实工程经验高度匹配时；它只提供上下文，不是 App Workflow，也不强制复制 Happy 的技术栈。
在需要创建、修改、重构、修复 App 代码，或只读诊断崩溃、定位根因、给出候选补丁时使用；支持独立窄任务，也支持作为 app-flow 的当前行动。它不做产品调研、原型/设计、独立评审或打包发布，除非当前行动本身就是改代码。
作为 self-learning 的 HyperFrames 产出能力，自主学习本地教学音视频或公开视频链接，把教程讲授的方法、可观察动效和屏幕代码转成有证据、可恢复、可渲染的 HyperFrames Demo，并记录实际使用的内容、Skills、工具与可复用经验。仅在 self-learning 调用，或用户明确要求从教学素材制作 HyperFrames Demo 时使用；普通学习任务不要单独触发。
从本地音视频、YouTube、B 站、抖音、网页、文章或文案中自主学习技术知识与方法，或围绕用户主题寻找素材并继续调研，再按需生成 Demo、教程、笔记、代码等可运行、可复核产物。用于素材理解、技术复现、跨来源研究和学习成果创作；不用于模型训练、微调或自动创建 Agent Skill。
Based on SOC occupation classification
| name | app-flow |
| description | 把自然语言 App 需求、模块说明和参考截图一路推进到经验证的代码与当次授权交付；用于需要长时间自主开发、持续排障和跨上下文恢复的移动端或跨端 App 任务。它不固定技术栈、阶段或交付形式，也不会把无人值守理解为远端发布授权。 |
这是一个薄的 App 驾驭层。它只守住目标、授权、能力发现、验证、恢复和停止；具体行动由当前需求、代码现场和可用能力决定。它自己不写代码、不做设计、不打包，而是每一步选出当前价值最高的能力去做。
外部副作用需要用户授权，但不该在链路中途逐个打断用户。启动时（或首次判明本 goal 大概率会触达外部动作时）用一次批量问清「授权信封」：
目的：让「需求 → 代码 → 打包 → 内测分发」这类链路能在一次授权后连续跑完，把确认成本集中在开头，只把真正高风险的动作留成运行时门禁。
循环不是阶段图：
读取目标、现场和证据
→ 选当前价值最高的一项行动
→ 按需发现并加载最小能力集合（核心能力地图 + 宿主 metadata）
→ 行动
→ 用事实验证是否推进 acceptance
→ 必要时更新 checkpoint 或局部 Memory
→ 完成则交付；仍有可行行动则继续；否则阻塞
实质进展至少包含一项：满足验收条件、相关检查通过、根因范围缩小、阻塞解除，或得到会改变下一步的新增证据。相同失败签名连续两次出现且没有新增证据时，不原样重试；先换假设、诊断路径或工具。
每项行动写清假设、预期证据与成本上界。缺少用户授权、关键输入或外部状态，找不到仍在 envelope 内的可行行动，或剩余资源不足以同时行动和验证时，写紧凑 checkpoint 后进入阻塞。
下面是随本套件分发的窄能力。它是候选池，不是执行顺序；每轮按当前证据重新选择，绝不预设 research → design → build → delivery 的固定链。
| 能力 | 何时用 | 何时不要用 |
|---|---|---|
app-flow-build | 需要创建、修改、重构、修复 App 代码，或只读诊断崩溃并给候选补丁 | 只需评审、打包发布或纯产品讨论时 |
app-flow-delivery | 需要打包、签名、OTA、APK/IPA、Release、商店、部署、回滚或验活 | 基础代码问题未修好、或没有拿到具体渠道授权时（此时最多做预检） |
app-flow-reviewer | 需要与生产者分离的独立评审、复核、验收或质量/准备度判断 | 需要第一方定位根因或直接改产物时 |
每个能力都可独立处理窄任务，也可被本入口按当前行动调用；边界写在各自 SKILL.md。
app-flow-reviewer 不必跟在每个琐碎能力后面，但在改变承诺的关键转换点，独立评审往往就是当前最高价值行动，应各触发一次，而不是整条链路只评一次：
每个 gate 的评审都独立于生产者、绑定真实证据。跳过某个 gate 要显式说明为什么可跳，而不是默认不评——历史教训：整程只评一次会漏掉设计/交互层的问题（假可点元素、缺输入入口）。
把 gate 绑定到「完成声明」：在向用户声称「设计已定 / 外壳完成 / 可交付 / 可发布」之前，对应的 gate（设计→rubric-design、发布前→rubric-release-preflight）必须已跑过一次或被用户显式豁免。不能先声称完成、等用户挑出问题才补评审——完成声明本身就是触发 gate 的信号。
除了上面绑定到关键转换点的 gate，还有一条对每一项工作都适用的底线循环：
做一项工作 → 至少 review 一次 → 修 → 测
review → 修 → 测 跑一轮即可，不必反复 loop 到收敛（除非用户另有要求，或发现阻断性问题）。底线是"评过一次并据此修过"，而不是"零 review 直接交付"。review → 修 → 测。核心是"每做一项就评一次"，别攒到最后一次性交付才发现问题。核心地图之外，围绕“下一项行动”查询宿主的 Skill metadata，不维护固定 Skill 名单：
本 Skill 只拥有自己的 local/。首次需要读取或写入时，从当前 Skill 目录按需加载 ../../../docs/philosophy/references/local-memory.md 的通用协议；不要在普通行动中提前展开低频细节。独立分发导致引用不可读时，以本节摘要继续并保留诊断，不因此阻塞当前任务。
读取顺序：
local/INDEX.md（不存在就直接继续）；首次决策最多读取 1 个根入口、1 个作用域 map、3 条正文，正文合计不超过 32 KiB。定位优先级是：显式 Feature/Task/Goal ID → WorkTree → 分支 → Repo → 主题。Feature 路径必须带 repo-key，避免不同仓库的同名冲突。
Memory 是不可变记录；修正通过新记录的 supersedes 指向旧 ID。Token、密码、私钥、完整环境变量和未经授权的私密内容等敏感信息不得进入 local/。遇到索引断链、缺字段或损坏条目时跳过它，以当前证据继续并把 map 标为待修复，禁止递归扫描全部目录。
跨上下文恢复也走同一层：checkpoint 只保存目标摘要、已验证事实、当前输出指针、阻塞和下一步。指针或证据损坏时从当前现场重建，不猜测旧状态。
checkpoint 不只在阻塞时写。 长任务 / 多阶段 Flow 在每个大阶段完成后就更新一次 maps/resume 的短指针（覆盖式，几行即可），而不是只在阻塞或收尾才写——这样任意一次压缩或中断都能续接。写 resume 指针成本极低，别攒到最后一次性补。
只有 acceptance 有新鲜证据时才声称完成。交付实际产物、验证结果、残余风险与未执行的外部动作。
每次使用结束都判断是否值得保存 Run、更新 Feature map、生成原子 Memory 或把反复验证且已脱敏的经验晋升到稳定 reference；“每次判断”不等于“每次写文件”，保存也不等于可信。
但「判断」不等于「默认不写」——满足下列任一的 Flow，收尾时至少要写/更新 maps/resume/<repo-key>/<task-key>.md + 对应 Feature map（懒创建 local/），不能整场零落盘：
resume 指针只需短短几行（目标摘要 / 已验证事实 / 当前产物指针 / 下一步）；原子 Memory 仍按未来价值判断，不强求。只有真正一次性的琐碎任务才可整场不落盘。历史教训：一次跨十几阶段、带 push/Release 的 Flow 因为“判断了可以不写”而 local 全空，任何中断都只能从零重建。