any2card-github-hardblue-workflow

name	any2card-github-hardblue-workflow
description	在 any2card 已完成发布前视觉门禁并自动发布后，审计信息卡改动、提交到 GitHub、推送并核验远程交付。不得绕过视觉门禁。

Any2Card GitHub Hardblue Delivery Workflow

本 Skill 只负责 GitHub 交付。视觉审查、preview 管理、修复循环和自动发布由 any2card 负责；本 Skill 不能自行制造、放宽或绕过门禁。

已知缺陷与规避（2026-07-18 新增）

GitHub Pages 相对路径陷阱（高频）：HTML 文件位于 docs/<slug>.html，CSS 中 ../assets/img/... 相对路径在 GitHub Pages 解析时会 404（Pages 对 docs/ 下文件的相对路径计算与 CDN 根不同）。必须用绝对 URL：https://<user>.github.io/<repo>/assets/img/<slug>/<file>。验证方法：CDN 直链 200 ≠ HTML 内相对引用 200——两者都要验证。

hardblue/redswiss CSS 无响应式断点（模板级缺陷）：120+ 个卡片使用了标准 .grid-3 三列布局但 CSS 中无 @media (max-width:720px) 将其折叠为单列。修复需批量 Python 注入，并 commit 到 origin/main 后 CDN 才生效。

模板 CSS 嵌在每个 HTML 里：hardblue/redswiss 主题的 CSS 是每个 HTML 文件内嵌的，没有集中模板文件。这意味着任何 CSS 修复都要用批量 Python 扫描+注入，而非修改一个模板文件。

0. Prerequisites

开始前必须确认：

1. 可以访问目标 GitHub 仓库；
2. 已知目标卡片文件路径；
3. 已知本次是创建还是更新线上卡片；
4. 未经明确要求，不修改仓库级基础设施；
5. 不提交临时文件、调试产物、凭证、缓存或截图证据；
6. any2card 已为当前卡片与当前文件版本生成有效视觉门禁凭证；
7. 凭证记录 preview 页面身份验证，以及桌面 1440×900 和移动 390×844 的 web-visual-acceptance 结果；
8. 凭证缺失、过期、对象不符、审查后文件变动，或任一端仍有 critical/major 时，不得 commit、push、release 或以其他方式发布。必须返回 any2card Step 5，不能请求或假设绕过。

1. Responsibility boundary

• any2card：创建卡片、复用/按需启动长期 preview、身份校验、双视口门禁、最多四轮定向修复、自动发布和生成凭证。
• 本 Skill：验证凭证、审计仓库变更、commit、push、远程提交和线上链接核验。
• 主题 Skill：仅设计规范。
• infocard-pub preview：仅本地发布前预览，不等于线上发布。

线上发布成功不代表任务完成；必须继续完成 GitHub 交付与远程核验。

2. Delivery sequence

1. 识别目标仓库、分支、卡片路径与工作树状态；先 git fetch，检查本地分支相对 origin/<branch> 的 ahead/behind。若本地 behind，先同步，禁止将它作为发布源或用其本地索引判定线上状态。
2. 验证 any2card 门禁凭证：卡片 slug/路径、当前文件版本、preview 身份、桌面/移动证据、最终轮次、通过规则和线上 URL。
3. 确认两端均无 critical/major；凭证通过规则只能是正常的“评分+严重度”通过，或第 4 轮的“仅严重度”通过。
4. 在 push 前执行本地卡片门禁：构建与索引校验、卡片内容、引用资源、meta 时间戳、图片及移动端浏览器 smoke（仅对本次变更卡做增量检查即可）。同时确认索引声明的卡片数与实际条目数一致。
5. 复用 any2card 自动发布已产生的线上 URL；不要在本 Skill 执行第二套独立发布命令。
6. 检查 Git status，仅保留目标卡片及明确允许的源文件变更。
7. 审阅 diff，禁止把门禁凭证、截图、缓存、调试或无关文件提交。
8. commit 并 push。
9. 用远端 commit SHA 或 slug完成发布后核验：确认 Actions 成功、部署卡 URL 为 2xx、部署 _index.yaml 含对应 slug/path。发布后校验不得因为本地缺少 sidecar meta 而失败；这种情况应标为“本地未同步”，并改用远端 ref/部署索引完成核验。
10. 如果有审计，保存可追溯的机器可读报告（card slug、commit SHA、检查项、结论、证据路径）；单独的 audit commit message 不构成验收证据。
11. 只有以上全部成功后才报告交付完成。

详细的完整性模式与故障解释见 references/publish-integrity.md。

批量 CSS 修复（.grid-3 移动端断点注入）见 references/grid-3-mobile-fix.md。

3. Gate-failure handling

• 凭证无效：停止 GitHub 交付，返回 any2card Step 5。
• 发布受阻：不得提交为“已发布”；可在本地保留修复工作，但报告阻断的 critical/major。
• push 失败或线上 URL 不可访问：报告交付失败，保留门禁证据，不得伪称发布完成。

4. Final report

报告至少包含：仓库与分支、commit SHA、线上 URL 及核验结果、门禁轮次、桌面/移动分数、遗留 minor、是否第 4 轮低分放行，以及任何未完成项。