[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75ZGGYV8W1YM8ZF4WWXSPSC":3,"skill-same:01M75ZGGYV8W1YM8ZF4WWXSPSC":132},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":6,"ownerHtmlUrl":55,"ownerBlogUrl":6,"ownerDescription":56,"updatedAt":57,"install":58,"resources":71},"01M75ZGGYV8W1YM8ZF4WWXSPSC","hmos-multidevice-avoid-areas",null,"Handle HarmonyOS avoid-area adaptation through a declarative scene and resource index. Use when the task involves safe area expansion, status bar or navigation bar avoidance, notch or cutout handling, immersive full-screen layouts, or soft keyboard overlap handling.","IsKenKenYa\u002Fskills","IsKenKenYa","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F92219680?v=4","01M75Z8AFJBVH1Y9JJWRT35P0Z","是小啃啃呀","01M75Z8AG6RVC5RF6KTJQ7PQKQ",3,"GPL-3.0","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: hmos-multidevice-avoid-areas\ndescription: Handle HarmonyOS avoid-area adaptation through a declarative scene and resource index. Use when the task involves safe area expansion, status bar or navigation bar avoidance, notch or cutout handling, immersive full-screen layouts, or soft keyboard overlap handling.\nmetadata:\n  version: 1.0.2\n  keywords:\n    - 避让区\n    - 安全区\n    - safe area\n    - avoid area\n    - 状态栏避让\n    - 导航栏避让\n    - 挖孔屏\n    - 刘海屏\n    - cutout\n    - 沉浸式布局\n    - 全屏适配\n    - 软键盘遮挡\n    - 键盘顶起\n    - keyboard overlap\n    - HDS\n    - HDS沉浸式\n    - 高级组件\n    - HdsNavigation\n    - dynamicHideTitleBar\n    - hdsMaterial\n    - 沉浸光感\n    - systemMaterialEffect\n    - 滚动模糊\n---\n\n# 设备避让区适配\n\n## 技能定义\n\n| 字段 | 内容 |\n| --- | --- |\n| `skill_id` | `device-avoid-areas` |\n| `skill_name` | `设备避让区适配` |\n| `one_line_purpose` | 为系统栏、挖孔区、软键盘和沉浸式布局提供统一避让策略。 |\n| `device_scope` | `phone \u002F tablet \u002F 2in1 \u002F tv \u002F wearable` |\n| `problem_scope` | `safe area、状态栏和导航栏避让、挖孔区、软键盘、沉浸式布局` |\n| `not_in_scope` | `与系统区域无关的普通间距调整、纯业务交互逻辑` |\n| `primary_outputs` | `primary_scene`、`device_constraints`、`implementation_notes`、`fix_plan`、`verification_matrix` |\n\n## 核心约束\n\n- 先明确要处理的是哪类避让区域，再决定使用动态检测、安全区扩展还是沉浸式方案。\n- 不要硬编码系统栏、挖孔区或键盘尺寸，应优先使用 API 动态获取。\n- 涉及沉浸式布局时，必须同时说明背景延伸策略和内容避让策略。\n- 涉及软键盘时，必须说明弹出、收起和焦点变化三类时机的布局更新逻辑。\n- 关键内容和核心点击区域不得放在挖孔区或不可交互区域。\n- 未说明异常场景下的回退策略前，不得宣称避让方案完整。\n- **VAL 阶段路由强制要求**：当验证涉及折叠设备多形态验证、hidumper 模拟、分辨率阶梯验证时，**不得在本 SKILL 内自行执行验证操作**（如直接调用 hdc 截屏、尝试悬浮窗等），必须按以下步骤路由：\t \n  1. 读取 `..\u002Fhmos-multidevice-scenario-entry\u002Freferences\u002Fmulti-device-verification.md`\t \n  2. 按文档中的标准流程执行验证\n\n- **HDS 高级组件推荐提示**：HDS（UI Design Kit）高级组件内置安全区处理、沉浸光感和滚动模糊等避让能力，可大幅减少手动避让代码。当 DEV 阶段命中以下避让场景时，**应主动向用户推荐 HDS 组件方案**，但**不自动替换用户已有的组件**，由用户决定是否采用：\n  - **AVOID-02 安全区扩展**：手动 `expandSafeArea` + padding 避让 → `HdsNavigation` 的 `enableComponentSafeArea: true` 自动处理标题栏安全区，无需手动计算状态栏高度\n  - **AVOID-03 沉浸式全屏**：\n    - 手动 `setWindowLayoutFullScreen` + `setWindowSystemBarProperties` + `expandSafeArea` 沉浸式方案 → `HdsNavigation` 配合 `systemMaterialEffect`（`hdsMaterial.MaterialType.ADAPTIVE`）实现自适应沉浸光感效果\n    - 手动滚动监听隐藏标题栏 → `HdsNavigation` 的 `dynamicHideTitleBar`（`HideMode.SCROLL_UP_TO`）一行配置替代\n    - 手动列表沉浸模糊 → `HdsNavigation` 的 `scrollEffectOpts`（`ScrollEffectType.COMMON_BLUR` \u002F `TRANSITION_BLUR` \u002F `GRADIENT_BLUR`）替代手动滚动偏移计算\n    - 手动浮层 TabBar → `HdsTabs` 的 `barFloatingStyle`（悬浮样式 + `systemMaterialEffect` 沉浸光感）替代手动 offset 跟随\n  - **HDS 组件详细 API 和示例参见 `.\u002Freferences\u002Fhds-ui-design-kit.md`。**\n  - **设备约束**：`hdsMaterial`（沉浸光感）仅支持手机和平板，其他设备需回退到手动方案；`HdsNavigation` 最低版本 5.1.0(18)，`hdsMaterial` 最低版本 6.1.0(23)。\n  - 用户未选择 HDS 或设备不支持时，使用本技能 AVOID 场景的手动避让方案。\n\n### 资源采纳优先级\n\n当用户问题描述与避让场景高度匹配时，按以下优先级采纳：\n\n1. **场景方案（RSC_AVOID_06）为首要实现依据** — 其中的 API 调用、算法逻辑、组件结构、回调处理等细节不得省略或简化。如果场景方案提供了完整代码，必须完整采纳，不得选择性丢弃。\n2. **HDS 高级组件为推荐替代方案** — 当避让场景可通过 HDS 组件内置能力解决时（见\"HDS 高级组件推荐提示\"），主动向用户推荐 HDS 组件方案，但不自动替换。HDS 组件详细 API 参见 `.\u002Freferences\u002Fhds-ui-design-kit.md`。\n3. **指南文档（RSC_AVOID_01\u002F02\u002F03\u002F04）为补充参考** — 仅在场景方案未覆盖的边界情况或需要额外解释时查阅，不得用指南文档中的通用描述替代场景方案中的具体实现。\n4. **修复案例（RSC_AVOID_05）用于 FIX 阶段** — 仅在排查已有问题时参考，不用于新功能开发。\n\n判断\"高度匹配\"的标准：用户描述的 UI 结构、交互行为、避让目标与场景方案的标题或描述基本一致（如\"列表滚动隐藏标题栏\"匹配场景1，\"底部导航栏避让\"匹配场景2）。\n\n## 阶段标签\n\n| 标签 | 阶段 | 当前模块关注点 |\n| --- | --- | --- |\n| `REQ` | 需求分析设计 | 避让区域类型、背景与内容边界、沉浸式适配、安全区扩展 |\n| `DEV` | 开发 | 动态获取避让区域API、padding设置、窗口设置、expandSafeArea安全区域设置 |\n| `FIX` | 问题修复 | 内容被系统栏区域遮挡、软键盘拉起遮挡内容、沉浸式错位、刘海区\u002F挖孔区内容遮挡或交互失效 |\n| `VAL` | 功能验证 | 截图证据、系统区域变化证据、键盘开闭证据 |\n\n## 统一输出字段\n\n- 路由字段：`active_phases`、`primary_phase`、`primary_scene`、`secondary_scenes`、`resources_used`\n- `REQ`：`device_constraints`、`capability_boundary`、`acceptance_focus`\n- `DEV`：`code_touchpoints`、`reuse_resources`、`implementation_notes`、`integration_risks`\n- `FIX`：`problem_profile`、`root_cause_hypothesis`、`fix_plan`、`regression_watchlist`\n- `VAL`：`verification_matrix`、`evidence_requirements`、`pass_criteria`、`residual_risks`\n\n## 字段释义\n\n- `device_constraints`：指由状态栏、导航栏、挖孔区、软键盘和沉浸式窗口带来的适配硬约束。在 `device-avoid-areas` 中，通常是哪些系统区域会遮挡内容、背景是否允许延伸、哪些交互区绝不能落入不可点击区域。\n- `capability_boundary`：指当前避让方案在哪些窗口模式、系统 UI 状态或设备类型下有效，哪些场景需要回退或额外处理。\n- `acceptance_focus`：指需求阶段验收时必须重点确认的遮挡现象、键盘开闭行为和系统区域变化表现。\n- 统一输出字段中每个阶段列出的字段表示“命中避让场景后，该阶段必须输出这些字段”，由阶段决定输出内容，不再由场景单独定义。\n\n## 场景决策树\n\n```\n用户提出避让区相关问题\n│\n├── Step 1: 阶段判断（primary_phase）\n│   │\n│   │  判断原则: 用户是否在描述已有代码\u002F页面上出现的不正确结果\n│   │\n│   ├── FIX: 满足以下任一条件\n│   │   ├── 用户描述了已有实现运行后的异常结果\n│   │   │   强信号: \"不生效\"、\"仍然是\"、\"错乱\"、\"跳变\"、\"返回值为0\"、\"被压缩\"\n│   │   │   中信号: \"被遮挡\"、\"没有延伸\"、\"没有更新\"、\"重叠\"、\"上推\"、\"截断\"\n│   │   ├── 用户明确要求排查\u002F修复已有问题\n│   │   │   关键词: \"排查原因\"、\"修复\"、\"为什么不生效\"、\"请排查\"\n│   │   └── prompt 同时包含 API\u002F代码片段 + 异常结果（双重确认）\n│   │\n│   ├── DEV: 描述全新功能需求，无已有异常\n│   │   关键词: \"需要实现\"、\"请给出开发方案\"、\"请给出完整方案\"\n│   │   注意: \"不能被遮挡\"（设计约束）≠ \"被遮挡\"（已有问题）\n│   │\n│   └── REQ: 描述需求并要求分析\u002F评估\n│   │   关键词: \"请给出需求分析\"、\"请分析\"、\"评估\"\n│\n├── Step 2: 主场景路由（primary_scene）\n│   │\n│   ├── Q1: 是否涉及键盘弹出\u002F遮挡输入框？\n│   │   └── 是 → AVOID-04 软键盘避让与输入区稳定性\n│   │       └── 结束路由\n│   │\n│   ├── Q2: 是否调用了 setWindowLayoutFullScreen 或 setWindowSystemBarProperties？\n│   │   ├── 是 → AVOID-03 沉浸式全屏布局\n│   │   │   └── 例外：如果核心是挖孔\u002FCutout遮挡UI元素 → AVOID-01（挖孔优先于全屏）\n│   │   └── 否 → 继续 Q3\n│   │\n│   ├── Q3: 核心问题是\"背景延伸但内容不延伸\"？\n│   │   │   特征关键词: expandSafeArea、背景铺满、内容保持安全区\n│   │   ├── 是 → AVOID-02 安全区扩展与背景延伸\n│   │   │   └── 例外：如果同时调用了全屏API → AVOID-03\n│   │   └── 否 → 继续 Q4\n│   │\n│   └── Q4: 是否涉及避让区域信息的获取\u002F监听？\n│       │   特征关键词: getWindowAvoidArea、avoidAreaChange、\n│       │             TYPE_CUTOUT、避让失效、返回异常值\n│       ├── 是 → AVOID-01 避让区域识别与动态获取\n│       └── 否 → 不命中避让区技能（not_in_scope）\n│\n└── Step 3: 关联场景补充（secondary_scenes）\n    │   按用户问题中同时涉及的内容添加，无明确关联则输出 []\n    │\n    ├── AVOID-01 + AVOID-02: 同时涉及避让区域获取 + 背景延伸\u002F内容边界\n    ├── AVOID-01 + AVOID-03: 同时涉及避让区域获取 + 全屏模式\n    ├── AVOID-03 + AVOID-02: 同时涉及全屏模式 + expandSafeArea\n    ├── AVOID-04 + AVOID-01: 同时涉及键盘 + 多种避让区域监听\n    └── []: 无明确关联\n```\n\n## 场景索引\n\n#### `AVOID-01` 避让区域识别与动态获取\n\n```yaml\nscene_id: AVOID-01\nscene_name: 避让区域识别与动态获取\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - AvoidAreaType\n  - TYPE_SYSTEM\n  - TYPE_NAVIGATION_INDICATOR\n  - TYPE_CUTOUT\n  - TYPE_KEYBOARD\napplies_when:\n  - 需要动态获取系统栏、挖孔区或键盘区域\n  - 当前问题表现为内容被系统区域遮挡\n  - 涉及挖孔\u002FCutout\u002FTYPE_CUTOUT 遮挡 UI 元素（最高优先级，即使同时使用全屏 API）\n  - 折叠屏展开\u002F折叠或横竖屏切换后，避让区域高度变化导致布局不更新\n  - avoidAreaChange 监听未注册或 getWindowAvoidArea 时序问题导致获取旧值\n  - getWindowAvoidArea 返回值异常（为 0 或不正确），且未使用全屏 API\nnot_applies_when:\n  - 只是背景延伸且不涉及动态获取避让区域（属于 AVOID-02）\n  - 已使用 setWindowLayoutFullScreen 或 setWindowSystemBarProperties 开启全屏，getWindowAvoidArea 只是为全屏布局提供避让参数（属于 AVOID-03）\n  - 使用 setWindowLayoutFullScreen 后 getWindowAvoidArea 返回 0，属于全屏配置问题（属于 AVOID-03）\n  - 仅涉及键盘弹出遮挡输入框（属于 AVOID-04）\n  - 用户使用了 expandSafeArea 且问题出在内容层未加 padding 避让（属于 AVOID-02）\n  - 用户问题主要涉及软键盘弹出遮挡，getWindowAvoidArea 只是辅助监听（属于 AVOID-04）\n  - 问题核心是 padding 加在错误位置，而非避让区域获取（属于 AVOID-02）\ndecisions:\n  REQ:\n    - 确定目标避让区域类型：无输入框跳过 TYPE_KEYBOARD；内容不靠近边缘可降低优先级（参考 RSC_AVOID_06 场景5 状态栏适配中避让区域类型的选择）\n    - 确定覆盖设备形态：折叠屏必须考虑展开\u002F折叠后高度变化；平板注意导航条可能不存在\n    - 确定是否需要持续监听：静态布局可一次性获取；支持旋转\u002F折叠必须 avoidAreaChange\n  DEV:\n    - 选择获取方式：一次性用 getWindowAvoidArea，响应变化用 avoidAreaChange，通常两者配合（参考 RSC_AVOID_06 场景4 挖孔区四方向检测的实现）\n    - 选择注册时机：全局复用在 onWindowStageCreate，单页面用在 aboutToAppear（注意窗口就绪时序）\n    - 选择消费策略：padding（最常用）\u002F margin \u002F 组件级 offset \u002F 结构切换（横竖屏两套布局）\n    - 处理时序兜底：avoidAreaChange 回调触发前用缓存值，getWindowAvoidArea 返回 0 时延迟重试\n  FIX:\n    - 定位问题环节：始终遮挡→获取环节；变化后遮挡→监听环节（参考 RSC_AVOID_05 场景11）；首次加载遮挡→时序环节（参考 RSC_AVOID_05 场景10）\n    - 检查避让类型完整性：是否遗漏 TYPE_CUTOUT 或 TYPE_NAVIGATION_INDICATOR（参考 RSC_AVOID_05 场景2 挖孔区未检测 TYPE_CUTOUT）\n    - 检查回调链路：是否注册 → 注册时机是否正确 → 回调是否触发 → UI 状态是否绑定\n    - 检查设备形态切换：折叠屏展开\u002F横竖屏旋转后回调是否重新触发、值是否正确更新（参考 RSC_AVOID_05 场景10 windowSizeChange 时序问题、场景12 display.on 时序跳变）\n  VAL:\n    - 截图验证：直板竖屏\u002F横屏、折叠屏折叠态\u002F展开态、平板默认态\n    - 动态变化证据：旋转前后、折叠\u002F展开前后的截图对比\n    - 数值验证：getWindowAvoidArea 返回值不为 0，avoidAreaChange 回调值在变化前后不同\nresource_refs:\n  - RSC_AVOID_01\n  - RSC_AVOID_05\n  - RSC_AVOID_06\n```\n\n#### `AVOID-02` 安全区扩展与背景延伸\n\n```yaml\nscene_id: AVOID-02\nscene_name: 安全区扩展与背景延伸\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - expandSafeArea\n  - SafeAreaType\n  - SafeAreaEdge\n  - 背景延伸\n  - 背景色铺满状态栏\n  - 图片延伸到系统栏\n  - 内容保持在安全区\n  - enableComponentSafeArea\n  - HdsNavigation安全区\napplies_when:\n  - 背景需要铺满系统区域，但内容仍需保持在安全区内\n  - 需要明确顶部和底部内容边界\n  - 未调用 setWindowLayoutFullScreen，仅用 expandSafeArea 延伸背景\n  - 核心特征是\"背景延伸、内容不延伸\"\n  - expandSafeArea 已设置但背景未延伸或内容层未留 padding\n  - padding 加在了外层容器而非子组件上，导致背景色出现间隙（属于分层问题，不是全屏设置问题）\nnot_applies_when:\n  - 页面使用了 setWindowLayoutFullScreen 开启全屏（属于 AVOID-03）\n  - 使用了 setWindowSystemBarProperties 设置状态栏透明（属于 AVOID-03）\n  - 涉及避让系统导航条 + 沉浸效果且使用 AvoidAreaManager 管理器（属于 AVOID-03）\n  - 涉及键盘弹出遮挡输入框（属于 AVOID-04）\n  - 需要动态获取避让区域类型（属于 AVOID-01）\ndecisions:\n  REQ:\n    - 确定需要延伸的层：背景层（颜色\u002F图片）必须铺满系统栏区域，内容层（文字\u002F按钮）必须保持在安全区内\n    - 确定延伸方向：通常顶部（状态栏）和底部（导航条），左右视设计稿决定\n    - 确定内容安全间距：内容距离安全区边缘的最小距离，是否需要额外留白\n  DEV:\n    - 选择 expandSafeArea 参数：SafeAreaType 指定 SYSTEM\u002FCUTOUT\u002FKEYBOARD，SafeAreaEdge 指定 TOP\u002FBOTTOM\u002FSTART\u002FEND\n    - 决定设置层级：expandSafeArea 加在背景容器上，而非内容组件上\n    - 决定内容层 padding 补偿：背景延伸后内容层需手动加 padding 保持安全区，padding 必须加在子组件上（加在外层容器会导致背景色间隙）\n    - 处理 SafeAreaEdge 遗漏：只设 TOP 不设 BOTTOM → 底部出现间隙；需按设计稿逐方向确认\n  FIX:\n    - 定位间隙来源：背景色在系统栏区域出现间隙 → padding 加在了外层容器而非子组件，分层策略有误（参考 RSC_AVOID_05 场景4 顶部 padding 位置错误导致背景色间隙）\n    - 定位内容溢出：内容跑到状态栏区域 → expandSafeArea 错误地加在了内容层而非背景层\n    - 排查全屏 API 干扰：如果同时调了 setWindowLayoutFullScreen，问题可能属于 AVOID-03 而非本场景\n  VAL:\n    - 截图验证：安全区边界处背景是否铺满、内容是否保持安全距离\n    - 多设备验证：不同状态栏高度、有无导航条的设备上表现是否一致\n    - 旋转验证：横竖屏切换后背景是否仍然延伸、内容是否仍然安全\nresource_refs:\n  - RSC_AVOID_02\n  - RSC_AVOID_05\n```\n\n#### `AVOID-03` 沉浸式全屏布局\n\n```yaml\nscene_id: AVOID-03\nscene_name: 沉浸式全屏布局\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - setWindowLayoutFullScreen\n  - 全屏\n  - 沉浸式\n  - 状态栏透明\n  - 列表沉浸\n  - 滚动隐藏标题栏\n  - 浮层 TabBar\n  - 阅读器全屏\n  - 视频播放全屏\n  - hdsMaterial\n  - 沉浸光感\n  - dynamicHideTitleBar\n  - scrollEffectOpts\n  - 滚动模糊\n  - systemMaterialEffect\n  - barFloatingStyle\napplies_when:\n  - 页面需要背景或媒体内容铺满边缘\n  - 当前问题表现为全屏后内容与系统栏重叠\n  - 列表\u002F信息流场景需要上滑隐藏标题栏和导航栏\n  - 核心特征是\"调用了 setWindowLayoutFullScreen 或状态栏透明设置\"\n  - 涉及浮层 TabBar、自定义导航栏等全屏场景组件\nnot_applies_when:\n  - 仅使用 expandSafeArea 背景延伸，未开启全屏（属于 AVOID-02）\n  - 问题核心是 padding 加在了错误位置（如外层容器而非子组件），而非全屏设置问题（属于 AVOID-02）\n  - 问题核心是 avoidAreaChange 监听未注册或 getWindowAvoidArea 时序问题导致折叠屏变化后不更新（属于 AVOID-01）\n  - 涉及键盘弹出导致布局问题（属于 AVOID-04）\n  - 仅需要获取避让区域高度，不涉及全屏（属于 AVOID-01）\n  - 涉及挖孔遮挡 UI 元素（属于 AVOID-01，挖孔优先于全屏）\ndecisions:\n  REQ:\n    - 确定沉浸式类型：完全沉浸（视频\u002F阅读器全屏）、半沉浸（列表上滑隐藏标题栏）（参考 RSC_AVOID_06 场景1 列表滚动沉浸）、持续沉浸（自定义导航栏+透明状态栏）\n    - 确定系统栏可见性：完全隐藏 vs 透明显示 vs 半透明叠加\n    - 确定退出机制：返回键退出、手势退出、超时自动退出\n  DEV:\n    - 选择窗口级 API：setWindowLayoutFullScreen 开启全屏 + setWindowSystemBarProperties 设置状态栏颜色\u002F透明度\n    - 选择页面级避让策略：全屏后内容延伸到系统栏区域，需在页面内用 avoidAreaChange 获取高度手动处理 padding\n    - 处理列表沉浸：上滑隐藏标题栏 → 监听滚动偏移量动态调整；浮层 TabBar → offset 跟随滚动（参考 RSC_AVOID_06 场景1 onScrollFrameBegin 线性比例算法）\n    - 处理自定义导航栏：padding-top = 状态栏高度（从 avoidAreaChange 获取），不能硬编码\n    - 识别实践场景：命中 list immersive \u002F video immersive \u002F reading immersive 时必须逐条对照实现（参考 RSC_AVOID_06 场景1\u002F2\u002F3 的完整方案）\n  FIX:\n    - 确认全屏是否生效：setWindowLayoutFullScreen 调用后 getWindowAvoidArea 仍返回 0 → 全屏配置未生效或调用时机不对\n    - 定位内容遮挡：全屏后内容跑到状态栏下面 → 页面内未加避让 padding 或未注册 avoidAreaChange（参考 RSC_AVOID_05 场景1 阅读器顶部遮挡、场景7 底部被导航指示器遮挡）\n    - 定位系统栏显示异常：setWindowSystemBarProperties 后状态栏仍不透明 → 检查调用时机（需在窗口创建后）和参数格式\n    - 排查非全屏场景：如果未调用 setWindowLayoutFullScreen，问题属于 AVOID-01 或 AVOID-02\n  VAL:\n    - 截图验证：全屏模式下背景是否铺满、内容是否合理避让\n    - 系统栏交互验证：滑动\u002F点击时系统栏是否按预期显示\u002F隐藏\u002F恢复\n    - 多设备验证：不同状态栏高度下自定义导航栏高度是否正确\n    - 退出验证：各种退出方式是否正常恢复非沉浸状态\nresource_refs:\n  - RSC_AVOID_03\n  - RSC_AVOID_06\n  - RSC_AVOID_05\n```\n\n#### `AVOID-04` 软键盘避让与输入区稳定性\n\n```yaml\nscene_id: AVOID-04\nscene_name: 软键盘避让与输入区稳定性\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - keyboardAvoidMode\n  - avoidAreaChange\n  - 输入框被遮挡\n  - 键盘弹出\napplies_when:\n  - 输入框、按钮或底部操作栏会被软键盘遮挡\n  - 当前问题表现为键盘开闭导致内容跳动或错位\nnot_applies_when:\n  - 页面没有输入交互\n  - 不涉及软键盘，仅涉及系统栏或挖孔区（属于 AVOID-01\u002F02\u002F03）\ndecisions:\n  REQ:\n    - 确定页面输入场景：单输入框（登录页）、多输入框（表单）、底部输入框（聊天页）、固定底部栏（底部按钮+输入框）\n    - 确定避让期望：内容上推\u002F滚动到可见区域\u002F底部栏固定上移\u002F布局重排\n    - 确定焦点切换行为：多输入框间切换时是否需要平滑滚动\n    - 确定键盘收起后恢复：是否立即恢复原位、是否有动画过渡\n  DEV:\n    - 选择 keyboardAvoidMode：RESIZE（调整窗口大小，适合固定布局）PAN（平移内容，适合单输入框简单场景）OFFSET（偏移，适合有底部固定栏的场景）\n    - 处理底部固定栏：键盘弹出后底部栏需上移 → 通过 avoidAreaChange 中 TYPE_KEYBOARD 获取高度计算 offset\n    - 处理列表\u002F表单滚动：键盘弹出后自动滚动到焦点输入框 → 结合 scroller.scrollToIndex 或 scrollTo\n    - 处理键盘动画时序：键盘收起动画期间布局可能跳动 → avoidAreaChange 回调中 keyboard height 从非 0 变为 0 时延迟恢复\n  FIX:\n    - 定位问题类型：输入框被遮挡 → 避让模式或 offset 计算有误；布局跳动 → 键盘弹出\u002F收起动画冲突；底部栏异常 → 固定定位与键盘避让策略冲突\n    - 检查 keyboardAvoidMode：是否选错模式（如列表页用了 PAN 导致内容被裁切而非滚动）\n    - 检查焦点与滚动同步：点击输入框后是否自动滚动到可见位置，多输入框切换时是否跟随\n    - 检查键盘收起恢复：收起后布局是否恢复原位、是否有残留 offset、快速弹出\u002F收起时是否稳定\n    - 排查非键盘问题：如果遮挡来自系统栏或挖孔而非键盘 → 属于 AVOID-01\u002F02\u002F03\n  VAL:\n    - 截图验证：键盘弹出时输入框是否可见、底部栏是否正确上移\n    - 键盘收起验证：收起后布局是否恢复原位、无残留偏移\n    - 焦点切换验证：多输入框间切换时页面是否平滑滚动到目标输入框\n    - 多输入法验证：系统键盘 vs 第三方输入法（高度不同）表现是否一致\n    - 边界场景：快速弹出\u002F收起、横屏键盘、物理键盘连接时的稳定性\nresource_refs:\n  - RSC_AVOID_01\n  - RSC_AVOID_04\n  - RSC_AVOID_05\n  - RSC_AVOID_06\n```\n\n## 资源索引\n\n#### `RSC_AVOID_01` 避让区域类型参考\n\n```yaml\nresource_id: RSC_AVOID_01\nresource_type: reference\npath: .\u002Freferences\u002Favoid_area_types.md\nused_for:\n  - 识别系统栏、导航栏、挖孔区和键盘区域类型\n  - 设计动态获取与监听策略\nload_when:\n  - 命中 AVOID-01 或 AVOID-04\navoid_when:\n  - 当前不涉及系统区域和键盘区域\nsupports_scenes:\n  - AVOID-01\n  - AVOID-04\noutput_fields:\n  - device_constraints\n  - capability_boundary\n  - implementation_notes\n  - root_cause_hypothesis\n  - verification_matrix\n```\n\n#### `RSC_AVOID_02` 安全区扩展参考\n\n```yaml\nresource_id: RSC_AVOID_02\nresource_type: reference\npath: .\u002Freferences\u002Fsafe_area_api.md\nused_for:\n  - 定义安全区扩展和背景延伸的边界\n  - 判断内容层与背景层的职责划分\nload_when:\n  - 命中 AVOID-02\navoid_when:\n  - 页面不使用安全区扩展\nsupports_scenes:\n  - AVOID-02\noutput_fields:\n  - device_constraints\n  - capability_boundary\n  - implementation_notes\n  - fix_plan\n  - pass_criteria\n```\n\n#### `RSC_AVOID_03` 沉浸式布局参考\n\n```yaml\nresource_id: RSC_AVOID_03\nresource_type: reference\npath: .\u002Freferences\u002Fimmersive_layout.md\nused_for:\n  - 定义窗口级全屏和页面级避让的配合方式\n  - 排查沉浸式布局中的内容遮挡问题\nload_when:\n  - 命中 AVOID-03\navoid_when:\n  - 页面不需要沉浸式展示\nsupports_scenes:\n  - AVOID-03\noutput_fields:\n  - device_constraints\n  - implementation_notes\n  - root_cause_hypothesis\n  - verification_matrix\n  - residual_risks\n```\n\n#### `RSC_AVOID_04` 键盘避让参考\n\n```yaml\nresource_id: RSC_AVOID_04\nresource_type: reference\npath: .\u002Freferences\u002Fkeyboard_handling.md\nused_for:\n  - 设计键盘弹出、收起和焦点切换时的避让逻辑\n  - 排查输入区跳动、按钮被遮挡等问题\nload_when:\n  - 命中 AVOID-04\navoid_when:\n  - 页面没有输入交互\nsupports_scenes:\n  - AVOID-04\noutput_fields:\n  - acceptance_focus\n  - implementation_notes\n  - fix_plan\n  - verification_matrix\n  - evidence_requirements\n```\n\n#### `RSC_AVOID_05` 问题修复案例集\n\n```yaml\nresource_id: RSC_AVOID_05\nresource_type: reference\npath: .\u002Freferences\u002Fbug-fix-cases.md\nused_for:\n  - 排查状态栏遮挡、挖孔区遮挡、沉浸式布局错位、键盘避让异常等常见问题\n  - 排查安全区扩展与背景延伸相关的 padding 位置错误、背景色间隙等问题\nload_when:\n  - 命中 AVOID-01 或 AVOID-02 或 AVOID-03 或 AVOID-04 且处于 FIX 阶段\navoid_when:\n  - 当前不涉及问题修复\nsupports_scenes:\n  - AVOID-01\n  - AVOID-02\n  - AVOID-03\n  - AVOID-04\noutput_fields:\n  - problem_profile\n  - root_cause_hypothesis\n  - fix_plan\n  - regression_watchlist\n```\n\n#### `RSC_AVOID_06` 开发场景方案集\n\n```yaml\nresource_id: RSC_AVOID_06\nresource_type: reference\npath: .\u002Freferences\u002Fscenario-development-cases.md\nused_for:\n  - 提供沉浸式布局等场景的完整开发方案与分步实现\n  - 提供挖孔区适配、底部导航栏避让、状态栏适配、键盘易操作等场景的完整开发方案\nload_when:\n  - 命中 AVOID-01 或 AVOID-03 或 AVOID-04 且处于 REQ 或 DEV 阶段\navoid_when:\n  - 当前处于 FIX 阶段（应走 RSC_AVOID_05）\nsupports_scenes:\n  - AVOID-01\n  - AVOID-03\n  - AVOID-04\noutput_fields:\n  - acceptance_focus\n  - implementation_notes\n  - code_touchpoints\n  - verification_matrix\n```\n","# 设备避让区适配\n\n## 技能定义\n\n| 字段 | 内容 |\n| --- | --- |\n| `skill_id` | `device-avoid-areas` |\n| `skill_name` | `设备避让区适配` |\n| `one_line_purpose` | 为系统栏、挖孔区、软键盘和沉浸式布局提供统一避让策略。 |\n| `device_scope` | `phone \u002F tablet \u002F 2in1 \u002F tv \u002F wearable` |\n| `problem_scope` | `safe area、状态栏和导航栏避让、挖孔区、软键盘、沉浸式布局` |\n| `not_in_scope` | `与系统区域无关的普通间距调整、纯业务交互逻辑` |\n| `primary_outputs` | `primary_scene`、`device_constraints`、`implementation_notes`、`fix_plan`、`verification_matrix` |\n\n## 核心约束\n\n- 先明确要处理的是哪类避让区域，再决定使用动态检测、安全区扩展还是沉浸式方案。\n- 不要硬编码系统栏、挖孔区或键盘尺寸，应优先使用 API 动态获取。\n- 涉及沉浸式布局时，必须同时说明背景延伸策略和内容避让策略。\n- 涉及软键盘时，必须说明弹出、收起和焦点变化三类时机的布局更新逻辑。\n- 关键内容和核心点击区域不得放在挖孔区或不可交互区域。\n- 未说明异常场景下的回退策略前，不得宣称避让方案完整。\n- **VAL 阶段路由强制要求**：当验证涉及折叠设备多形态验证、hidumper 模拟、分辨率阶梯验证时，**不得在本 SKILL 内自行执行验证操作**（如直接调用 hdc 截屏、尝试悬浮窗等），必须按以下步骤路由：\t \n  1. 读取 `..\u002Fhmos-multidevice-scenario-entry\u002Freferences\u002Fmulti-device-verification.md`\t \n  2. 按文档中的标准流程执行验证\n\n- **HDS 高级组件推荐提示**：HDS（UI Design Kit）高级组件内置安全区处理、沉浸光感和滚动模糊等避让能力，可大幅减少手动避让代码。当 DEV 阶段命中以下避让场景时，**应主动向用户推荐 HDS 组件方案**，但**不自动替换用户已有的组件**，由用户决定是否采用：\n  - **AVOID-02 安全区扩展**：手动 `expandSafeArea` + padding 避让 → `HdsNavigation` 的 `enableComponentSafeArea: true` 自动处理标题栏安全区，无需手动计算状态栏高度\n  - **AVOID-03 沉浸式全屏**：\n    - 手动 `setWindowLayoutFullScreen` + `setWindowSystemBarProperties` + `expandSafeArea` 沉浸式方案 → `HdsNavigation` 配合 `systemMaterialEffect`（`hdsMaterial.MaterialType.ADAPTIVE`）实现自适应沉浸光感效果\n    - 手动滚动监听隐藏标题栏 → `HdsNavigation` 的 `dynamicHideTitleBar`（`HideMode.SCROLL_UP_TO`）一行配置替代\n    - 手动列表沉浸模糊 → `HdsNavigation` 的 `scrollEffectOpts`（`ScrollEffectType.COMMON_BLUR` \u002F `TRANSITION_BLUR` \u002F `GRADIENT_BLUR`）替代手动滚动偏移计算\n    - 手动浮层 TabBar → `HdsTabs` 的 `barFloatingStyle`（悬浮样式 + `systemMaterialEffect` 沉浸光感）替代手动 offset 跟随\n  - **HDS 组件详细 API 和示例参见 `.\u002Freferences\u002Fhds-ui-design-kit.md`。**\n  - **设备约束**：`hdsMaterial`（沉浸光感）仅支持手机和平板，其他设备需回退到手动方案；`HdsNavigation` 最低版本 5.1.0(18)，`hdsMaterial` 最低版本 6.1.0(23)。\n  - 用户未选择 HDS 或设备不支持时，使用本技能 AVOID 场景的手动避让方案。\n\n### 资源采纳优先级\n\n当用户问题描述与避让场景高度匹配时，按以下优先级采纳：\n\n1. **场景方案（RSC_AVOID_06）为首要实现依据** — 其中的 API 调用、算法逻辑、组件结构、回调处理等细节不得省略或简化。如果场景方案提供了完整代码，必须完整采纳，不得选择性丢弃。\n2. **HDS 高级组件为推荐替代方案** — 当避让场景可通过 HDS 组件内置能力解决时（见\"HDS 高级组件推荐提示\"），主动向用户推荐 HDS 组件方案，但不自动替换。HDS 组件详细 API 参见 `.\u002Freferences\u002Fhds-ui-design-kit.md`。\n3. **指南文档（RSC_AVOID_01\u002F02\u002F03\u002F04）为补充参考** — 仅在场景方案未覆盖的边界情况或需要额外解释时查阅，不得用指南文档中的通用描述替代场景方案中的具体实现。\n4. **修复案例（RSC_AVOID_05）用于 FIX 阶段** — 仅在排查已有问题时参考，不用于新功能开发。\n\n判断\"高度匹配\"的标准：用户描述的 UI 结构、交互行为、避让目标与场景方案的标题或描述基本一致（如\"列表滚动隐藏标题栏\"匹配场景1，\"底部导航栏避让\"匹配场景2）。\n\n## 阶段标签\n\n| 标签 | 阶段 | 当前模块关注点 |\n| --- | --- | --- |\n| `REQ` | 需求分析设计 | 避让区域类型、背景与内容边界、沉浸式适配、安全区扩展 |\n| `DEV` | 开发 | 动态获取避让区域API、padding设置、窗口设置、expandSafeArea安全区域设置 |\n| `FIX` | 问题修复 | 内容被系统栏区域遮挡、软键盘拉起遮挡内容、沉浸式错位、刘海区\u002F挖孔区内容遮挡或交互失效 |\n| `VAL` | 功能验证 | 截图证据、系统区域变化证据、键盘开闭证据 |\n\n## 统一输出字段\n\n- 路由字段：`active_phases`、`primary_phase`、`primary_scene`、`secondary_scenes`、`resources_used`\n- `REQ`：`device_constraints`、`capability_boundary`、`acceptance_focus`\n- `DEV`：`code_touchpoints`、`reuse_resources`、`implementation_notes`、`integration_risks`\n- `FIX`：`problem_profile`、`root_cause_hypothesis`、`fix_plan`、`regression_watchlist`\n- `VAL`：`verification_matrix`、`evidence_requirements`、`pass_criteria`、`residual_risks`\n\n## 字段释义\n\n- `device_constraints`：指由状态栏、导航栏、挖孔区、软键盘和沉浸式窗口带来的适配硬约束。在 `device-avoid-areas` 中，通常是哪些系统区域会遮挡内容、背景是否允许延伸、哪些交互区绝不能落入不可点击区域。\n- `capability_boundary`：指当前避让方案在哪些窗口模式、系统 UI 状态或设备类型下有效，哪些场景需要回退或额外处理。\n- `acceptance_focus`：指需求阶段验收时必须重点确认的遮挡现象、键盘开闭行为和系统区域变化表现。\n- 统一输出字段中每个阶段列出的字段表示“命中避让场景后，该阶段必须输出这些字段”，由阶段决定输出内容，不再由场景单独定义。\n\n## 场景决策树\n\n```\n用户提出避让区相关问题\n│\n├── Step 1: 阶段判断（primary_phase）\n│   │\n│   │  判断原则: 用户是否在描述已有代码\u002F页面上出现的不正确结果\n│   │\n│   ├── FIX: 满足以下任一条件\n│   │   ├── 用户描述了已有实现运行后的异常结果\n│   │   │   强信号: \"不生效\"、\"仍然是\"、\"错乱\"、\"跳变\"、\"返回值为0\"、\"被压缩\"\n│   │   │   中信号: \"被遮挡\"、\"没有延伸\"、\"没有更新\"、\"重叠\"、\"上推\"、\"截断\"\n│   │   ├── 用户明确要求排查\u002F修复已有问题\n│   │   │   关键词: \"排查原因\"、\"修复\"、\"为什么不生效\"、\"请排查\"\n│   │   └── prompt 同时包含 API\u002F代码片段 + 异常结果（双重确认）\n│   │\n│   ├── DEV: 描述全新功能需求，无已有异常\n│   │   关键词: \"需要实现\"、\"请给出开发方案\"、\"请给出完整方案\"\n│   │   注意: \"不能被遮挡\"（设计约束）≠ \"被遮挡\"（已有问题）\n│   │\n│   └── REQ: 描述需求并要求分析\u002F评估\n│   │   关键词: \"请给出需求分析\"、\"请分析\"、\"评估\"\n│\n├── Step 2: 主场景路由（primary_scene）\n│   │\n│   ├── Q1: 是否涉及键盘弹出\u002F遮挡输入框？\n│   │   └── 是 → AVOID-04 软键盘避让与输入区稳定性\n│   │       └── 结束路由\n│   │\n│   ├── Q2: 是否调用了 setWindowLayoutFullScreen 或 setWindowSystemBarProperties？\n│   │   ├── 是 → AVOID-03 沉浸式全屏布局\n│   │   │   └── 例外：如果核心是挖孔\u002FCutout遮挡UI元素 → AVOID-01（挖孔优先于全屏）\n│   │   └── 否 → 继续 Q3\n│   │\n│   ├── Q3: 核心问题是\"背景延伸但内容不延伸\"？\n│   │   │   特征关键词: expandSafeArea、背景铺满、内容保持安全区\n│   │   ├── 是 → AVOID-02 安全区扩展与背景延伸\n│   │   │   └── 例外：如果同时调用了全屏API → AVOID-03\n│   │   └── 否 → 继续 Q4\n│   │\n│   └── Q4: 是否涉及避让区域信息的获取\u002F监听？\n│       │   特征关键词: getWindowAvoidArea、avoidAreaChange、\n│       │             TYPE_CUTOUT、避让失效、返回异常值\n│       ├── 是 → AVOID-01 避让区域识别与动态获取\n│       └── 否 → 不命中避让区技能（not_in_scope）\n│\n└── Step 3: 关联场景补充（secondary_scenes）\n    │   按用户问题中同时涉及的内容添加，无明确关联则输出 []\n    │\n    ├── AVOID-01 + AVOID-02: 同时涉及避让区域获取 + 背景延伸\u002F内容边界\n    ├── AVOID-01 + AVOID-03: 同时涉及避让区域获取 + 全屏模式\n    ├── AVOID-03 + AVOID-02: 同时涉及全屏模式 + expandSafeArea\n    ├── AVOID-04 + AVOID-01: 同时涉及键盘 + 多种避让区域监听\n    └── []: 无明确关联\n```\n\n## 场景索引\n\n#### `AVOID-01` 避让区域识别与动态获取\n\n```yaml\nscene_id: AVOID-01\nscene_name: 避让区域识别与动态获取\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - AvoidAreaType\n  - TYPE_SYSTEM\n  - TYPE_NAVIGATION_INDICATOR\n  - TYPE_CUTOUT\n  - TYPE_KEYBOARD\napplies_when:\n  - 需要动态获取系统栏、挖孔区或键盘区域\n  - 当前问题表现为内容被系统区域遮挡\n  - 涉及挖孔\u002FCutout\u002FTYPE_CUTOUT 遮挡 UI 元素（最高优先级，即使同时使用全屏 API）\n  - 折叠屏展开\u002F折叠或横竖屏切换后，避让区域高度变化导致布局不更新\n  - avoidAreaChange 监听未注册或 getWindowAvoidArea 时序问题导致获取旧值\n  - getWindowAvoidArea 返回值异常（为 0 或不正确），且未使用全屏 API\nnot_applies_when:\n  - 只是背景延伸且不涉及动态获取避让区域（属于 AVOID-02）\n  - 已使用 setWindowLayoutFullScreen 或 setWindowSystemBarProperties 开启全屏，getWindowAvoidArea 只是为全屏布局提供避让参数（属于 AVOID-03）\n  - 使用 setWindowLayoutFullScreen 后 getWindowAvoidArea 返回 0，属于全屏配置问题（属于 AVOID-03）\n  - 仅涉及键盘弹出遮挡输入框（属于 AVOID-04）\n  - 用户使用了 expandSafeArea 且问题出在内容层未加 padding 避让（属于 AVOID-02）\n  - 用户问题主要涉及软键盘弹出遮挡，getWindowAvoidArea 只是辅助监听（属于 AVOID-04）\n  - 问题核心是 padding 加在错误位置，而非避让区域获取（属于 AVOID-02）\ndecisions:\n  REQ:\n    - 确定目标避让区域类型：无输入框跳过 TYPE_KEYBOARD；内容不靠近边缘可降低优先级（参考 RSC_AVOID_06 场景5 状态栏适配中避让区域类型的选择）\n    - 确定覆盖设备形态：折叠屏必须考虑展开\u002F折叠后高度变化；平板注意导航条可能不存在\n    - 确定是否需要持续监听：静态布局可一次性获取；支持旋转\u002F折叠必须 avoidAreaChange\n  DEV:\n    - 选择获取方式：一次性用 getWindowAvoidArea，响应变化用 avoidAreaChange，通常两者配合（参考 RSC_AVOID_06 场景4 挖孔区四方向检测的实现）\n    - 选择注册时机：全局复用在 onWindowStageCreate，单页面用在 aboutToAppear（注意窗口就绪时序）\n    - 选择消费策略：padding（最常用）\u002F margin \u002F 组件级 offset \u002F 结构切换（横竖屏两套布局）\n    - 处理时序兜底：avoidAreaChange 回调触发前用缓存值，getWindowAvoidArea 返回 0 时延迟重试\n  FIX:\n    - 定位问题环节：始终遮挡→获取环节；变化后遮挡→监听环节（参考 RSC_AVOID_05 场景11）；首次加载遮挡→时序环节（参考 RSC_AVOID_05 场景10）\n    - 检查避让类型完整性：是否遗漏 TYPE_CUTOUT 或 TYPE_NAVIGATION_INDICATOR（参考 RSC_AVOID_05 场景2 挖孔区未检测 TYPE_CUTOUT）\n    - 检查回调链路：是否注册 → 注册时机是否正确 → 回调是否触发 → UI 状态是否绑定\n    - 检查设备形态切换：折叠屏展开\u002F横竖屏旋转后回调是否重新触发、值是否正确更新（参考 RSC_AVOID_05 场景10 windowSizeChange 时序问题、场景12 display.on 时序跳变）\n  VAL:\n    - 截图验证：直板竖屏\u002F横屏、折叠屏折叠态\u002F展开态、平板默认态\n    - 动态变化证据：旋转前后、折叠\u002F展开前后的截图对比\n    - 数值验证：getWindowAvoidArea 返回值不为 0，avoidAreaChange 回调值在变化前后不同\nresource_refs:\n  - RSC_AVOID_01\n  - RSC_AVOID_05\n  - RSC_AVOID_06\n```\n\n#### `AVOID-02` 安全区扩展与背景延伸\n\n```yaml\nscene_id: AVOID-02\nscene_name: 安全区扩展与背景延伸\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - expandSafeArea\n  - SafeAreaType\n  - SafeAreaEdge\n  - 背景延伸\n  - 背景色铺满状态栏\n  - 图片延伸到系统栏\n  - 内容保持在安全区\n  - enableComponentSafeArea\n  - HdsNavigation安全区\napplies_when:\n  - 背景需要铺满系统区域，但内容仍需保持在安全区内\n  - 需要明确顶部和底部内容边界\n  - 未调用 setWindowLayoutFullScreen，仅用 expandSafeArea 延伸背景\n  - 核心特征是\"背景延伸、内容不延伸\"\n  - expandSafeArea 已设置但背景未延伸或内容层未留 padding\n  - padding 加在了外层容器而非子组件上，导致背景色出现间隙（属于分层问题，不是全屏设置问题）\nnot_applies_when:\n  - 页面使用了 setWindowLayoutFullScreen 开启全屏（属于 AVOID-03）\n  - 使用了 setWindowSystemBarProperties 设置状态栏透明（属于 AVOID-03）\n  - 涉及避让系统导航条 + 沉浸效果且使用 AvoidAreaManager 管理器（属于 AVOID-03）\n  - 涉及键盘弹出遮挡输入框（属于 AVOID-04）\n  - 需要动态获取避让区域类型（属于 AVOID-01）\ndecisions:\n  REQ:\n    - 确定需要延伸的层：背景层（颜色\u002F图片）必须铺满系统栏区域，内容层（文字\u002F按钮）必须保持在安全区内\n    - 确定延伸方向：通常顶部（状态栏）和底部（导航条），左右视设计稿决定\n    - 确定内容安全间距：内容距离安全区边缘的最小距离，是否需要额外留白\n  DEV:\n    - 选择 expandSafeArea 参数：SafeAreaType 指定 SYSTEM\u002FCUTOUT\u002FKEYBOARD，SafeAreaEdge 指定 TOP\u002FBOTTOM\u002FSTART\u002FEND\n    - 决定设置层级：expandSafeArea 加在背景容器上，而非内容组件上\n    - 决定内容层 padding 补偿：背景延伸后内容层需手动加 padding 保持安全区，padding 必须加在子组件上（加在外层容器会导致背景色间隙）\n    - 处理 SafeAreaEdge 遗漏：只设 TOP 不设 BOTTOM → 底部出现间隙；需按设计稿逐方向确认\n  FIX:\n    - 定位间隙来源：背景色在系统栏区域出现间隙 → padding 加在了外层容器而非子组件，分层策略有误（参考 RSC_AVOID_05 场景4 顶部 padding 位置错误导致背景色间隙）\n    - 定位内容溢出：内容跑到状态栏区域 → expandSafeArea 错误地加在了内容层而非背景层\n    - 排查全屏 API 干扰：如果同时调了 setWindowLayoutFullScreen，问题可能属于 AVOID-03 而非本场景\n  VAL:\n    - 截图验证：安全区边界处背景是否铺满、内容是否保持安全距离\n    - 多设备验证：不同状态栏高度、有无导航条的设备上表现是否一致\n    - 旋转验证：横竖屏切换后背景是否仍然延伸、内容是否仍然安全\nresource_refs:\n  - RSC_AVOID_02\n  - RSC_AVOID_05\n```\n\n#### `AVOID-03` 沉浸式全屏布局\n\n```yaml\nscene_id: AVOID-03\nscene_name: 沉浸式全屏布局\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - setWindowLayoutFullScreen\n  - 全屏\n  - 沉浸式\n  - 状态栏透明\n  - 列表沉浸\n  - 滚动隐藏标题栏\n  - 浮层 TabBar\n  - 阅读器全屏\n  - 视频播放全屏\n  - hdsMaterial\n  - 沉浸光感\n  - dynamicHideTitleBar\n  - scrollEffectOpts\n  - 滚动模糊\n  - systemMaterialEffect\n  - barFloatingStyle\napplies_when:\n  - 页面需要背景或媒体内容铺满边缘\n  - 当前问题表现为全屏后内容与系统栏重叠\n  - 列表\u002F信息流场景需要上滑隐藏标题栏和导航栏\n  - 核心特征是\"调用了 setWindowLayoutFullScreen 或状态栏透明设置\"\n  - 涉及浮层 TabBar、自定义导航栏等全屏场景组件\nnot_applies_when:\n  - 仅使用 expandSafeArea 背景延伸，未开启全屏（属于 AVOID-02）\n  - 问题核心是 padding 加在了错误位置（如外层容器而非子组件），而非全屏设置问题（属于 AVOID-02）\n  - 问题核心是 avoidAreaChange 监听未注册或 getWindowAvoidArea 时序问题导致折叠屏变化后不更新（属于 AVOID-01）\n  - 涉及键盘弹出导致布局问题（属于 AVOID-04）\n  - 仅需要获取避让区域高度，不涉及全屏（属于 AVOID-01）\n  - 涉及挖孔遮挡 UI 元素（属于 AVOID-01，挖孔优先于全屏）\ndecisions:\n  REQ:\n    - 确定沉浸式类型：完全沉浸（视频\u002F阅读器全屏）、半沉浸（列表上滑隐藏标题栏）（参考 RSC_AVOID_06 场景1 列表滚动沉浸）、持续沉浸（自定义导航栏+透明状态栏）\n    - 确定系统栏可见性：完全隐藏 vs 透明显示 vs 半透明叠加\n    - 确定退出机制：返回键退出、手势退出、超时自动退出\n  DEV:\n    - 选择窗口级 API：setWindowLayoutFullScreen 开启全屏 + setWindowSystemBarProperties 设置状态栏颜色\u002F透明度\n    - 选择页面级避让策略：全屏后内容延伸到系统栏区域，需在页面内用 avoidAreaChange 获取高度手动处理 padding\n    - 处理列表沉浸：上滑隐藏标题栏 → 监听滚动偏移量动态调整；浮层 TabBar → offset 跟随滚动（参考 RSC_AVOID_06 场景1 onScrollFrameBegin 线性比例算法）\n    - 处理自定义导航栏：padding-top = 状态栏高度（从 avoidAreaChange 获取），不能硬编码\n    - 识别实践场景：命中 list immersive \u002F video immersive \u002F reading immersive 时必须逐条对照实现（参考 RSC_AVOID_06 场景1\u002F2\u002F3 的完整方案）\n  FIX:\n    - 确认全屏是否生效：setWindowLayoutFullScreen 调用后 getWindowAvoidArea 仍返回 0 → 全屏配置未生效或调用时机不对\n    - 定位内容遮挡：全屏后内容跑到状态栏下面 → 页面内未加避让 padding 或未注册 avoidAreaChange（参考 RSC_AVOID_05 场景1 阅读器顶部遮挡、场景7 底部被导航指示器遮挡）\n    - 定位系统栏显示异常：setWindowSystemBarProperties 后状态栏仍不透明 → 检查调用时机（需在窗口创建后）和参数格式\n    - 排查非全屏场景：如果未调用 setWindowLayoutFullScreen，问题属于 AVOID-01 或 AVOID-02\n  VAL:\n    - 截图验证：全屏模式下背景是否铺满、内容是否合理避让\n    - 系统栏交互验证：滑动\u002F点击时系统栏是否按预期显示\u002F隐藏\u002F恢复\n    - 多设备验证：不同状态栏高度下自定义导航栏高度是否正确\n    - 退出验证：各种退出方式是否正常恢复非沉浸状态\nresource_refs:\n  - RSC_AVOID_03\n  - RSC_AVOID_06\n  - RSC_AVOID_05\n```\n\n#### `AVOID-04` 软键盘避让与输入区稳定性\n\n```yaml\nscene_id: AVOID-04\nscene_name: 软键盘避让与输入区稳定性\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - keyboardAvoidMode\n  - avoidAreaChange\n  - 输入框被遮挡\n  - 键盘弹出\napplies_when:\n  - 输入框、按钮或底部操作栏会被软键盘遮挡\n  - 当前问题表现为键盘开闭导致内容跳动或错位\nnot_applies_when:\n  - 页面没有输入交互\n  - 不涉及软键盘，仅涉及系统栏或挖孔区（属于 AVOID-01\u002F02\u002F03）\ndecisions:\n  REQ:\n    - 确定页面输入场景：单输入框（登录页）、多输入框（表单）、底部输入框（聊天页）、固定底部栏（底部按钮+输入框）\n    - 确定避让期望：内容上推\u002F滚动到可见区域\u002F底部栏固定上移\u002F布局重排\n    - 确定焦点切换行为：多输入框间切换时是否需要平滑滚动\n    - 确定键盘收起后恢复：是否立即恢复原位、是否有动画过渡\n  DEV:\n    - 选择 keyboardAvoidMode：RESIZE（调整窗口大小，适合固定布局）PAN（平移内容，适合单输入框简单场景）OFFSET（偏移，适合有底部固定栏的场景）\n    - 处理底部固定栏：键盘弹出后底部栏需上移 → 通过 avoidAreaChange 中 TYPE_KEYBOARD 获取高度计算 offset\n    - 处理列表\u002F表单滚动：键盘弹出后自动滚动到焦点输入框 → 结合 scroller.scrollToIndex 或 scrollTo\n    - 处理键盘动画时序：键盘收起动画期间布局可能跳动 → avoidAreaChange 回调中 keyboard height 从非 0 变为 0 时延迟恢复\n  FIX:\n    - 定位问题类型：输入框被遮挡 → 避让模式或 offset 计算有误；布局跳动 → 键盘弹出\u002F收起动画冲突；底部栏异常 → 固定定位与键盘避让策略冲突\n    - 检查 keyboardAvoidMode：是否选错模式（如列表页用了 PAN 导致内容被裁切而非滚动）\n    - 检查焦点与滚动同步：点击输入框后是否自动滚动到可见位置，多输入框切换时是否跟随\n    - 检查键盘收起恢复：收起后布局是否恢复原位、是否有残留 offset、快速弹出\u002F收起时是否稳定\n    - 排查非键盘问题：如果遮挡来自系统栏或挖孔而非键盘 → 属于 AVOID-01\u002F02\u002F03\n  VAL:\n    - 截图验证：键盘弹出时输入框是否可见、底部栏是否正确上移\n    - 键盘收起验证：收起后布局是否恢复原位、无残留偏移\n    - 焦点切换验证：多输入框间切换时页面是否平滑滚动到目标输入框\n    - 多输入法验证：系统键盘 vs 第三方输入法（高度不同）表现是否一致\n    - 边界场景：快速弹出\u002F收起、横屏键盘、物理键盘连接时的稳定性\nresource_refs:\n  - RSC_AVOID_01\n  - RSC_AVOID_04\n  - RSC_AVOID_05\n  - RSC_AVOID_06\n```\n\n## 资源索引\n\n#### `RSC_AVOID_01` 避让区域类型参考\n\n```yaml\nresource_id: RSC_AVOID_01\nresource_type: reference\npath: .\u002Freferences\u002Favoid_area_types.md\nused_for:\n  - 识别系统栏、导航栏、挖孔区和键盘区域类型\n  - 设计动态获取与监听策略\nload_when:\n  - 命中 AVOID-01 或 AVOID-04\navoid_when:\n  - 当前不涉及系统区域和键盘区域\nsupports_scenes:\n  - AVOID-01\n  - AVOID-04\noutput_fields:\n  - device_constraints\n  - capability_boundary\n  - implementation_notes\n  - root_cause_hypothesis\n  - verification_matrix\n```\n\n#### `RSC_AVOID_02` 安全区扩展参考\n\n```yaml\nresource_id: RSC_AVOID_02\nresource_type: reference\npath: .\u002Freferences\u002Fsafe_area_api.md\nused_for:\n  - 定义安全区扩展和背景延伸的边界\n  - 判断内容层与背景层的职责划分\nload_when:\n  - 命中 AVOID-02\navoid_when:\n  - 页面不使用安全区扩展\nsupports_scenes:\n  - AVOID-02\noutput_fields:\n  - device_constraints\n  - capability_boundary\n  - implementation_notes\n  - fix_plan\n  - pass_criteria\n```\n\n#### `RSC_AVOID_03` 沉浸式布局参考\n\n```yaml\nresource_id: RSC_AVOID_03\nresource_type: reference\npath: .\u002Freferences\u002Fimmersive_layout.md\nused_for:\n  - 定义窗口级全屏和页面级避让的配合方式\n  - 排查沉浸式布局中的内容遮挡问题\nload_when:\n  - 命中 AVOID-03\navoid_when:\n  - 页面不需要沉浸式展示\nsupports_scenes:\n  - AVOID-03\noutput_fields:\n  - device_constraints\n  - implementation_notes\n  - root_cause_hypothesis\n  - verification_matrix\n  - residual_risks\n```\n\n#### `RSC_AVOID_04` 键盘避让参考\n\n```yaml\nresource_id: RSC_AVOID_04\nresource_type: reference\npath: .\u002Freferences\u002Fkeyboard_handling.md\nused_for:\n  - 设计键盘弹出、收起和焦点切换时的避让逻辑\n  - 排查输入区跳动、按钮被遮挡等问题\nload_when:\n  - 命中 AVOID-04\navoid_when:\n  - 页面没有输入交互\nsupports_scenes:\n  - AVOID-04\noutput_fields:\n  - acceptance_focus\n  - implementation_notes\n  - fix_plan\n  - verification_matrix\n  - evidence_requirements\n```\n\n#### `RSC_AVOID_05` 问题修复案例集\n\n```yaml\nresource_id: RSC_AVOID_05\nresource_type: reference\npath: .\u002Freferences\u002Fbug-fix-cases.md\nused_for:\n  - 排查状态栏遮挡、挖孔区遮挡、沉浸式布局错位、键盘避让异常等常见问题\n  - 排查安全区扩展与背景延伸相关的 padding 位置错误、背景色间隙等问题\nload_when:\n  - 命中 AVOID-01 或 AVOID-02 或 AVOID-03 或 AVOID-04 且处于 FIX 阶段\navoid_when:\n  - 当前不涉及问题修复\nsupports_scenes:\n  - AVOID-01\n  - AVOID-02\n  - AVOID-03\n  - AVOID-04\noutput_fields:\n  - problem_profile\n  - root_cause_hypothesis\n  - fix_plan\n  - regression_watchlist\n```\n\n#### `RSC_AVOID_06` 开发场景方案集\n\n```yaml\nresource_id: RSC_AVOID_06\nresource_type: reference\npath: .\u002Freferences\u002Fscenario-development-cases.md\nused_for:\n  - 提供沉浸式布局等场景的完整开发方案与分步实现\n  - 提供挖孔区适配、底部导航栏避让、状态栏适配、键盘易操作等场景的完整开发方案\nload_when:\n  - 命中 AVOID-01 或 AVOID-03 或 AVOID-04 且处于 REQ 或 DEV 阶段\navoid_when:\n  - 当前处于 FIX 阶段（应走 RSC_AVOID_05）\nsupports_scenes:\n  - AVOID-01\n  - AVOID-03\n  - AVOID-04\noutput_fields:\n  - acceptance_focus\n  - implementation_notes\n  - code_touchpoints\n  - verification_matrix\n```\n",{"name":5,"metadata":24,"description":7},{"version":25,"keywords":26},"1.0.2",[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49],"避让区","安全区","safe area","avoid area","状态栏避让","导航栏避让","挖孔屏","刘海屏","cutout","沉浸式布局","全屏适配","软键盘遮挡","键盘顶起","keyboard overlap","HDS","HDS沉浸式","高级组件","HdsNavigation","dynamicHideTitleBar","hdsMaterial","沉浸光感","systemMaterialEffect","滚动模糊","main","581098187aec1258c6d9e65e1b9866c2e7381167","skills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas",0,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills","https:\u002F\u002Fgithub.com\u002FIsKenKenYa","是小啃啃呀-一个初学者，中国开源共享推动者之一。\r\n未来，会涉及OpenHarmony、HarmonyOS（部分应用开源）、Android Open Sources Project等。\r\n\r\n目前正在学习中，欢迎友善的讨论。","2026-10-08 01:02:25",{"source":8,"skillName":5,"commands":59,"prompt":69,"zipAvailable":70},[60,63,66],{"tool":61,"command":62},"npx","npx skills add IsKenKenYa\u002Fskills --skill hmos-multidevice-avoid-areas",{"tool":64,"command":65},"bunx","bunx skills add IsKenKenYa\u002Fskills --skill hmos-multidevice-avoid-areas",{"tool":67,"command":68},"pnpm","pnpm dlx skills add IsKenKenYa\u002Fskills --skill hmos-multidevice-avoid-areas","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002FSKILL.md",true,[72,78,82,86,90,94,98,102,106,110,114,120,124,128],{"path":73,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":76,"sourceHtmlUrl":77},"assets\u002FAvoidAreaExample.ets","ASSET","资产文件",1545,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FAvoidAreaExample.ets",{"path":79,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":80,"sourceHtmlUrl":81},"assets\u002FBackgroundImmersiveExample.ets",483,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FBackgroundImmersiveExample.ets",{"path":83,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":84,"sourceHtmlUrl":85},"assets\u002FCutoutAvoidance4DirExample.ets",1270,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FCutoutAvoidance4DirExample.ets",{"path":87,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":88,"sourceHtmlUrl":89},"assets\u002FCutoutAvoidanceExample.ets",952,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FCutoutAvoidanceExample.ets",{"path":91,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":92,"sourceHtmlUrl":93},"assets\u002FCutoutAvoidanceManager.ets",6603,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FCutoutAvoidanceManager.ets",{"path":95,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":96,"sourceHtmlUrl":97},"assets\u002FFullScreenLayoutExample.ets",1235,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FFullScreenLayoutExample.ets",{"path":99,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":100,"sourceHtmlUrl":101},"assets\u002FgetAvoidAreas.ets",1123,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FgetAvoidAreas.ets",{"path":103,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":104,"sourceHtmlUrl":105},"assets\u002FKeyboardAvoidanceExample.ets",2452,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FKeyboardAvoidanceExample.ets",{"path":107,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":108,"sourceHtmlUrl":109},"assets\u002FRegisterFormListExample.ets",3359,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FRegisterFormListExample.ets",{"path":111,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":112,"sourceHtmlUrl":113},"assets\u002FRegisterFormScrollExample.ets",4558,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Fassets\u002FRegisterFormScrollExample.ets",{"path":115,"resourceType":116,"resourceTypeDesc":117,"sizeBytes":118,"sourceHtmlUrl":119},"test-cases\u002Freal-world\u002Freal-world-avoid-areas.json","REFERENCE","参考文档",39139,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Ftest-cases\u002Freal-world\u002Freal-world-avoid-areas.json",{"path":121,"resourceType":116,"resourceTypeDesc":117,"sizeBytes":122,"sourceHtmlUrl":123},"test-cases\u002Fscene-functional\u002Fscene-functional-avoid-areas.json",36891,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Ftest-cases\u002Fscene-functional\u002Fscene-functional-avoid-areas.json",{"path":125,"resourceType":116,"resourceTypeDesc":117,"sizeBytes":126,"sourceHtmlUrl":127},"test-cases\u002Fsmoke\u002Fsmoke-avoid-areas.json",37787,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Ftest-cases\u002Fsmoke\u002Fsmoke-avoid-areas.json",{"path":129,"resourceType":116,"resourceTypeDesc":117,"sizeBytes":130,"sourceHtmlUrl":131},"test-cases\u002Ftest-promts.md",933,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-avoid-areas\u002Ftest-cases\u002Ftest-promts.md",[133,140,147,154,161,168],{"skillNo":134,"name":135,"nameZh":6,"description":136,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":137,"categories":138,"keywords":139,"publishedAt":19},"01M75ZN00W20TC7TJ40TDM7E4X","writing-for-agents","为 agent 撰写文档。当创建或编辑 skill、修改 AGENTS.md 或 CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":141,"name":142,"nameZh":6,"description":143,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":144,"categories":145,"keywords":146,"publishedAt":19},"01M75ZMZ63RYMNRTPEXW5T82S6","wait-what","停。上一条消息没讲明白：换个说法再讲一遍。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":153,"publishedAt":19},"01M75ZMXZT6MGCGFMKRTM6V6GW","to-questionnaire","把你无法独自回答的决策转化成一份问卷，交给别人填写。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":158,"categories":159,"keywords":160,"publishedAt":19},"01M75ZMWQGNJW3E592V94ZYJMX","teach","在当前工作区内，教会用户一项新 skill 或概念。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":162,"name":163,"nameZh":6,"description":164,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":165,"categories":166,"keywords":167,"publishedAt":19},"01M75ZMVQREJR3YDK0XED9AJHB","handoff","把当前对话压缩成一份交接（handoff）文档，供另一个代理接手。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":19},"01M75ZMTQAAFGA7QH26WK9Z936","grilling","就一个计划、决策或想法对用户进行无情的访谈。当用户想压力测试自己的思路，或使用任何 'grill' 触发短语时使用。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]