diff --git a/Agent.md b/Agent.md
index a68aea23..06c0ae44 100644
--- a/Agent.md
+++ b/Agent.md
@@ -96,6 +96,7 @@ pkill -f "emrg.server"; rm -f ~/.emrg/emrgd.port; python -m emrg
 Python: `uv run pytest tests/ -v` (495) — import check: `uv run python -c "from emrg.client.app import run_client"`
 GUI: `cd emrg/gui && npm test` (88: 22 daemon_client + 22 app-commands + 19 renderer smoke + 15 i18n + 7 integration + 3 commands) — syntax: `node --check main.js preload.js daemon_client.js renderer/js/*.js`
 CI: `uv run pytest` + GUI tests + **actionlint workflow lint** (`rhysd/actionlint@v1.7.12` gate, #444 — workflow 解析错误在 PR CI 即失败，如 `if:` secrets 上下文)
+Re-trigger: `scripts/re-trigger-ci.sh [branch]` (workflow_dispatch, #527 — 替代空 commit 重触发：Actions outage 会整段丢弃 push 事件，dispatch 走 API 路径不受影响)
 
 ## Configuration
 
diff --git a/scripts/re-trigger-ci.sh b/scripts/re-trigger-ci.sh
new file mode 100755
index 00000000..83481557
--- /dev/null
+++ b/scripts/re-trigger-ci.sh
@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Re-trigger the Test workflow without an empty commit (PR #527).
+#
+# GitHub Actions outages can drop push events entirely (runs never created,
+# check-runs empty) — empty-commit re-triggers depend on the same broken
+# push-event pipeline and also pollute git history. workflow_dispatch is
+# API-triggered and bypasses the push-event pipeline entirely.
+#
+# Usage: scripts/re-trigger-ci.sh [branch]     (default: current branch)
+#   branch: a branch name or tag; use 'master' to verify master after merges.
+set -euo pipefail
+
+branch="${1:-$(git rev-parse --abbrev-ref HEAD)}"
+echo "Dispatching Test workflow on branch: ${branch}"
+gh workflow run test.yml --ref "${branch}"
+echo "Dispatched. Watch: gh run list --workflow=test.yml"