t-push

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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 必须清理本次变更源码文件中的注释。先运行预筛脚本取得候选清单：

```bash
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），并调用脚本：

```bash
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 并确认远端，不生成重复提交；代码变化时先重新验证和验收。

From timzaak/web-dev-skills, Apache-2.0.

More from timzaak/web-dev-skills