PRO Portfolio DEV
输入GitHub用户，输出在线作品集。脚本负责获取、构建、检查和发布；你只需要做它们做不到的事：挑选项目并撰写诚实的、有冲击力的文案。
路径相对于本技能文件夹。工作区请使用一个临时文件夹，例如 portfolio/。
1 · 获取（仅真实数据）
python3 scripts/fetch.py USER --out portfolio/repos.json（2次公共API调用，无需令牌）。
它会打印出排名靠前的仓库。这些是你唯一可以使用的数据；不得虚构star数、用户数或任何结果。
2 · 规划（先提问，然后写入 portfolio/plan.json）
在一次消息中提问，并附带默认值，用户只需回复“go”即可接受：
- 谁和为谁： 姓名、角色、目标受众（招聘人员、客户、同行）。默认值：GitHub名称和简介。
- 项目： 推荐4-9个最强的（star数、近期推送、有主页、描述清晰的项目）；由用户选择。
- 技能和经验（可选，用于搜索）以及联系方式。
- 站点位置：
USER.github.io（根目录）或某个仓库的docs/文件夹。URL必须是最终确定的值。
然后写入 plan.json（模式及文案规则见 references/plan.md）。文案规则简述：标题≤8个单词，标语说明内容+受众，每个项目配一句要点（突出价值，而非技术栈），可选的 proof 行引用该仓库README或GitHub数据中的数字，不得编造。
语言： 10种语言的UI字符串已内置在 scripts/ui.json 中。如需翻译用户自己的文案，请添加 plan.t.<lang>，按意义翻译，像母语者一样自然表达，而非逐字翻译（参见 references/plan.md 中的“翻译”部分）。然后以母语读者的身份通读每个语言版本一遍，修正任何生硬的表达。
3 · 构建和检查
python3 scripts/build.py portfolio/repos.json portfolio/plan.json --out portfolio/site
python3 scripts/check.py portfolio/site
check.py 必须输出 PASS。在浏览器中打开 portfolio/site/index.html 查看效果：尝试输入有拼写错误的搜索词，切换至阿拉伯语（从右到左）和深色主题。
4 · 发布（对外发布前需征得同意）
向用户展示页面和目标地址，获得肯定答复后：
bash scripts/publish.sh portfolio/site REPO_CLONE URL [--folder root|docs] --yes
该脚本会提交、推送、按需启用Pages，并轮询直到新版本上线，输出 LIVE … in N s。
5 · 测量并报告
在≤4行内报告：在线URL、LIVE 时间、check.py 分数，以及来自 PageSpeed Insights（pagespeed.web.dev，免费）或本地安装的 lighthouse 的 Lighthouse SEO/可访问性/性能评分。
完成条件
check.py对构建的网站输出PASS。- 页面上的每个项目都是用户的真实仓库，页面上的每个数字都来源于GitHub数据或README。
- 在线URL返回新的构建版本（
publish.sh输出了LIVE），或用户选择不发布。
禁止事项
- 不得虚构项目、指标、雇主或推荐语。如有疑问，应向用户提问。
- 未经用户同意，不得推送、发布或启用Pages。
- 不得添加跟踪器、分析工具、Cookie或外部脚本。页面不发起任何第三方请求。
- 不得覆盖现有网站而不展示变更内容（不带
--yes的publish.sh为试运行）。