메뉴
把自然语言 App 需求、模块说明和参考截图一路推进到经验证的代码与当次授权交付；用于需要长时间自主开发、持续排障和跨上下文恢复的移动端或跨端 App 任务。它不固定技术栈、阶段或交付形式，也不会把无人值守理解为远端发布授权。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
在需要打包、签名、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。
| 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 全空，任何中断都只能从零重建。