메뉴
Use when generating competitor research reports, monthly deep dives, or overseas-first app market reports that compare recent releases, top-3 screenshot diffs, and target keyword rank changes across reporting windows.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | app-competition-reporting |
| description | Use when generating competitor research reports, monthly deep dives, or overseas-first app market reports that compare recent releases, top-3 screenshot diffs, and target keyword rank changes across reporting windows. |
负责“竞品报告成稿”这条工作流。目标不是把所有采集结果原样堆进 Markdown，而是把当前轮事实整理成面向产品 / ASO 负责人和管理层的决策报告。
如果项目声明了 delivery_channel=feishu 或 dual，这条工作流默认产出 3 层结果：
详细子文档复用当前长报告主体结构，只补“决策入口层、飞书友好排版、回链主摘要”，不删除现有 Release / Screenshot / Keyword / Evidence 内容。
飞书创建与更新默认通过 $lark-doc 执行；如果目标位是知识库节点，再配合 wiki 相关能力落位。
默认优先回答：
target_keywords 有没有真实位移Name / Title / 前三张宣传图如果 target_app、核心竞品或关键词头部结果里存在“同名 / 近同名但不是同一个 app”的情况，也必须把它当成正文级风险处理，而不是埋在附录里等读者自己发现。
开始前必须：
appstore-mcp 与 mcp-appstore 可用；缺失时先看 ../app-competition-core/references/mcp-installation.mddocs/app-competition/app-compete.mddocs/app-competition/focus-apps.md默认先读取：
按模块补读：
市场解析顺序固定为：
primary_market / secondary_marketsdefault_marketUS 为主、CN 为辅，并在输出中写明这是默认初始化逻辑对象选择顺序固定为：
focus-apps.md 中 status=active 的重点关注 appapp-compete.md 的 core_competitorstarget_appbaseline：没有历史快照时使用。只写当前格局，不伪造升降趋势。pulse：短窗口检查。只写本期变化，且必须区分“真实变化”和“新纳入观察对象”。monthly-deep-dive：月报。必须覆盖主市场快照、近 30 天发版与 What's New、前三张宣传图跨窗口变化、目标产品 target_keywords 的真实 rank 位移。优先级：
monthly-deep-divepulsebaseline提取：
target_appplatformsprimary_marketsecondary_marketsreport_focustarget_keywordscore_competitorswatch_pool如果历史快照存在，优先做环比；如果不存在，当前报告标记为 baseline。
主市场必采：
target_keywords 逐个查询真实 rank，并记录必要旁证与采集时间get_app_details、appstore-mcp.get_app_info(include=full)，用于核对 Name / TitletrackViewUrl / url；缺失时用 iOS app_id 或 Android package name 拼官方商店链接appstore-mcp.get_app_info(include=screenshots)、get_app_details、必要时 Apple 页面 HTML 回退get_version_history、appstore-mcp.get_app_info(include=release)关键词主链默认只走真实 rank，不把 analyze_top_keywords、get_keyword_scores、traffic_score、difficulty_score 当成正文主链内容；如项目数据里存在这些字段，只能作为附录或 debug 旁证使用。
支撑模块只在能解释主线变化时进入正文：
对以下对象做名称近似比对：
target_appfocus-apps.md 中本轮会进入正文的对象core_competitors以下情况默认视为 name_collision_risk：
Object / Objectsdeveloper、定位或产品范围不同一旦 target_app 或正文优先对象命中该风险：
一句话结论 后插入 Name Collision / Ambiguity Alertapp_name、角色、开发者 / 公司短标签、为什么容易混淆app_id 放到附录、JSON 或证据备注，不放到首屏app_id 了事变化判断优先基于“当前快照 vs 最近一次 JSON 快照”：
What's New 与用户可感知变化change_chain截图判断必须额外区分：
tool_presenttool_empty_web_presenttool_empty_web_emptyunresolvedMCP 未返回截图 只能表示工具采集缺口。
只有网页回退也没有真实截图证据时，才允许写 App Store 页面无截图。
没有可靠历史时：
baseline 只写当前基线pulse 只能写已证实的变化，不把新纳入观察对象伪装成市场剧变月报与“决策优先”报告默认使用：
如果当次要生成飞书主摘要文档，额外使用：
正文默认结构：
决策入口层一句话结论Name Collision / Ambiguity Alert（仅在存在同名 / 近同名风险时出现）目标产品关键词表现竞品动态建议行动Optional ContextDetail Delivery ContextBack To Main Summary研究证据层目标产品关键词详细证据竞品 Name / Title / Top-3 Screenshot 证据Release Context（仅在能解释变化时出现）CN Cross-Check（仅在能解释主市场时出现）Evidence AppendixLimitations飞书主摘要文档默认结构：
封面摘要栏一句话判断目标产品关键词表现竞品变化雷达现在要做什么子文档入口范围与局限默认使用：
JSON 至少要保留：
metadata.market_scopemetadata.latest_collection_atapp_store_url（所有进入正文、主摘要、详细证据或附录的 app）delivery_outputsreport_renderingsummary_cardsmarket_snapshotrelease_analysis.appsmaterial_analysis.appsmaterial_analysis.changeskeyword_analysis.rank_trackinglimitations关键词快照必须围绕 target-only model：
keyword_analysis.rank_tracking 主字段以 keyword、target_rank、previous_rank、delta、leader_app_name、leader_rank、collected_at 为中心target_keyword_source 与 target_keyword_last_verified_at 必须保留，便于追溯每个 target keyword 的来源和最后核验时间leader_app_id、traffic_score、difficulty_score、alert_type、change_chain 只能作为辅助字段，不得在主表中抢占中心At-Risk Target Keywords / Recoverable Target Keywords，不再围绕广义机会词池组织正文素材相关 JSON 至少额外保留：
screenshot_collection_statusscreenshot_sourcesdevice_coveragewebpage_screenshot_evidenceweb_fallback_used报告完成后：
app-compete.md 的 report_historylatest_snapshotlatest_comparison_windowlatest_collection_atlatest_delivery_summary_doc 与 latest_delivery_detail_docfocus-apps.md 中涉及 app 的 last_reviewed_atapp_name，格式为 [app_name](app_store_url)，不要大量暴露 app_id目标 App、对象、竞品名称、leader_app_name 等 app 名称列只要进入报告，都优先写成可点击名称app_store_url 优先使用 MCP 返回的官方商店链接；缺失时再用 app_id / package name 拼接官方链接；仍无法确认时在附录或局限中标记链接缺失app_id 只保留在附录、JSON、证据备注和必要的歧义消解补充中app_id、原始状态码、工具内部标签、精确采集时间戳一句话结论 只写本期最值得记住的变化，不写 report_type、comparison_window 这类流程字段target_app 或正文重点对象如果存在同名 / 近同名风险，必须在目标产品关键词表现和竞品动态之前做显式歧义消解top1-3 生成的三联合并图和 1-3 条动作top1-3 生成的三联合并图top1-3 逐张原图竞品变化雷达 段内，紧跟窄表之后fact、inference、limitation 在详细层可以保留；摘要层必须改写成自然业务语言，不直接暴露技术标签Release Context 正文默认异常优先；低变化且意义弱的 maintenance 长表下沉到详细层或附录baseline 或 current baselineEvidence AppendixMCP 未返回截图 和 App Store 页面无截图 禁止混写Use when initializing or maintaining app competition research workspaces, defining market/delivery/keyword contracts, handling one or many owned apps in a portfolio competitor-analysis run, or coordinating end-to-end competitor research through discovery, reporting, Feishu delivery, email handoff, external access checks, and project index backfill.
Use when finding newly relevant competitor apps, expanding a watchlist, checking charts or similar apps, or deciding whether an app should be added to focus-apps.md or the candidate pool.