Skip to content

ai-workspace-lab/xworkspace-core-skills / skills/engineering-standards/store-and-startup-homepage-spec

store-and-startup-homepage-spec

Verified

公司官网与产品主页的审核就绪规范(项目级标准)。凡修改公开官网、产品页、页脚/联系方式、边缘路由(CDN Worker/WAF/DNS)或发布流水线,都必须满足 Google(Startups / Play / Android)、Apple(Developer / App Store)、Microsoft 的公司与应用审核对官网的要求;也用于审核被拒("did not match your company domain"、"insufficient company information")后的根因定位。覆盖品牌域名边界、30 秒审核事实、真实性红线、首页/产品页结构、单一身份配置源、合规入口、可抓取性、商店对照表、部署后 post-check 清单与自动化自检。

Store and Startup Homepage Spec

目标:审核员(人工或爬虫)打开品牌域名首页 30 秒内,不离开该域名,就能确认"公司真实、产品真实、可以使用、仍在开发"。本规范是项目标准:相关改动的 PR 必须过第 8 节自检,发布流水线必须带第 9 节 post-check。

1. 30 秒审核事实

首屏加一次滚动内回答以下问题,每个都要有同域可点击的证据:

问题首页必须出现的证据
Who are you?法人全称(与申请表一致):首屏或紧邻区块 + 页脚 © {year} {Legal Name}
What are you building?H1 = 主产品名 + 一句话价值;只有一个主推产品
Is there a real product?真实界面截图 / 演示 / 文档,链接到 /products/<slug>
Can I use it?主 CTA(Start free / Download),目标页可匿名打开
Is the company real?About / Contact / Terms / Privacy + 同域邮箱
Is development active?公开 GitHub 仓库、最新 Release、Changelog / Blog

2. 域名边界(被拒最常见的根因)

  • 品牌域名承载全部公开页面:首页、/products/*、定价、下载、文档、博客、支持、法务都在品牌域名直接返回 200,不得任何 3xx(跳到平台域名固然不行,跳到自己的别的页面也让"文档"入口变成假入口)。
  • 只有账户、在线应用与 API 可留在平台域名:登录、注册、控制台、在线工作空间应用(浏览器内同源调用 /api/*)与 /api/* 本身,其 Cookie、OAuth 回调、CORS 都绑定在平台主机上,可以跳转。放开品牌域名路由前,先看平台侧已有的边界校验(如发布流水线的 public-chain 检查)锁定了哪些路径必须跳转。
  • 先查边缘层:跳转常来自 CDN Worker / 边缘路由的"品牌域名白名单",而非应用代码。对首页每个导航链接 curl -sI,看 Location 与响应头来源。
  • WAF 不得拦截公开页:公开路径关闭 Managed Challenge / Under Attack / Bot Fight;已知合规爬虫(Googlebot、Applebot、bingbot)走 Bypass。被拦时爬虫只拿到 403 + noindex 的质询页。
  • Apex 与 www 都要解析并各有证书,其中一个 301 到另一个。
  • 遗留域名 = 死链:已无 DNS 的旧域名(含 www. 变体)不得出现在 canonical、sitemap、JSON-LD 或任何链接里。

3. 真实性红线

审核对"不实"比对"简陋"更敏感:

  • 不自称 "Verified / 官方认证",除非第三方确实授予。
  • 概念图、设计稿标 "Overview / 预览",不得标"真实界面 / Real UI";尽量补真实截图。
  • 可用性矩阵只列已发布制品实际覆盖的平台与格式(以 Release 资产清单为准)。
  • JSON-LD、llms.txt 的平台、价格、描述必须与页面一致。
  • 公开邮箱只用已确认能收信的同域邮箱,不要为了"好看"新造 legal@ 之类。
  • 不删现有产品页来"变干净";修正死链即可(业务方明确下线除外)。

4. 页面结构

首页(一页一个主叙事):Header(Logo、产品、定价、文档、About、Sign in + 主 CTA)→ Hero(主产品名 H1、价值主张、主/次 CTA、真实产品图、"by {Legal Name}")→ Proof(真实截图 + 可用平台)→ 产品矩阵(每个产品链接站内 /products/<slug>)→ 定价入口 → Company block(Built by + About/Contact/GitHub)→ Footer(产品/资源/公司/法务列,© {year} {Legal Name},GitHub)。

产品页 /products/<slug>:Hero → What it is → Problem(3 条)→ How it works(3–4 步)→ Screenshots → Availability → Source & Downloads(公开仓库 + releases/latest)→ Get started。每段由服务端渲染出正文。

文档入口 /docs:必须是渲染真实内容的页面(文档集合 + 仓库/README 入口),且在文档服务不可达时仍有兜底内容;不得重定向。

5. 单一身份配置源

  • 法人全称、站点 URL、支持邮箱、GitHub 组织、产品→仓库/Release 映射集中在一个模块(如 src/lib/company.ts),组件、元数据、JSON-LD 都从这里读。
  • 站内链接用根相对路径;绝对 URL 只用于 canonical、sitemap、OG,域名取自配置。
  • 链接只能指向实际存在的路由。

6. 合规入口与可抓取性

  • 页脚常驻 Privacy、Terms、Contact/Support(同域邮箱);支持注册的产品提供网页版账户删除说明/入口。
  • 首页、产品页、定价、文档用 SSR/SSG;禁用 JS 时核心文字、公司名、联系方式仍可见。
  • 根布局注入 @graph JSON-LD:Organization(name、url、logo、sameAs、contactPoint)+ 主产品 SoftwareApplication + WebSite。
  • robots.txt 不得 Disallow: /;sitemap.xml 只列品牌域名上的公开页面;可选 /llms.txt。

7. 商店与账号审核对照(Google / Apple / Android)

各平台细则会变,提交前以官方最新要求为准;下表是官网侧通常被检查的点,以及本规范对应位置。

平台通常检查的官网侧要求对应
Google for Startups / Cloud官网可直接访问、公司身份与申请一致、同域联系邮箱、有实质产品内容§1、§2、§3
Google Play / Android组织开发者账号的法人名称与官网一致;商品页填写的开发者网站、联系邮箱可公开访问;隐私政策为公开网页(非 PDF、不需登录);支持注册的应用提供网页版账户删除入口并与 Data safety 声明一致§1、§6
Apple Developer / App Store组织注册的法人实体与官网、同域邮箱匹配;App 的 Support URL(含真实联系方式)与 Privacy Policy URL 必填,Marketing URL 可选;支持注册的应用需账户删除(Guideline 5.1.1)§1、§6
Microsoft Founders Hub / Store官网与公司信息一致,产品页有实质内容§1、§3

商店后台里填写的 Website / Support / Privacy URL 必须与官网现有路径逐字一致(人工核对,部署后每次变更路由都要重查)。

8. 自检(PR 门禁)

仓库内附带两层检查,并接入 CI:

  • 守卫测试(单元测试扫描公开源码目录):无个人邮箱、无遗留品牌/版权主体、无遗留或无 DNS 的域名、无已知死链模式;每个产品登记了仓库与下载。
  • 线上探针脚本(--remote):按第 9 节清单探测已部署站点。

9. 部署后 Post-check 清单(流水线)

每次部署品牌域名所在的边界(边缘路由、SSR 公共/内容边界、Pages)后,流水线的 post-check 必须逐条通过;失败阻断发布,Cloudflare 质询这类"runner 视角"的项只告警(严格模式可转为失败):

#检查失败含义
1/ /about /contact /terms /privacy /support /products/* /prices /download /docs /blogs 全部 200,无任何 3xx页面跳出品牌域名或入口是假入口
2首页含法人全称,页脚无遗留版权主体身份与申请不一致
3/contact、/support 只出现同域邮箱,无个人邮箱;/contact 至少有一个同域地址邮箱与公司域名"对不上"
4robots.txt 200 且不 Disallow: /;sitemap.xml 有 <loc>爬虫无法收录
5公开路径无 Cloudflare 质询(爬虫 UA 探测)审核程序只拿到 403 空壳(默认告警)
6www.<apex> 有解析并跳转申请表填 www 时打不开(默认告警)
7商店后台 Website/Support/Privacy URL 与官网路径一致人工核对,非自动

实现:platform-ops-toolkit 的 scripts/serverless_uat/verify_brand_site_review_readiness.sh(serverless 编排 serverless_domains 之后运行,契约测试见 .github/scripts/tests/serverless_brand_site_review_readiness_test.sh);本地/手动用 portal 的 scripts/verify-company-site.sh --remote。可用环境变量覆盖:BRAND_LEGAL_NAME、BRAND_EMAIL_DOMAIN、BRAND_PUBLIC_PATHS、BRAND_CHECK_STRICT。

手工探针:

UA="Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)"
for p in / /about /contact /terms /privacy /products/<slug> /prices /download /docs; do
  curl -sS -o /dev/null -A "$UA" -w "%{http_code} %{redirect_url}  $p\n" "https://<brand-domain>$p"
done   # 期望全部 200 且无 Location
curl -sSL -A "$UA" https://<brand-domain>/ | grep -c "Just a moment"   # 期望 0

10. 被拒后的处理顺序

  1. 用第 9 节探针复现审核员路径,找出所有跳出品牌域名的链接和 403。
  2. 先修边缘路由 / WAF / DNS,再修页面内容和身份一致性。
  3. 探针全部通过后,回复原审核邮件请求重新处理已有申请,而不是重复提交新申请。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall