From 7784afa12b858c2aced2547b0ea520b2ca8da2be Mon Sep 17 00:00:00 2001
From: X-iZhang <zacharyzhang2022@gmail.com>
Date: Wed, 11 Mar 2026 00:34:37 +0000
Subject: [PATCH] feat: add user prompt functionality to agent for
 clarification questions in README files

---
 README.md       | 15 +++++++++++++++
 README.zh-CN.md | 15 +++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/README.md b/README.md
index 274afdf..2cf1171 100644
--- a/README.md
+++ b/README.md
@@ -251,6 +251,21 @@ During a session you can also reply **3** (Approve all) at any approval prompt t
 
 </details>
 
+<details>
+<summary>Agent Questions (Ask User)</summary>
+
+The agent can proactively ask you questions when it needs clarification (e.g., dataset choice, experiment direction). This is enabled by default. To disable:
+
+```bash
+# Persistent: set in config
+EvoSci config set enable_ask_user false
+
+# Re-enable
+EvoSci config set enable_ask_user true
+```
+
+</details>
+
 <details>
 <summary>In-session commands</summary>
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index dc026b7..bd8f56f 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -262,6 +262,21 @@ EvoSci config set shell_allow_list "python,pip,pytest,ruff,git"
 
 </details>
 
+<details>
+<summary>智能体提问（Ask User）</summary>
+
+智能体可以在需要澄清时主动向你提问（例如数据集选择、实验方向等）。此功能默认开启。关闭方式：
+
+```bash
+# 持久化：写入配置
+EvoSci config set enable_ask_user false
+
+# 重新开启
+EvoSci config set enable_ask_user true
+```
+
+</details>
+
 <details>
 <summary>会话内命令</summary>