From 4ffd6a08a12f6250b849f473a0881f2b8e7f3d3f Mon Sep 17 00:00:00 2001
From: sevencat2004 <187867736+sevencat2004@users.noreply.github.com>
Date: Wed, 27 May 2026 22:53:09 +0800
Subject: [PATCH] docs: add issue reporting guide

---
 README.md | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8a32bc4..057dd35 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,20 @@
-This is open issue repo!~
\ No newline at end of file
+This is open issue repo!~
+
+## Issue guide
+
+Use small, reviewable issues so contributors can understand the request quickly.
+
+For bug reports, include:
+
+- What happened
+- What you expected to happen
+- Steps to reproduce
+- Screenshots or logs when available
+
+For feature requests, include:
+
+- The user problem
+- The expected behavior
+- Clear acceptance criteria
+
+Pull requests should reference the related issue in the description.