From ced0e1b1114df984e1e293b1292ec72d88ad1e06 Mon Sep 17 00:00:00 2001
From: bobo <bobo.yang@merico.dev>
Date: Fri, 19 Jul 2024 14:12:34 +0800
Subject: [PATCH] update readme

---
 merico/aider/README.md                        | 32 ++++++----
 merico/aider/command.py                       |  1 -
 merico/aider/files/add/README.md              | 27 +++++----
 merico/aider/files/list/README.md             | 21 ++++---
 merico/aider/files/remove/README.md           | 27 +++++----
 merico/ask_issue/README.md                    | 33 +++++-----
 merico/comments/README.md                     | 36 +++++++++--
 merico/docstring/README.md                    | 60 +++++++++++++++++--
 merico/explain/README.md                      | 31 ++++++++--
 merico/fix/README.md                          | 39 ++++++++++--
 merico/github/code_task_summary/README.md     | 24 ++++++++
 merico/github/code_task_summary/command.yml   |  1 +
 merico/github/commit/README.md                | 23 +++++++
 merico/github/commit/command.yml              |  1 +
 merico/github/config/README.md                | 19 ++++++
 merico/github/config/command.yml              |  1 +
 merico/github/list_issue_tasks/README.md      | 19 ++++++
 merico/github/list_issue_tasks/command.yml    |  1 +
 merico/github/new_branch/README.md            | 21 +++++++
 merico/github/new_branch/command.yml          |  1 +
 merico/github/new_issue/README.md             | 21 +++++++
 merico/github/new_issue/command.yml           |  1 +
 merico/github/new_issue/from_task/README.md   |  0
 merico/github/new_issue/from_task/command.yml |  1 +
 merico/github/new_pr/README.md                | 22 +++++++
 merico/github/new_pr/command.yml              |  1 +
 merico/github/update_issue_tasks/README.md    | 22 +++++++
 merico/github/update_issue_tasks/command.yml  |  1 +
 merico/github/update_pr/README.md             | 20 +++++++
 merico/github/update_pr/command.yml           |  1 +
 merico/pr/improve/command.yml                 |  1 +
 merico/refactor/README.md                     | 38 ++++++++++--
 merico/unit_tests/README.md                   | 42 +++++++++++--
 33 files changed, 492 insertions(+), 97 deletions(-)
 create mode 100644 merico/github/code_task_summary/README.md
 create mode 100644 merico/github/commit/README.md
 create mode 100644 merico/github/config/README.md
 create mode 100644 merico/github/list_issue_tasks/README.md
 create mode 100644 merico/github/new_branch/README.md
 create mode 100644 merico/github/new_issue/README.md
 create mode 100644 merico/github/new_issue/from_task/README.md
 create mode 100644 merico/github/new_pr/README.md
 create mode 100644 merico/github/update_issue_tasks/README.md
 create mode 100644 merico/github/update_pr/README.md

diff --git a/merico/aider/README.md b/merico/aider/README.md
index 08a4c56..845f9f5 100644
--- a/merico/aider/README.md
+++ b/merico/aider/README.md
@@ -1,19 +1,25 @@
-### 操作指南
+### aider 操作指南
 
-aider工作流命令使用步骤如下：
+aider是一个AI辅助的代码编辑工具,可以根据自然语言指令修改代码。
 
-1. 确保已经使用 `/aider.files.add` 命令添加了需要处理的文件。
-2. 输入 `/aider <message>` 命令，其中 `<message>` 是你想要aider执行的任务描述。
-3. 等待aider生成建议的更改。
-4. 系统会自动显示每个文件的Diff View，你可以选择是否接受修改。
-5. 对于多个文件的更改，系统会在每个文件之后询问是否继续查看下一个文件的更改。
+用途:
+根据用户提供的指令,自动分析和修改已添加到aider中的代码文件。
 
-注意事项：
-- 如果没有添加任何文件到aider，命令将会提示你先使用 'aider.files.add' 命令添加文件。
-- 你可以使用 `aider.files.remove` 命令从aider中移除文件。
-- 所有的更改都会在IDE中以Diff View的形式展示，你可以在查看后决定是否应用这些更改。
+使用方法:
+1. 使用 `/aider.files.add` 命令添加需要处理的文件
+2. 输入 `/aider <message>` 命令,其中 `<message>` 是你想要aider执行的任务描述
+3. 等待aider生成建议的更改
+4. 在IDE中查看每个文件的Diff视图,选择是否接受修改
+5. 对于多个文件的更改,系统会在每个文件之后询问是否继续查看下一个文件的更改
 
-使用示例：
+注意事项:
+- 使用前必须先添加文件到aider,否则会提示使用 'aider.files.add' 命令
+- 可以使用 `aider.files.remove` 命令从aider中移除文件
+- 所有更改都会在IDE中以Diff视图形式展示,你可以决定是否应用这些更改
+- aider使用OpenAI的API,请确保已正确设置API密钥
+
+示例:
 /aider 重构这段代码以提高性能
 
-这个命令会让aider分析当前添加的文件，并提供重构建议以提高代码性能。
\ No newline at end of file
+额外信息:
+aider支持多种编程语言,可以执行代码重构、bug修复、性能优化等任务。它会分析当前添加的所有文件,并提供整体的改进建议。
\ No newline at end of file
diff --git a/merico/aider/command.py b/merico/aider/command.py
index 602aabe..01f8f45 100644
--- a/merico/aider/command.py
+++ b/merico/aider/command.py
@@ -201,7 +201,6 @@ def main():
             button.render()
 
             idx = button.clicked
-            print("click button:", idx)
             if idx == 0:
                 continue
             else:
diff --git a/merico/aider/files/add/README.md b/merico/aider/files/add/README.md
index b23c19e..4fa9987 100644
--- a/merico/aider/files/add/README.md
+++ b/merico/aider/files/add/README.md
@@ -1,20 +1,23 @@
 ### aider.files.add
 
-添加文件到aider处理列表中。
+这个命令用于将文件添加到aider的处理列表中。
 
-用法：
+用途:
+添加指定文件到aider,使其包含在后续的aider操作中。
+
+使用方法:
 /aider.files.add <file_path>
 
-参数：
-- <file_path>: 要添加的文件路径（必需）
+参数:
+- <file_path>: 要添加的文件路径(必需)
 
-描述：
-这个命令将指定的文件添加到aider的处理列表中。添加后，该文件将被包含在后续的aider操作中。
+注意事项:
+- 文件路径必须是有效的格式
+- 已存在于列表中的文件不会重复添加
+- 成功添加后会显示当前的aider文件列表
 
-注意：
-- 文件路径必须是有效的格式。
-- 如果文件已经在列表中，它不会被重复添加。
-- 添加成功后，会显示当前aider文件列表。
+示例:
+/aider.files.add src/main.py
 
-示例：
-/aider.files.add src/main.py
\ No newline at end of file
+额外信息:
+这个命令会将文件路径保存到.chat/.aider_files文件中。如果.chat目录不存在,会自动创建。
\ No newline at end of file
diff --git a/merico/aider/files/list/README.md b/merico/aider/files/list/README.md
index 9504d45..c09a167 100644
--- a/merico/aider/files/list/README.md
+++ b/merico/aider/files/list/README.md
@@ -1,16 +1,19 @@
 ### aider.files.list
 
-列出当前在aider处理列表中的所有文件。
+这个命令用于列出当前在aider处理列表中的所有文件。
 
-用法：
+用途:
+显示所有已添加到aider中的文件,提供当前aider正在处理的文件概览。
+
+使用方法:
 /aider.files.list
 
-描述：
-这个命令会显示所有已添加到aider处理列表中的文件。它提供了一个当前aider正在处理的文件的概览。
+注意事项:
+- 如果没有文件被添加到aider,会显示相应的提示消息
+- 文件列表按字母顺序排序显示
 
-注意：
-- 如果没有文件被添加到aider，会显示相应的消息。
-- 文件按字母顺序排序显示。
+示例:
+/aider.files.list
 
-示例：
-/aider.files.list
\ No newline at end of file
+额外信息:
+这个命令会读取.chat/.aider_files文件的内容来获取文件列表。如果该文件不存在,会提示尚未添加任何文件。
\ No newline at end of file
diff --git a/merico/aider/files/remove/README.md b/merico/aider/files/remove/README.md
index 2607e03..169130c 100644
--- a/merico/aider/files/remove/README.md
+++ b/merico/aider/files/remove/README.md
@@ -1,20 +1,23 @@
 ### aider.files.remove
 
-从aider处理列表中移除指定的文件。
+这个命令用于从aider处理列表中移除指定的文件。
 
-用法：
+用途:
+将指定文件从aider的处理列表中删除,使其不再包含在后续的aider操作中。
+
+使用方法:
 /aider.files.remove <file_path>
 
-参数：
-- <file_path>: 要移除的文件路径（必需）
+参数:
+- <file_path>: 要移除的文件路径(必需)
 
-描述：
-这个命令从aider的处理列表中移除指定的文件。移除后，该文件将不再被包含在后续的aider操作中。
+注意事项:
+- 文件路径必须是有效的格式
+- 如果指定的文件不在列表中,会显示相应的提示消息
+- 成功移除后会显示更新后的aider文件列表
 
-注意：
-- 文件路径必须是有效的格式。
-- 如果指定的文件不在列表中，会显示相应的消息。
-- 移除成功后，会显示更新后的aider文件列表。
+示例:
+/aider.files.remove src/main.py
 
-示例：
-/aider.files.remove src/main.py
\ No newline at end of file
+额外信息:
+这个命令会更新.chat/.aider_files文件,从中删除指定的文件路径。如果文件不存在于列表中,操作会安全退出。
\ No newline at end of file
diff --git a/merico/ask_issue/README.md b/merico/ask_issue/README.md
index 79e0560..2dd55bd 100644
--- a/merico/ask_issue/README.md
+++ b/merico/ask_issue/README.md
@@ -1,21 +1,24 @@
 ### ask_issue
 
-自动修复代码中的lint错误。
+自动修复代码中的 lint 错误。
 
-用法：
-/ask_issue
+#### 用途
+这个命令帮助开发者快速识别和修复代码中的 lint 错误。它利用 AI 分析选中的代码行，识别 lint 问题，并提供智能修复建议。
 
-描述：
-这个命令帮助开发者自动修复代码中的lint错误。它使用AI分析选中的代码行，识别lint问题，并提供修复建议。
+#### 使用方法
+1. 在 IDE 中选择包含 lint 错误的代码行。
+2. 运行命令：/ask_issue
+3. 命令会自动处理选中的代码和相关的 lint 诊断信息。
+4. AI 将生成问题解释和修复方案。
 
-步骤：
-1. 在IDE中选择包含lint错误的代码行。
-2. 运行 /ask_issue 命令。
-3. 命令会自动获取选中的代码、相关的lint诊断信息，并调用AI生成修复方案。
-4. AI会提供问题解释和修复后的代码片段。
+#### 注意事项
+- 运行命令前，确保已选择包含 lint 错误的具体代码行。
+- 命令优先处理 SonarLint 诊断的问题。
+- 只关注并修复选中行的 lint 错误，不会处理其他潜在问题。
+- AI 生成的修复方案包含问题解释和修改后的代码片段。
+- 修改后的代码以 Markdown 格式展示，包含足够的上下文信息以便定位。
 
-注意事项：
-- 确保在运行命令前已选择包含lint错误的代码行。
-- 命令会优先处理SonarLint诊断的问题。
-- AI生成的修复方案会包含问题解释和修改后的代码。
-- 修改后的代码会以Markdown格式展示，包含足够的上下文信息。
+#### 额外信息
+- 该命令使用 AI 模型进行分析和修复建议。
+- 修复建议会考虑代码的上下文，确保修改不会影响其他部分的正确性。
+- 对于复杂的 lint 错误，可能需要人工审核 AI 的修复建议。
\ No newline at end of file
diff --git a/merico/comments/README.md b/merico/comments/README.md
index 281480c..e6a7da5 100644
--- a/merico/comments/README.md
+++ b/merico/comments/README.md
@@ -1,11 +1,35 @@
 
-### 操作指南
+### comments
 
-生成行间注释，请按照如下步骤操作：
-1. 选中行间代码。
-2. 输入\/comments，回车发送；或右键点击**DevChat: Generate Comments**按钮。
-3. 开始生成行间注释，等待生成结束。
-4. 自动弹出Diff View，选择是否接受修改。
+这个命令用于自动为选中的代码块生成注释。
+
+#### 用途
+- 为选中的代码块快速添加解释性注释
+- 提高代码可读性和可维护性
+- 帮助开发者更好地理解代码逻辑
+
+#### 使用方法
+1. 在IDE中选中需要添加注释的代码块
+2. 执行以下命令之一：
+   - 输入 `/comments` 并回车
+
+#### 注意事项
+1. 确保在执行命令前已选中代码块
+2. 生成的注释会插入到相应的代码行之前
+3. 原有的注释会被保留
+4. 代码本身不会被修改，只会添加注释
+
+#### 操作流程
+1. 选中需要注释的代码块
+2. 执行comments命令
+3. 等待注释生成完成
+4. 自动弹出Diff View，您可以选择接受或拒绝修改
+
+
+额外信息
+注释的语言会根据当前IDE的语言设置自动调整
+对于中文环境，会生成中文注释
+该命令利用AI技术生成注释，可能需要一定的处理时间
 
 如图所示：
 
diff --git a/merico/docstring/README.md b/merico/docstring/README.md
index e3df884..4eab644 100644
--- a/merico/docstring/README.md
+++ b/merico/docstring/README.md
@@ -1,11 +1,59 @@
 
-### 操作指南
+### docstring
 
-生成函数注释，请按照如下步骤操作：
-1. 选中函数代码。
-2. 输入\/docstring，回车发送；或点击函数头部**docstring**按钮。
-3. 开始生成函数注释，等待生成结束。
-4. 自动弹出Diff View，选择是否接受修改。
+这个命令用于自动为选中的函数或方法生成文档字符串（docstring）。
+
+#### 用途
+- 快速为函数或方法添加标准格式的文档字符串
+- 提高代码的可读性和可维护性
+- 自动生成包含参数、返回值等信息的详细文档
+
+#### 使用方法
+1. 在IDE中选中需要添加文档字符串的函数或方法
+2. 执行以下命令之一：
+   - 输入 `/docstring` 并回车
+   - 点击函数头部的 **docstring** 按钮
+
+#### 操作流程
+1. 选中需要添加文档字符串的函数或方法
+2. 执行docstring命令
+3. 等待文档字符串生成完成
+4. 自动弹出Diff View，您可以选择接受或拒绝修改
+
+#### 注意事项
+1. 确保在执行命令前已选中完整的函数或方法
+2. 生成的文档字符串会插入到函数定义之后
+3. 文档字符串的格式会根据编程语言自动调整（如Python使用三引号，Java使用JavaDoc格式）
+4. 原有的文档字符串可能会被替换，请在Diff View中仔细检查
+
+#### 示例
+选中以下Python函数：
+```python
+def add(a, b):
+    return a + b
+```
+执行docstring命令后，可能生成如下文档字符串：
+```python
+def add(a, b):
+    """
+    将两个数相加。
+
+    参数:
+    a (int): 第一个加数
+    b (int): 第二个加数
+
+    返回:
+    int: 两个数的和
+    """
+    return a + b
+```
+
+
+额外信息:
+
+- 文档字符串的语言会根据当前IDE的语言设置自动调整
+- 对于中文环境，会生成中文文档字符串
+- 该命令利用AI技术生成文档字符串，可能需要一定的处理时间
 
 如图所示：
 
diff --git a/merico/explain/README.md b/merico/explain/README.md
index 0da1afc..2e73e3d 100644
--- a/merico/explain/README.md
+++ b/merico/explain/README.md
@@ -1,10 +1,31 @@
 
-### 操作指南
+### explain
+
+这个命令用于自动为选中的代码块生成解释。
+
+#### 用途
+- 快速获取选中代码块的详细解释
+- 帮助开发者理解复杂或不熟悉的代码逻辑
+- 提高代码审查和学习效率
+
+#### 使用方法
+1. 在IDE中选中需要解释的代码块
+2. 执行以下命令之一：
+   - 输入 `/explain` 并回车
+   - 右键点击选中的代码，选择 **DevChat: Generate Explain**
+
+#### 操作流程
+1. 选中需要解释的代码块
+2. 执行explain命令
+3. 等待代码解释生成完成
+4. 解释将直接显示在输出窗口中
+
+#### 注意事项
+1. 确保在执行命令前已选中需要解释的代码块
+2. 解释会考虑选中代码的上下文（可见的代码），但只会解释选中的部分
+3. 解释的详细程度可能因代码复杂度而异
+4. 对于非常长或复杂的代码块，生成解释可能需要较长时间
 
-生成代码解释，请按照如下步骤操作：
-1. 选中行间代码。
-2. 输入\/explain，回车发送；或右键点击**DevChat: Generate Explain**按钮。
-3. 开始生成代码解释，等待生成结束。
 
 如图所示：
 
diff --git a/merico/fix/README.md b/merico/fix/README.md
index fa42bb2..4aff4bb 100644
--- a/merico/fix/README.md
+++ b/merico/fix/README.md
@@ -1,11 +1,38 @@
 
-### 操作指南
+### fix
 
-使用代码纠错，请按照如下步骤操作：
-1. 选中行间代码。
-2. 输入\/fix，回车发送；或右键点击**DevChat: Fix this**按钮。
-3. 开始生成代码建议，等待生成结束。
-4. 自动弹出Diff View，选择是否接受修改。
+这个命令用于自动检测和修复选中代码块中的潜在错误。
+
+#### 用途
+- 快速识别和修复代码中的潜在bug
+- 提高代码质量和可靠性
+- 节省手动调试时间
+
+#### 使用方法
+1. 在IDE中选中需要检查和修复的代码块
+2. 执行以下命令之一：
+   - 输入 `/fix` 并回车
+   - 右键点击选中的代码，选择 **DevChat: Fix this**
+
+#### 操作流程
+1. 选中需要修复的代码块
+2. 执行fix命令
+3. 等待代码分析和修复建议生成完成
+4. 自动弹出Diff View，您可以选择接受或拒绝修改
+
+#### 注意事项
+1. 确保在执行命令前已选中需要修复的代码块
+2. 该命令只会修改选中的代码部分，不会影响其他代码
+3. 修复建议可能不总是100%准确，请仔细审查所有建议的更改
+4. 复杂的逻辑错误可能需要人工干预
+
+#### 额外信息
+- 修复建议的语言会根据当前IDE的语言设置自动调整（支持中英文）
+- 该命令利用AI技术生成修复建议，可能需要一定的处理时间
+- 除了修复代码，还会提供关于发现的问题和修复方法的解释
+
+#### 提示
+使用fix命令可以快速发现和修复简单的代码错误，但对于复杂的逻辑问题，建议结合人工审查和测试来确保代码的正确性。
 
 如图所示：
 
diff --git a/merico/github/code_task_summary/README.md b/merico/github/code_task_summary/README.md
new file mode 100644
index 0000000..cf0e062
--- /dev/null
+++ b/merico/github/code_task_summary/README.md
@@ -0,0 +1,24 @@
+### code_task_summary
+
+根据当前分支或指定的Issue,生成代码任务摘要。
+
+#### 用途
+- 自动生成简洁的代码任务描述
+- 帮助开发者快速理解任务要点
+- 用于更新项目配置或文档
+
+#### 使用方法
+执行命令: `/github.code_task_summary [issue_url]`
+
+- 如不提供issue_url,将基于当前分支名称提取Issue信息
+- 如提供issue_url,将直接使用该Issue的内容
+
+#### 操作流程
+1. 获取Issue信息
+2. 生成代码任务摘要
+3. 允许用户编辑摘要
+4. 更新项目配置文件
+
+#### 注意事项
+- 确保Git仓库配置正确
+- 需要有效的GitHub Token以访问API
\ No newline at end of file
diff --git a/merico/github/code_task_summary/command.yml b/merico/github/code_task_summary/command.yml
index c789a30..bb24dea 100644
--- a/merico/github/code_task_summary/command.yml
+++ b/merico/github/code_task_summary/command.yml
@@ -1,4 +1,5 @@
 description: 'Create new branch based current branch, and checkout new branch.'
 input: optional
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py "$input"
\ No newline at end of file
diff --git a/merico/github/commit/README.md b/merico/github/commit/README.md
new file mode 100644
index 0000000..e30941e
--- /dev/null
+++ b/merico/github/commit/README.md
@@ -0,0 +1,23 @@
+### commit
+
+自动生成提交信息并执行Git提交。
+
+#### 用途
+- 生成规范的提交信息
+- 简化Git提交流程
+- 保持提交历史的一致性
+
+#### 使用方法
+执行命令: `/github.commit [message]`
+
+- message: 可选的用户输入,用于辅助生成提交信息
+
+#### 操作流程
+1. 选择要提交的文件
+2. 生成提交信息
+3. 允许用户编辑提交信息
+4. 执行Git提交
+
+#### 注意事项
+- 确保已选择需要提交的文件
+- 生成的提交信息可能需要进一步修改以符合项目规范
\ No newline at end of file
diff --git a/merico/github/commit/command.yml b/merico/github/commit/command.yml
index 254511b..e31c28e 100644
--- a/merico/github/commit/command.yml
+++ b/merico/github/commit/command.yml
@@ -1,5 +1,6 @@
 description: 'Writes a well-formatted commit message for selected code changes and commits them via Git. Include an issue number if desired (e.g., input "/commit to close #12").'
 hint: to close Issue #issue_number
 input: optional
+help: README.md
 steps:
   - run: $devchat_python $command_path/commit.py "$input" "english"
\ No newline at end of file
diff --git a/merico/github/config/README.md b/merico/github/config/README.md
new file mode 100644
index 0000000..bb4bbfc
--- /dev/null
+++ b/merico/github/config/README.md
@@ -0,0 +1,19 @@
+### config
+
+配置GitHub工作流所需的设置。
+
+#### 用途
+- 设置Issue仓库URL
+- 配置GitHub Token
+
+#### 使用方法
+执行命令: `/github.config`
+
+#### 操作流程
+1. 输入Issue仓库URL(可选)
+2. 输入GitHub Token
+3. 保存配置信息
+
+#### 注意事项
+- GitHub Token应妥善保管,不要泄露
+- 配置信息将保存在本地文件中
\ No newline at end of file
diff --git a/merico/github/config/command.yml b/merico/github/config/command.yml
index dd639bf..827ab03 100644
--- a/merico/github/config/command.yml
+++ b/merico/github/config/command.yml
@@ -1,3 +1,4 @@
 description: 'Config required settings for GIT workflows.'
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py
\ No newline at end of file
diff --git a/merico/github/list_issue_tasks/README.md b/merico/github/list_issue_tasks/README.md
new file mode 100644
index 0000000..0e17255
--- /dev/null
+++ b/merico/github/list_issue_tasks/README.md
@@ -0,0 +1,19 @@
+### list_issue_tasks
+
+列出指定Issue中的任务列表。
+
+#### 用途
+- 查看Issue中的子任务
+- 跟踪任务进度
+
+#### 使用方法
+执行命令: `/github.list_issue_tasks <issue_url>`
+
+#### 操作流程
+1. 获取指定Issue的信息
+2. 解析Issue内容中的任务列表
+3. 显示任务列表
+
+#### 注意事项
+- 需要提供有效的Issue URL
+- 任务应以特定格式在Issue中列出(如: - [ ] 任务描述)
\ No newline at end of file
diff --git a/merico/github/list_issue_tasks/command.yml b/merico/github/list_issue_tasks/command.yml
index 65f90e0..b025408 100644
--- a/merico/github/list_issue_tasks/command.yml
+++ b/merico/github/list_issue_tasks/command.yml
@@ -1,4 +1,5 @@
 description: 'Create new issue.'
 input: required
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py "$input"
\ No newline at end of file
diff --git a/merico/github/new_branch/README.md b/merico/github/new_branch/README.md
new file mode 100644
index 0000000..b9d8344
--- /dev/null
+++ b/merico/github/new_branch/README.md
@@ -0,0 +1,21 @@
+### new_branch
+
+基于当前分支创建新分支并切换到新分支。
+
+#### 用途
+- 快速创建新的功能或修复分支
+- 保持工作区隔离
+
+#### 使用方法
+执行命令: `/github.new_branch <description>`
+
+- description: 新分支的简短描述或相关Issue URL
+
+#### 操作流程
+1. 生成多个分支名建议
+2. 用户选择或编辑分支名
+3. 创建新分支并切换
+
+#### 注意事项
+- 确保当前分支的更改已提交
+- 如提供Issue URL,会自动关联Issue编号到分支名
\ No newline at end of file
diff --git a/merico/github/new_branch/command.yml b/merico/github/new_branch/command.yml
index 6e9cea1..0dddd4f 100644
--- a/merico/github/new_branch/command.yml
+++ b/merico/github/new_branch/command.yml
@@ -1,4 +1,5 @@
 description: 'Create new branch based current branch, and checkout new branch.'
 input: required
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py "$input"
\ No newline at end of file
diff --git a/merico/github/new_issue/README.md b/merico/github/new_issue/README.md
new file mode 100644
index 0000000..cdbfbd1
--- /dev/null
+++ b/merico/github/new_issue/README.md
@@ -0,0 +1,21 @@
+### new_issue
+
+创建新的GitHub Issue。
+
+#### 用途
+- 快速创建标准格式的Issue
+- 记录任务、bug或功能请求
+
+#### 使用方法
+执行命令: `/github.new_issue <description>`
+
+- description: Issue的简短描述
+
+#### 操作流程
+1. 基于描述生成Issue标题和正文
+2. 允许用户编辑Issue内容
+3. 创建GitHub Issue
+
+#### 注意事项
+- 需要有创建Issue的权限
+- 生成的内容可能需要进一步完善
\ No newline at end of file
diff --git a/merico/github/new_issue/command.yml b/merico/github/new_issue/command.yml
index 65f90e0..b025408 100644
--- a/merico/github/new_issue/command.yml
+++ b/merico/github/new_issue/command.yml
@@ -1,4 +1,5 @@
 description: 'Create new issue.'
 input: required
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py "$input"
\ No newline at end of file
diff --git a/merico/github/new_issue/from_task/README.md b/merico/github/new_issue/from_task/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/merico/github/new_issue/from_task/command.yml b/merico/github/new_issue/from_task/command.yml
index 65f90e0..b025408 100644
--- a/merico/github/new_issue/from_task/command.yml
+++ b/merico/github/new_issue/from_task/command.yml
@@ -1,4 +1,5 @@
 description: 'Create new issue.'
 input: required
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py "$input"
\ No newline at end of file
diff --git a/merico/github/new_pr/README.md b/merico/github/new_pr/README.md
new file mode 100644
index 0000000..3af8895
--- /dev/null
+++ b/merico/github/new_pr/README.md
@@ -0,0 +1,22 @@
+### new_pr
+
+创建新的Pull Request。
+
+#### 用途
+- 自动生成PR标题和描述
+- 简化代码审查流程
+
+#### 使用方法
+执行命令: `/github.new_pr [additional_info]`
+
+- additional_info: 可选的附加信息
+
+#### 操作流程
+1. 获取当前分支信息和相关Issue
+2. 生成PR标题和描述
+3. 允许用户编辑PR内容
+4. 创建Pull Request
+
+#### 注意事项
+- 确保当前分支有未合并的更改
+- 需要有创建PR的权限
\ No newline at end of file
diff --git a/merico/github/new_pr/command.yml b/merico/github/new_pr/command.yml
index 9610c19..830b5fd 100644
--- a/merico/github/new_pr/command.yml
+++ b/merico/github/new_pr/command.yml
@@ -1,4 +1,5 @@
 description: 'Create new PR.'
 input: optional
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py "$input"
\ No newline at end of file
diff --git a/merico/github/update_issue_tasks/README.md b/merico/github/update_issue_tasks/README.md
new file mode 100644
index 0000000..6bff455
--- /dev/null
+++ b/merico/github/update_issue_tasks/README.md
@@ -0,0 +1,22 @@
+### update_issue_tasks
+
+更新指定Issue中的任务列表。
+
+#### 用途
+- 添加、修改或删除Issue中的子任务
+- 更新任务进度
+
+#### 使用方法
+执行命令: `/github.update_issue_tasks`
+
+#### 操作流程
+1. 输入Issue URL
+2. 显示当前任务列表
+3. 用户输入更新建议
+4. 生成新的任务列表
+5. 允许用户编辑新任务列表
+6. 更新Issue内容
+
+#### 注意事项
+- 需要有编辑Issue的权限
+- 小心不要删除或覆盖重要信息
\ No newline at end of file
diff --git a/merico/github/update_issue_tasks/command.yml b/merico/github/update_issue_tasks/command.yml
index 65f90e0..b025408 100644
--- a/merico/github/update_issue_tasks/command.yml
+++ b/merico/github/update_issue_tasks/command.yml
@@ -1,4 +1,5 @@
 description: 'Create new issue.'
 input: required
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py "$input"
\ No newline at end of file
diff --git a/merico/github/update_pr/README.md b/merico/github/update_pr/README.md
new file mode 100644
index 0000000..8de261b
--- /dev/null
+++ b/merico/github/update_pr/README.md
@@ -0,0 +1,20 @@
+### update_pr
+
+更新现有的Pull Request。
+
+#### 用途
+- 更新PR的标题和描述
+- 反映最新的代码变更
+
+#### 使用方法
+执行命令: `/github.update_pr`
+
+#### 操作流程
+1. 获取最近的PR信息
+2. 重新生成PR标题和描述
+3. 允许用户编辑PR内容
+4. 更新Pull Request
+
+#### 注意事项
+- 确保有更新PR的权限
+- 更新前请确认是否有新的提交需要推送
\ No newline at end of file
diff --git a/merico/github/update_pr/command.yml b/merico/github/update_pr/command.yml
index 7f5ba3c..878fd1d 100644
--- a/merico/github/update_pr/command.yml
+++ b/merico/github/update_pr/command.yml
@@ -1,4 +1,5 @@
 description: 'Create new PR.'
 input: required
+help: README.md
 steps:
   - run: $devchat_python $command_path/command.py "$input"
\ No newline at end of file
diff --git a/merico/pr/improve/command.yml b/merico/pr/improve/command.yml
index aa2fb00..db9a83a 100644
--- a/merico/pr/improve/command.yml
+++ b/merico/pr/improve/command.yml
@@ -1,4 +1,5 @@
 description: "review pr"
 input: required
+help: README.md
 steps:
   - run: $workflow_python $command_path/../command.py "$input" improve
\ No newline at end of file
diff --git a/merico/refactor/README.md b/merico/refactor/README.md
index dd97c58..7fb2c16 100644
--- a/merico/refactor/README.md
+++ b/merico/refactor/README.md
@@ -1,11 +1,37 @@
 
-### 操作指南
+### refactor
 
-使用代码重构，请按照如下步骤操作：
-1. 选中行间代码。
-2. 输入\/refactor.names，回车发送。
-3. 开始生成代码，等待生成结束。
-4. 自动弹出Diff View，选择是否接受修改。
+这个命令用于根据用户的具体要求重写选中的代码块。
+
+#### 用途
+- 根据特定需求重构选中的代码
+- 优化代码结构和可读性
+- 实现快速的代码改进和调整
+
+#### 使用方法
+1. 在IDE中选中需要重构的代码块
+2. 输入 `/refactor <重构要求>` 并回车
+   例如：`/refactor 将这个函数改写成使用async/await`
+
+#### 操作流程
+1. 选中需要重构的代码块
+2. 执行refactor命令，并提供具体的重构要求
+3. 等待代码重构完成
+4. 自动弹出Diff View，您可以选择接受或拒绝修改
+
+#### 注意事项
+1. 确保在执行命令前已选中需要重构的代码块
+2. 重构要求应尽可能具体和清晰
+3. 该命令只会修改选中的代码部分，不会影响其他代码
+4. 重构后的代码会保持原有的缩进格式，以确保与现有代码结构的一致性
+
+#### 额外信息
+- 重构结果的语言会与原代码保持一致
+- 该命令利用AI技术生成重构建议，可能需要一定的处理时间
+- 复杂的重构可能需要多次尝试或人工调整
+
+#### 提示
+使用refactor命令可以快速实现代码的结构性改进，但请务必仔细审查重构后的代码，确保其符合预期并保持原有功能。
 
 如图所示：
 
diff --git a/merico/unit_tests/README.md b/merico/unit_tests/README.md
index c629e14..902dc78 100644
--- a/merico/unit_tests/README.md
+++ b/merico/unit_tests/README.md
@@ -1,11 +1,41 @@
 
-### 操作指南
+### unit_tests
 
-生成单元测试，请按照如下步骤操作：
-1. 点击函数头部的**DevChat: unit tests**按钮。
-2. 选择Happy Path和Edge Case测试用例。
-3. (可选)输入控制信息：补充测试用例、参考文件和附加提示词。
-4. 点击提交按钮，等待生成结束。
+这个命令用于自动为选中的函数生成单元测试。
+
+#### 用途
+- 快速生成函数的单元测试用例
+- 提高代码的测试覆盖率
+- 节省手动编写测试用例的时间
+
+#### 使用方法
+1. 在IDE中，将光标放在需要生成单元测试的函数上
+2. 点击函数头部的 **DevChat: unit tests** 按钮
+
+#### 操作流程
+1. 点击函数头部的 **DevChat: unit tests** 按钮
+2. 在弹出的对话框中，选择需要生成的测试用例类型：
+   - Happy Path（正常路径）测试用例
+   - Edge Case（边界情况）测试用例
+3. （可选）输入额外的控制信息：
+   - 补充测试用例
+   - 参考文件
+   - 附加提示词
+4. 点击提交按钮
+5. 等待测试用例生成完成
+
+#### 注意事项
+1. 确保在执行命令前，光标位于正确的函数位置
+2. 生成的测试用例可能需要进一步调整和完善
+3. 对于复杂的函数，可能需要提供更多的上下文信息来生成更准确的测试用例
+
+#### 额外信息
+- 测试用例的语言会与原代码保持一致
+- 该命令利用AI技术生成测试用例，可能需要一定的处理时间
+- 生成的测试用例包括正常路径和边界情况，以提高测试覆盖率
+
+#### 提示
+使用unit_tests命令可以快速创建基础的单元测试框架，但建议开发者仔细审查并补充生成的测试用例，以确保它们全面覆盖了函数的各种情况。
 
 如图所示：