Add launch template for silent long-tasks
This commit is contained in:
69
docs/runbooks/silent-long-task-launch-template.md
Normal file
69
docs/runbooks/silent-long-task-launch-template.md
Normal file
@@ -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.
|
||||||
@@ -15,3 +15,9 @@
|
|||||||
## 是否需要您介入
|
## 是否需要您介入
|
||||||
- 是 / 否
|
- 是 / 否
|
||||||
- 若需要:
|
- 若需要:
|
||||||
|
|
||||||
|
## Silent long-task note(若適用)
|
||||||
|
- externalized trigger:
|
||||||
|
- next forced checkpoint:
|
||||||
|
- if still unfinished, will report:
|
||||||
|
- if no new evidence, downgrade to:
|
||||||
|
|||||||
Reference in New Issue
Block a user