From 79401a27a3379704fa5165fb069177d356d96fdf Mon Sep 17 00:00:00 2001
From: Eve <eve@local>
Date: Wed, 22 Apr 2026 15:16:50 +0800
Subject: [PATCH] Add launch template for silent long-tasks

---
 .../silent-long-task-launch-template.md       | 69 +++++++++++++++++++
 .../long-task-governor/checkpoint-template.md |  6 ++
 2 files changed, 75 insertions(+)
 create mode 100644 docs/runbooks/silent-long-task-launch-template.md

diff --git a/docs/runbooks/silent-long-task-launch-template.md b/docs/runbooks/silent-long-task-launch-template.md
new file mode 100644
index 0000000..2b3363f
--- /dev/null
+++ b/docs/runbooks/silent-long-task-launch-template.md
@@ -0,0 +1,69 @@
+# Silent Long-Task Launch Template
+
+Use this template when starting any silent long-task.
+
+## Launch record
+
+- **task_name**:
+- **why_silent**:
+- **current_status**: `active | waiting_user | blocked | paused | pending_verification`
+- **current_step**:
+- **next_step**:
+- **expected_evidence**:
+- **first_forced_checkpoint_trigger**:
+- **if_unfinished_report**:
+- **if_no_new_evidence**: `paused | blocked`
+- **externalized_trigger**:
+- **final_handoff_path**:
+
+## Required interpretation
+
+### `why_silent`
+Explain why the task will not naturally produce an immediate next user-visible reply.
+
+### `expected_evidence`
+State what would count as real progress:
+- file change
+- verification output
+- conclusion / decision
+- blocker change
+- external result
+
+### `first_forced_checkpoint_trigger`
+Examples:
+- in 20 minutes
+- after subagent survey returns
+- after first debugging pass
+- when verification round 1 completes
+
+### `if_unfinished_report`
+Must explicitly say what the assistant will report if the task is not done yet.
+
+### `externalized_trigger`
+Examples:
+- cron reminder in 20 minutes
+- forced checkpoint scheduled externally
+- non-silent mode (if no external trigger can safely be bound, the task should not actually launch as silent)
+
+### `final_handoff_path`
+Examples:
+- Telegram button-path
+- direct conclusion if no owner decision needed
+
+## Telegram-safe example
+
+- **task_name**: Research OpenClawGovernor concepts
+- **why_silent**: I need time to read and compare materials before a meaningful summary exists.
+- **current_status**: `active`
+- **current_step**: reading README and architecture notes
+- **next_step**: extract reusable governance ideas
+- **expected_evidence**: concrete findings, comparison points, conclusions
+- **first_forced_checkpoint_trigger**: after initial source review completes
+- **if_unfinished_report**: report what has been verified so far, what remains unclear, and the next report condition
+- **if_no_new_evidence**: `paused`
+- **externalized_trigger**: cron reminder / forced checkpoint
+- **final_handoff_path**: Telegram button-path only if owner judgement is needed; otherwise direct summary
+
+## Rule of use
+
+If you cannot fill this template honestly, the task is probably not ready to launch in silent mode.
diff --git a/skills/long-task-governor/checkpoint-template.md b/skills/long-task-governor/checkpoint-template.md
index 70cae64..6dd6f20 100644
--- a/skills/long-task-governor/checkpoint-template.md
+++ b/skills/long-task-governor/checkpoint-template.md
@@ -15,3 +15,9 @@
 ## 是否需要您介入
 - 是 / 否
 - 若需要：
+
+## Silent long-task note（若適用）
+- externalized trigger:
+- next forced checkpoint:
+- if still unfinished, will report:
+- if no new evidence, downgrade to: