一套用于判断港股 IPO 项目所处流程节点、成功率、窗口期温度、市场承载力与时间急迫度的分析框架， 并配一个抓取脚本，从港交所（HKEX）自动拉取"在流程中"的 IPO 申请者清单。
适用人群：投行、投资人、BP 及 IPO 项目相关从业者，用于港股上市项目跟踪、最近 7 天新交表筛选、 18A / 18C 特专科技公司判断、招股书公开信息提取与案例复盘。
定位说明：这个仓库的核心价值是判断方法论（
references/framework.md）。 抓取脚本是配套工具，用来把"当前在流程中的公司"整理成一份可查的 Excel 清单。 真正的项目判断仍需要人（或 AI）结合公开招股文件来做。
hk-ipo-project-judgement/
├── SKILL.md # 入口：触发条件 + 最小工作流
├── references/
│ └── framework.md # 判断框架正文（方法论主体，最重要）
├── scripts/
│ ├── hkex_scraper.py # HKEX 申请者抓取脚本（Playwright）
│ └── requirements.txt # Python 依赖
├── .gitignore
└── README.md
不依赖脚本，也不限定某个 AI 工具。做法：
- 把
SKILL.md和references/framework.md的内容提供给你在用的 AI 助手； - 分析某家公司时，把该公司的 Application Proof / PHIP / Global Offering 的 PDF 或 HKEXnews 链接一起给它；
- 让它按框架里的固定模板输出（窗口期 → 公司背景 → 商业模式 → 流程节点 → 判断分支 → 关键数字 → 结论 → 下一步信号 → 港股 IPO 公司划分）。
框架里有一条重要纪律——没有公开招股文件，就只给查找路径，不下成功率结论。这条建议保留。
这套文件最初是为 OpenAI Codex CLI 的 skill 机制设计的。
如果你在用 Codex CLI，可把整个目录放进它的 skills 目录（通常是 ~/.codex/skills/），
让它按 SKILL.md 的工作流触发。这是它的原生场景：自动触发 + 本地自动跑抓取脚本。
Claude 也能用这套 skill，但触发和运行方式因环境而异：
| 环境 | 方法论能用 | 自动跑抓取脚本 | 触发方式 |
|---|---|---|---|
| Claude Code / 桌面版（可连本地） | ✅ | ✅ 可运行（无界面时设 HKEX_HEADLESS=1） |
明确说"用这套框架分析 XX" |
| Claude 网页版（浏览器受限） | ✅ | ❌ 跑不了脚本 | 手动把文档内容 + 公司链接给它 |
跑不了脚本时属于正常降级：跳过"自动抓取清单"这一步，改为直接提供目标公司的
HKEXnews 链接或招股文件 PDF，Claude 再据此按框架分析。判断质量不受影响——框架本就要求
以公开文件为准。SKILL.md 顶部也写了同样的适配说明。
各家 AI 工具的 skill 触发机制不完全相同；不确定时，退回"方式一"手动喂参考总是可行的。
脚本会打开港交所 Application Proof 专区， 抓取当前在流程中的申请者，输出一份带多个 sheet 的 Excel（全量申请者 / 最近 7 天新增 / 行业分布统计 / 流程节点统计）。
cd scripts
pip install -r requirements.txt
playwright install msedge # 或: playwright install chromiumpython hkex_scraper.py生成的 hkex_applicants_YYYYMMDD.xlsx 会保存在 scripts/ 目录下。
这份 Excel 是运行产物，已被 .gitignore 忽略，不进仓库——每个使用者请自己运行生成最新版本。
-
Python：建议 3.10+（脚本用到了
tuple[str, str, str]、float | None等新式类型标注）。 -
浏览器：脚本优先用 Microsoft Edge（
channel="msedge"），失败时回退到 Playwright 自带的 Chromium。 只装了 Chromium 的话，把playwright install msedge换成playwright install chromium即可。 -
无头模式：脚本默认会弹出浏览器窗口（本地调试方便）。想在服务器 / CI / 无界面沙箱里跑， 无需改代码，运行时加环境变量即可自动切无头模式：
HKEX_HEADLESS=1 python hkex_scraper.py # macOS / Linux set HKEX_HEADLESS=1 && python hkex_scraper.py # Windows CMD $env:HKEX_HEADLESS=1; python hkex_scraper.py # Windows PowerShell
无头模式下脚本也会自动跳过"按回车关闭浏览器"的等待，适合全自动运行。
-
网络：需要能正常访问
hkexnews.hk。港交所有反爬，脚本已内置等待，请勿高频运行。
- 行情接口非官方：脚本用 Yahoo Finance 的公开 chart 接口（
query1.finance.yahoo.com） 补已上市公司的股价/首日涨跌幅。这是非官方接口，可能不稳定或被限流；抓不到时相关字段留空， 不影响主流程。可在脚本里把ENABLE_STOCK_LOOKUP = False关掉。 - PDF 指标是"粗提"：脚本用正则从招股文件里粗提毛利率、CAGR、发行价等字段。不同招股书写法 差异很大，抓不到就留空，不能替代人工阅读原文。
- 成功率区间是经验判断：框架里的成功率口径来自一线经验总结，仅供参考，不构成任何投资建议。
- 页面结构会变：港交所页面若改版，抓取选择器可能需要相应调整。
本项目仅用于信息整理与方法论交流，不构成投资建议、法律意见或任何形式的推荐。 所有判断口径均为经验性总结，港股 IPO 结果受监管、市场、公司基本面等多重因素影响。 使用者应自行核实公开信息、独立判断，并自行承担使用本工具的一切后果。
数据来源为港交所等公开渠道，请遵守相关网站的使用条款与 robots 规则，合理控制访问频率。