用途
aso-analysis 用于对 App Store 或 Google Play 上的应用进行 ASO（应用商店优化）分析。它既可以分析单个应用，也可以分析一个应用集合，或集合中用户选定的子集。分析范围涵盖关键词排名、历史趋势（按验证门控可用性）、类目排名趋势、关键词机会与竞品差距等。
主要能力
- 多范围分析：支持 scope 为单个 app、整个 collection 或用户选定的 collection_subset。子集分析时，先通过 list_collections 和 list_apps 解析集合，再仅对选定应用收集 ASO 数据。
- 国家与设备：可指定多个国家（默认 1 个主要国家）和设备（App Store → iphone/ipad，Google Play → android）。
- 关键词种子：可选传入关键词种子，用于生成关键词建议或搜索。
- 趋势分析（验证门控）：趋势功能依赖 list_keywords / get_rankings 在传入过去日期时返回真实历史快照，受 smoke gate iv 门控。若门控通过，可展示 S=4 个采样日期（今天、-7d、-14d、-28d）的关键词排名和类目排名趋势；若未通过，则仅提供当前快照分析（TOP3/TOP10/TOP30/TOP100/UNRANKED 分桶、效果分层、竞品差距），并在报告页脚明确说明趋势不可用。
- 关键词编辑（唯一写入路径）：提出最多 15 个候选关键词，由用户明确选择后，通过 edit_keywords 替换追踪关键词集合。流程包括：读取当前关键词集（分页直至耗尽）、构建 CSV（当前集 ∪ 选中关键词，去重、不区分大小写）、使用 edit_keywords_preview 预览（必须显式传入 apps_id）、用户批准后执行 edit_keywords。若遇到大小限制错误则停止并告知用户，不拆分调用。执行前需再次读取当前集，若集合有变化则重新预览和批准。
- 元数据优化建议：通过 get_app_metadata（若可用）、aso_search_results 或用户粘贴获取当前元数据，输出每个字段的当前值、建议值、获得/失去的关键词、理由、本地化风险，并提示用户在 App Store Connect / Play Console 中应用。不包含元数据写入功能。
- 关键词效果分层：仅依据 list_keywords.effectiveness 字段分层：WORTH IT（>20）与 SKIP（<=20），按 effectiveness 降序排列。popularity 和 difficulty 仅作为信息列展示，不驱动分层。每个发现附带 expected_impact 和可复现的 evidence。
使用方式
该技能通过 MCP 工具调用 AppFollow 数据。使用前需先阅读 using-appfollow 文档（会话、写入仪式、错误码）。分析时根据输入参数（scope、countries、devices、keyword seeds）收集数据，默认深度采样趋势数据。输出为 aso-analysis-<scope>-<date>.html 报告和 findings.json 文件（符合 appfollow.toolkit.findings/v1 模式，report_type 为 "aso"，写入前需通过 schemas/findings.schema.json 验证）。在 Claude Code 中发布 artifact；在 Codex 中写入文件并告知路径。
适用场景
- 应用开发者或 ASO 专员评估应用在特定国家/设备的关键词表现。
- 对比应用集合中多个应用的 ASO 表现。
- 发现关键词机会和竞品差距。
- 在用户确认下更新追踪关键词集合。
- 获取元数据优化建议。
限制
- 趋势功能依赖 smoke gate iv，未通过时仅能提供当前快照。
- 不支持在一次报告中跨多个集合分析（已推迟）。
- edit_keywords 会替换整个追踪关键词集，必须包含当前集以避免丢失。
- 元数据无写入能力，仅提供建议。
- aso_featured_apps 处于 HOLD 状态，预计返回 VALIDATION_ERROR，相关章节标记为 n/a。
- get_aso_report_app_store 和 get_aso_report_gdc_google_play 为可选工具，出错时章节标记 n/a。
- 费用估算基于调用次数，具体积分消耗需参考 AppFollow 计费规则。