support explicit [keys: ...] resource hints for parallel autonomy conflict control

README.md

@@ -35,6 +35,14 @@
 
 这些优化提升了高并发场景下的稳定性、可观测性与可维护性。
 
+### 并行任务冲突控制（Autonomy）
+
+支持基于 `resource_keys` 的锁调度。任务可在内容中显式声明资源键，提升并行判冲突精度：
+
+- 示例：`[keys: repo:clawgo, file:pkg/agent/loop.go, branch:main] 修复对话流程`
+- 未显式声明时，系统会从任务文本自动推断资源键。
+- 冲突任务进入 `resource_lock` 等待，默认 30 秒后重试抢锁，并带公平加权（等待越久优先级越高）。
+
 ## 🏁 快速开始
 
 1. 初始化配置与工作区