refine docs

Author: geekan

docs/install/cli_install.md

@@ -9,17 +9,29 @@
 
 ### Detail Installation
 ```bash
-# Step 1: Ensure that NPM is installed on your system. Then install mermaid-js. (If you don't have npm in your computer, please go to the Node.js official website to install Node.js https://nodejs.org/ and then you will have npm tool in your computer.)
-npm --version
-sudo npm install -g @mermaid-js/mermaid-cli
-
-# Step 2: Ensure that Python 3.9+ is installed on your system. You can check this by using:
+# Step 1: Ensure that Python 3.9+ is installed on your system. You can check this by using:
+# You can use conda to initialize a new python env
+#     conda create -n metagpt python=3.9
+#     conda activate metagpt
 python3 --version
 
-# Step 3: Clone the repository to your local machine, and install it.
+# Step 2: Clone the repository to your local machine for latest version, and install it.
 git clone https://github.com/geekan/MetaGPT.git
 cd MetaGPT
-pip install -e.
+pip3 install -e .     # or pip3 install metagpt  # for stable version
+
+# Step 3: setup your LLM key in the config2.yaml file
+mkdir ~/.metagpt
+cp config/config2.yaml ~/.metagpt/config2.yaml
+vim ~/.metagpt/config2.yaml
+
+# Step 4: run metagpt cli
+metagpt "Create a 2048 game in python"
+
+# Step 5 [Optional]: If you want to save the artifacts like diagrams such as quadrant chart, system designs, sequence flow in the workspace, you can execute the step before Step 3. By default, the framework is compatible, and the entire process can be run completely without executing this step.
+# If executing, ensure that NPM is installed on your system. Then install mermaid-js. (If you don't have npm in your computer, please go to the Node.js official website to install Node.js https://nodejs.org/ and then you will have npm tool in your computer.)
+npm --version
+sudo npm install -g @mermaid-js/mermaid-cli
 ```
 
 **Note:**
@@ -35,7 +47,7 @@ pip install -e.
 
 - don't forget to the configuration for mmdc path in config.yml
 
-  ```yml
+  ```yaml
   mermaid:
     puppeteer_config: "./config/puppeteer-config.json"
     path: "./node_modules/.bin/mmdc"

docs/install/cli_install_cn.md

@@ -10,17 +10,29 @@
 ### 详细安装
 
 ```bash
-# 第 1 步：确保您的系统上安装了 NPM。并使用npm安装mermaid-js
-npm --version
-sudo npm install -g @mermaid-js/mermaid-cli
-
-# 第 2 步：确保您的系统上安装了 Python 3.9+。您可以使用以下命令进行检查：
+# 步骤 1: 确保您的系统安装了 Python 3.9 或更高版本。您可以使用以下命令来检查:
+# 您可以使用 conda 来初始化一个新的 Python 环境
+#     conda create -n metagpt python=3.9
+#     conda activate metagpt
 python3 --version
 
-# 第 3 步：克隆仓库到您的本地机器，并进行安装。
+# 步骤 2: 克隆仓库到您的本地机器以获取最新版本，并安装它。
 git clone https://github.com/geekan/MetaGPT.git
 cd MetaGPT
-pip install -e.
+pip3 install -e .     # 或 pip3 install metagpt  # 用于稳定版本
+
+# 步骤 3: 在 config2.yaml 文件中设置您的 LLM 密钥
+mkdir ~/.metagpt
+cp config/config2.yaml ~/.metagpt/config2.yaml
+vim ~/.metagpt/config2.yaml
+
+# 步骤 4: 运行 metagpt 命令行界面
+metagpt "用 python 创建一个 2048 游戏"
+
+# 步骤 5 [可选]: 如果您想保存诸如象限图、系统设计、序列流等图表作为工作空间的工件，您可以在执行步骤 3 之前执行此步骤。默认情况下，该框架是兼容的，整个过程可以完全不执行此步骤而运行。
+# 如果执行此步骤，请确保您的系统上安装了 NPM。然后安装 mermaid-js。（如果您的计算机中没有 npm，请访问 Node.js 官方网站 https://nodejs.org/ 安装 Node.js，然后您将在计算机中拥有 npm 工具。）
+npm --version
+sudo npm install -g @mermaid-js/mermaid-cli
 ```
 
 **注意：**
@@ -33,11 +45,12 @@ pip install -e.
     npm install @mermaid-js/mermaid-cli
     ```
 
-- 不要忘记在config.yml中为mmdc配置配置，
+- 不要忘记在config.yml中为mmdc配置
 
     ```yml
-    puppeteer_config: "./config/puppeteer-config.json"
-    path: "./node_modules/.bin/mmdc"
+    mermaid:
+      puppeteer_config: "./config/puppeteer-config.json"
+      path: "./node_modules/.bin/mmdc"
     ```
 
 - 如果`pip install -e.`失败并显示错误`[Errno 13] Permission denied: '/usr/local/lib/python3.11/dist-packages/test-easy-install-13129.write-test'`，请尝试使用`pip install -e. --user`运行。

docs/tutorial/usage.md

@@ -34,29 +34,28 @@ metagpt "Write a cli snake game based on pygame"
 ### Usage
 
 ```
-NAME
-    metagpt - We are a software startup comprised of AI. By investing in us, you are empowering a future filled with limitless possibilities.
-
-SYNOPSIS
-    metagpt IDEA <flags>
-
-DESCRIPTION
-    We are a software startup comprised of AI. By investing in us, you are empowering a future filled with limitless possibilities.
-
-POSITIONAL ARGUMENTS
-    IDEA
-        Type: str
-        Your innovative idea, such as "Creating a snake game."
-
-FLAGS
-    --investment=INVESTMENT
-        Type: float
-        Default: 3.0
-        As an investor, you have the opportunity to contribute a certain dollar amount to this AI company.
-    --n_round=N_ROUND
-        Type: int
-        Default: 5
-
-NOTES
-    You can also use flags syntax for POSITIONAL ARGUMENTS
+ Usage: metagpt [OPTIONS] [IDEA]                                                                                                                                                                                          
+                                                                                                                                                                                                                          
+ Start a new project.                                                                                                                                                                                                     
+                                                                                                                                                                                                                          
+╭─ Arguments ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│   idea      [IDEA]  Your innovative idea, such as 'Create a 2048 game.' [default: None]                                                                                                                                │
+╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ --investment                                     FLOAT    Dollar amount to invest in the AI company. [default: 3.0]                                                                                                    │
+│ --n-round                                        INTEGER  Number of rounds for the simulation. [default: 5]                                                                                                            │
+│ --code-review                --no-code-review             Whether to use code review. [default: code-review]                                                                                                           │
+│ --run-tests                  --no-run-tests               Whether to enable QA for adding & running tests. [default: no-run-tests]                                                                                     │
+│ --implement                  --no-implement               Enable or disable code implementation. [default: implement]                                                                                                  │
+│ --project-name                                   TEXT     Unique project name, such as 'game_2048'.                                                                                                                    │
+│ --inc                        --no-inc                     Incremental mode. Use it to coop with existing repo. [default: no-inc]                                                                                       │
+│ --project-path                                   TEXT     Specify the directory path of the old version project to fulfill the incremental requirements.                                                               │
+│ --reqa-file                                      TEXT     Specify the source file name for rewriting the quality assurance code.                                                                                       │
+│ --max-auto-summarize-code                        INTEGER  The maximum number of times the 'SummarizeCode' action is automatically invoked, with -1 indicating unlimited. This parameter is used for debugging the      │
+│                                                           workflow.                                                                                                                                                    │
+│                                                           [default: 0]                                                                                                                                                 │
+│ --recover-path                                   TEXT     recover the project from existing serialized storage [default: None]                                                                                         │
+│ --init-config                --no-init-config             Initialize the configuration file for MetaGPT. [default: no-init-config]                                                                                     │
+│ --help                                                    Show this message and exit.                                                                                                                                  │
+╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```

docs/tutorial/usage_cn.md

@@ -30,29 +30,28 @@ metagpt "写一个基于pygame的命令行贪吃蛇"
 ### 使用
 
 ```
-名称
-    metagpt - 我们是一家AI软件创业公司。通过投资我们，您将赋能一个充满无限可能的未来。
-
-概要
-    metagpt IDEA <flags>
-
-描述
-    我们是一家AI软件创业公司。通过投资我们，您将赋能一个充满无限可能的未来。
-
-位置参数
-    IDEA
-        类型: str
-        您的创新想法，例如"写一个命令行贪吃蛇。"
-
-标志
-    --investment=INVESTMENT
-        类型: float
-        默认值: 3.0
-        作为投资者，您有机会向这家AI公司投入一定的美元金额。
-    --n_round=N_ROUND
-        类型: int
-        默认值: 5
-
-备注
-    您也可以用`标志`的语法，来处理`位置参数`
+ Usage: metagpt [OPTIONS] [IDEA]                                                                                                                                                                                          
+                                                                                                                                                                                                                          
+ Start a new project.                                                                                                                                                                                                     
+                                                                                                                                                                                                                          
+╭─ Arguments ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│   idea      [IDEA]  Your innovative idea, such as 'Create a 2048 game.' [default: None]                                                                                                                                │
+╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+│ --investment                                     FLOAT    Dollar amount to invest in the AI company. [default: 3.0]                                                                                                    │
+│ --n-round                                        INTEGER  Number of rounds for the simulation. [default: 5]                                                                                                            │
+│ --code-review                --no-code-review             Whether to use code review. [default: code-review]                                                                                                           │
+│ --run-tests                  --no-run-tests               Whether to enable QA for adding & running tests. [default: no-run-tests]                                                                                     │
+│ --implement                  --no-implement               Enable or disable code implementation. [default: implement]                                                                                                  │
+│ --project-name                                   TEXT     Unique project name, such as 'game_2048'.                                                                                                                    │
+│ --inc                        --no-inc                     Incremental mode. Use it to coop with existing repo. [default: no-inc]                                                                                       │
+│ --project-path                                   TEXT     Specify the directory path of the old version project to fulfill the incremental requirements.                                                               │
+│ --reqa-file                                      TEXT     Specify the source file name for rewriting the quality assurance code.                                                                                       │
+│ --max-auto-summarize-code                        INTEGER  The maximum number of times the 'SummarizeCode' action is automatically invoked, with -1 indicating unlimited. This parameter is used for debugging the      │
+│                                                           workflow.                                                                                                                                                    │
+│                                                           [default: 0]                                                                                                                                                 │
+│ --recover-path                                   TEXT     recover the project from existing serialized storage [default: None]                                                                                         │
+│ --init-config                --no-init-config             Initialize the configuration file for MetaGPT. [default: no-init-config]                                                                                     │
+│ --help                                                    Show this message and exit.                                                                                                                                  │
+╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```