T Push

Push with Local CI

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

Fixed Flow

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

在生成 commit message 和调用脚本前，AI 必须清理本次变更源码文件中的明显低价值注释。清理范围只限本次变更文件，不做全仓历史清理。

应删除的低价值注释包括：

• 仅对应 .ai/design、.ai/task 章节名、item 名、步骤名的注释。
• 复述函数名、变量名、类型名、文件名或目录职责的注释。
• 逐行解释显而易见语句的注释，例如“设置值”“调用接口”“返回结果”。
• 标记开发阶段、迁移步骤、临时分层、实现顺序，但对运行时代码没有帮助的注释。
• 与当前实现不再一致、语义空泛、只表达“这里处理逻辑”的注释。

必须保留的注释包括：

• 解释业务规则、领域不变量、权限/安全边界、兼容性原因、外部协议约束的注释。
• 解释复杂算法、非直观性能取舍、并发/事务/生命周期风险的注释。
• 有明确责任人的 TODO/FIXME，或指向具体缺陷、后续任务、版本约束的注释。
• 测试追溯、license、lint/coverage 指令、生成代码标记、公共 API 文档注释。

清理后重新查看必要的 git diff，确认 diff 中剩余注释有实际信息增量，再总结本次变更并生成简洁 commit message。commit message 必须来自 AI 对清理后实际变更的总结，不能由脚本根据目录名自动猜测。

然后使用脚本完成验证、提交和推送：

uv run ${CLAUDE_PLUGIN_ROOT}/scripts/push.py --message ""

脚本负责：

• 检查 git status --short，无变更时停止。
• 读取 tracked、staged、unstaged 和 untracked 文件，检测 backend、frontend、demo 变更范围。
• 为受影响区域并发运行本地 CI；同一区域内部保持顺序执行。
• 使用 AI 传入的 --message 作为 commit message；执行提交时没有 --message 则停止。
• CI 全部通过后执行 git add -A、git commit 和 git push。

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 作为最终校验（--fix 遇到无法自动修复的 denied lint 时仍会以 0 退出，仅靠 --fix 无法拦截，需此步骤才能真正强制 -D warnings）。若该校验报错，AI 应根据错误信息修复代码后重新运行脚本，直到通过。
• Frontend 变更：执行 npm run lint、npm run format:check、npm run type-check、npm run test:run；其中 format:check 和 test:run 不存在时跳过。
• Demo 变更：执行 npm run lint 和 npm run type-check。
• 无 backend/frontend/demo 变更时跳过本地 CI，直接进入 commit/push。

Useful Script Options

uv run ${CLAUDE_PLUGIN_ROOT}/scripts/push.py --dry-run
uv run ${CLAUDE_PLUGIN_ROOT}/scripts/push.py --checks-only
uv run ${CLAUDE_PLUGIN_ROOT}/scripts/push.py --message "chore: update workflow docs"
uv run ${CLAUDE_PLUGIN_ROOT}/scripts/push.py --message "chore: update workflow docs" --no-push

Failure

• 任一 CI 步骤失败：脚本停止，不执行 commit/push，并输出失败区域和步骤。
• 执行提交但没有传入 --message：脚本停止，提示先由 AI 基于 diff 生成 commit message。
• commit 失败：脚本停止，不执行 push。
• push 失败：脚本输出错误，并提示本地 commit 已保留。

Success Criteria

• 受影响区域的 CI 检查全部通过，或无受影响区域而跳过。
• 代码已 commit 并 push 到远程。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: timzaak
• Source: timzaak/web-dev-skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.