docs: require bug history workflow

tests/test_bug_history_workflow.py

@@ -0,0 +1,24 @@
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+AGENTS = ROOT / "AGENTS.md"
+BUG_HISTORY = ROOT / "docs" / "BUG_HISTORY.md"
+
+
+def test_bug_history_exists_with_required_entry_contract() -> None:
+    text = BUG_HISTORY.read_text(encoding="utf-8")
+
+    assert "## 使用流程" in text
+    assert "## 新记录模板" in text
+    for field in ("用户现象", "触发条件", "根因", "修复", "验证", "防复发", "复发自"):
+        assert field in text
+
+
+def test_agents_requires_read_before_and_update_after_bug_work() -> None:
+    text = AGENTS.read_text(encoding="utf-8")
+
+    assert "docs/BUG_HISTORY.md" in text
+    assert "开始诊断前必须完整读取并搜索" in text
+    assert "必须在同一变更中更新" in text
+    assert "严禁写入" in text