docs: make README bilingual with zh-first structure

This commit is contained in:
2026-04-24 13:50:14 +08:00
parent 111cf27634
commit cb66ca8b72

View File

@@ -1,8 +1,91 @@
# Approved Plan Continuity Hard Gate
A focused extraction of recent OpenClaw workflow hardening work around:
- approved-plan continuity hard-gate
- dispatch receipt binding
- anti-blackhole / completion-delivery watchdog groundwork
## 中文說明
This repo was exported from a larger workspace to isolate the relevant implementation and tests.
這個 repo 是從較大的 OpenClaw workspace 中抽出的焦點工作流成果,主題是:
- **approved plan continuity hard-gate**
- **dispatch receipt binding**
- **anti-blackhole / completion-delivery watchdog groundwork**
目標是避免這種情況再次發生:
- 任務已完成
- 下一步其實已經明確
- 但沒有真的 dispatch 下一個 task
- 最後流程卻還是收尾,造成 **auto-next break / continuity failure**
目前 repo 內主要包含:
- continuity gate 規則與測試
- dispatch receipt binding 骨架與最小 receipt writer
- anti-blackhole / delivery watchdog 的前置設計與基礎腳本
- 相關 runbook / plan / state shape
### 目前重點
這個 repo 目前著重於把以下能力拆成可測試、可逐步落地的切片:
1. **continuity hard-gate**
- approved plan 內 task 完成後,若沒有 next dispatch receipt且狀態又不是 `waiting_user` / `blocked` / `pending_verification`,則不應允許正常收尾。
2. **dispatch receipt binding**
- 不只知道 planner 推導出下一步,而是要真的留下可驗證的 dispatch receipt。
3. **anti-blackhole groundwork**
- 為後續的 subagent completion-delivery watchdog 提供 receipt / state / failure mode 基礎。
### 說明
這是一個**聚焦匯出 repo**,不是整個原 workspace 的完整鏡像。目的是先把相關修補線獨立出來,方便:
- 追蹤修補進度
- 做 code review
- 補 README / runbook / 測試
- 後續再整合回主要流程
---
## English Description
This repository is a focused export from a larger OpenClaw workspace. It captures a workflow hardening workstream around:
- **approved plan continuity hard-gate**
- **dispatch receipt binding**
- **anti-blackhole / completion-delivery watchdog groundwork**
The goal is to prevent this failure mode:
- a task is completed,
- the next step is already known,
- but the next task is never actually dispatched,
- and the flow still closes out as if continuity were preserved.
The repository currently includes:
- continuity gate rules and tests
- dispatch receipt binding skeletons and a minimal receipt writer
- groundwork for anti-blackhole / delivery-watchdog handling
- related runbooks, plans, and state-shape definitions
### Current Focus
This repo is currently structured to make the following capabilities testable and incrementally adoptable:
1. **Continuity hard-gate**
- If a task inside an approved plan is marked complete, and there is no next dispatch receipt, and the closure state is not `waiting_user`, `blocked`, or `pending_verification`, the flow should not be allowed to close normally.
2. **Dispatch receipt binding**
- It is not enough for the planner to derive a next action; that action must also produce verifiable dispatch evidence.
3. **Anti-blackhole groundwork**
- The repo also lays groundwork for future subagent completion-delivery watchdog logic through receipt/state/failure-mode definitions.
### Note
This is a **focused export repository**, not a full mirror of the original workspace. The intent is to isolate the relevant hardening work so it can be:
- reviewed more easily
- iterated independently
- documented clearly
- integrated back into the main flow later