From 406e0dee6a8e714acd43f333045456f41925bf3e Mon Sep 17 00:00:00 2001
From: JulyanXu <1581085037@qq.com>
Date: Wed, 20 May 2026 14:16:33 +0800
Subject: [PATCH] docs: clarify contributor guidance

---
 .github/pull_request_template.md | 2 +-
 README.md                        | 2 ++
 README.zh.md                     | 2 ++
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 2ba1ecadc..61013c316 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -9,7 +9,7 @@
 ## Test Plan
 <!-- Describe how this change was verified. -->
 - [ ] Unit tests pass
-- [ ] Manual local verification confirms the `lark xxx` command works as expected
+- [ ] Manual local verification confirms the `lark-cli <domain> <command>` flow works as expected
 
 ## Related Issues
 <!-- Link related issues. Use Closes/Fixes to close them automatically. -->
diff --git a/README.md b/README.md
index 4902dcdfa..43ddde105 100644
--- a/README.md
+++ b/README.md
@@ -278,6 +278,8 @@ Community contributions are welcome! If you find a bug or have feature suggestio
 
 For major changes, we recommend discussing with us first via an Issue.
 
+Before opening a PR, see [AGENTS.md](./AGENTS.md) for the local build, test, and PR checklist used by contributors and AI agents.
+
 ## License
 
 This project is licensed under the **MIT License**.
diff --git a/README.zh.md b/README.zh.md
index b9869090b..1d6ef5bd5 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -279,6 +279,8 @@ lark-cli schema im.messages.delete
 
 对于较大的改动，建议先通过 Issue 与我们讨论。
 
+提交 PR 前，请先阅读 [AGENTS.md](./AGENTS.md)，其中列出了贡献者和 AI Agent 使用的本地构建、测试和 PR 检查清单。
+
 ## 许可证
 
 本项目基于 **MIT 许可证** 开源。