timzaak/web-dev-skills/t-push

Push with Local CI

运行时边界统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md

提交前输入门禁、commit message 格式、调用模式和中断恢复统一参考 ${CLAUDE_PLUGIN_ROOT}/protocols/push-execution-contract.md；执行脚本前读取。

Fixed Flow

先由 AI 读取 git status --short 和必要的 git diff，识别本次变更涉及的源码文件。

在生成 commit message 和调用脚本前，AI 必须清理本次变更源码文件中的注释。先运行预筛脚本取得候选清单：

uv run ${CLAUDE_PLUGIN_ROOT}/scripts/comment-audit.py

脚本只读不改，从本次未提交变更输出 JSON 候选：remove-candidate（命中禁止条款，含变更文件内 diff 未触及的存量违规，scope=existing）默认删除，除非能指认"必须保留"类别；review-candidate（注释密度超标文件的注释）与其余 diff 新增注释一样，逐条对照"必须保留"类别，命中不了就删除。判定标准以 ${CLAUDE_PLUGIN_ROOT}/protocols/code-comment-contract.md 为准，清理范围只限本次变更文件，不做全仓历史清理。

清理后重新查看必要的 git diff，逐条确认剩余的 diff 新增注释都能指认所属的保留类别（含未被脚本列出的新增注释），再总结本次变更并生成简洁 commit message。commit message 必须来自 AI 对清理后实际变更的总结，不能由脚本根据目录名自动猜测。

然后为本次 /t-push 执行生成一个新的 session id（例如 YYYYMMDD-HHMMSS 或短 UUID），并调用脚本：

uv run ${CLAUDE_PLUGIN_ROOT}/scripts/push.py --ci-session "<本次 t-push session id>" --message "<AI 生成的 commit message>"

session 规则只说一次：同一次 /t-push 执行内（含 CI 失败后 AI 修复重跑）复用同一 session id；新的 /t-push 执行必须生成新 session id，避免复用上一次的区域通过缓存。

脚本负责：检测 backend/frontend/demo 变更范围并为受影响区域并发运行本地 CI（区域 CI 内容见下节）；按 session 记录每个区域通过 CI 时的 diff 指纹，重跑时已通过且 diff 未变的区域直接跳过；CI 全部通过后执行 git add -A、git commit 和推送目标分支。无 diff 时仍核对并补推现有 commit。未提交变更需要 --message。

CI Rules

• Backend 变更：cargo clippy --fix --allow-dirty --allow-staged --all-targets --all-features -- -D warnings、cargo fmt --all，再以不带 --fix 的 cargo clippy --all-targets --all-features -- -D warnings 终验。
• Frontend 变更：npm run lint、npm run format:check（不存在时跳过）、npm run type-check。
• Demo 变更：npm run lint 和 npm run type-check。
• Shopify 变更（项目根存在 shopify.app.toml 时，除 demo/ 外的全部变更）：按 ${CLAUDE_PLUGIN_ROOT}/guides/shopify/validation.md 的 push 门禁执行，类型检查兼容 typecheck / type-check 且不能缺失；存在 Shopify 扩展配置时必须覆盖扩展构建。
• 无 backend/frontend/demo/shopify 变更时跳过本地 CI，直接进入 commit/push。

--force-checks 参数可忽略 session 缓存，强制重跑本次 diff 涉及的所有区域 CI。

Failure

• 任一 CI 步骤失败：脚本停止且不 commit/push，并输出失败区域和步骤；AI 根据错误信息修复代码后，用同一 session id 重新运行脚本，直到通过。
• commit/push 失败：脚本停止并报告错误；按共享契约用同一 session 恢复本地 commit 并确认远端，不生成重复提交；代码变化时先重新验证和验收。