@aigne/doc-smith 0.8.11-beta.5 → 0.8.11-beta.6

package/docs/features-update-and-refine.zh-TW.md

@@ -1,73 +1,127 @@
-# 更新與優化
+# 更新與完善
 
-讓文件與不斷演進的程式碼庫保持同步是一項關鍵任務。AIGNE DocSmith 提供了直接且靈活的方法來讓您的內容保持最新，無論是透過基於程式碼變更的自動更新，還是透過精確、由回饋意見驅動的優化。
+讓文件與不斷演進的程式碼庫保持同步是一個有條理的過程。AIGNE DocSmith 提供了直接而靈活的指令，可透過基於程式碼變更的自動更新，或透過精確、由回饋驅動的完善來讓您的內容保持最新。
 
-本指南涵蓋如何：
+本指南涵蓋以下程序：
 
-- 在您的原始碼變更時自動更新文件。
-- 使用針對性的回饋意見重新生成特定文件。
+- 在原始碼被修改時自動更新文件。
+- 使用針對性的回饋重新生成特定文件。
 - 調整整體文件結構。
 
 ### 文件更新工作流程
 
-下圖說明了更新文件的不同路徑：
+下圖說明了可用於更新文件的不同工作流程：
 
-```d2 更新工作流程
+```d2 文件更新工作流程
 direction: down
 
-Start: {
-  shape: circle
-  label: "開始"
+developer: {
+  shape: c4-person
+  label: "開發人員"
 }
 
-Code-Change: {
-  label: "原始碼或\n設定檔變更"
-  shape: rectangle
+codebase: {
+  shape: cylinder
+  label: "原始碼"
 }
 
-Content-Tweak: {
-  label: "需要內容\n改善？"
-  shape: rectangle
+updated-documentation: {
+  shape: cylinder
+  label: "已更新的\n文件"
 }
 
-Structure-Tweak: {
-  label: "需要結構\n改善？"
+workflows: {
+  label: "文件更新工作流程"
   shape: rectangle
-}
-
-Start -> Code-Change
-Start -> Content-Tweak
-Start -> Structure-Tweak
-
-Code-Change -> Generate-Command: "aigne doc generate"
-
-Generate-Command -> Change-Detection: {
-  label: "變更偵測"
-  shape: diamond
-}
-Change-Detection -> Auto-Regen: "重新生成\n受影響文件"
-
-Content-Tweak -> Update-Command: "aigne doc update\n--feedback"
-Update-Command -> Manual-Regen: "重新生成\n特定文件"
-
-Structure-Tweak -> Generate-Feedback-Command: "aigne doc generate\n--feedback"
-Generate-Feedback-Command -> Replan: "重新規劃文件\n結構"
 
-End: {
-  shape: circle
-  label: "文件已更新"
+  automatic-updates: {
+    label: "自動更新（程式碼驅動）"
+    shape: rectangle
+
+    cmd-generate: {
+      label: "aigne doc generate"
+    }
+
+    decision-force: {
+      label: "--forceRegenerate？"
+      shape: diamond
+    }
+
+    detect-changes: {
+      label: "偵測變更"
+    }
+
+    regen-affected: {
+      label: "重新生成\n受影響文件"
+    }
+
+    regen-all: {
+      label: "重新生成\n所有文件"
+    }
+  }
+
+  manual-refinements: {
+    label: "手動完善（回饋驅動）"
+    shape: rectangle
+    grid-columns: 2
+    grid-gap: 100
+
+    refine-individual: {
+      label: "完善個別文件"
+      shape: rectangle
+
+      cmd-update: {
+        label: "aigne doc update\n--feedback"
+      }
+
+      regen-specific: {
+        label: "重新生成\n特定文件"
+      }
+    }
+
+    optimize-structure: {
+      label: "優化整體結構"
+      shape: rectangle
+
+      cmd-generate-feedback: {
+        label: "aigne doc generate\n--feedback"
+      }
+
+      re-evaluate-plan: {
+        label: "重新評估\n文件計畫"
+      }
+    }
+  }
 }
 
-Auto-Regen -> End
-Manual-Regen -> End
-Replan -> End
+# --- Connections ---
+
+# Path 1: Automatic Updates
+developer -> codebase: "1. 進行變更"
+codebase -> workflows.automatic-updates.cmd-generate: "2. 執行指令"
+workflows.automatic-updates.cmd-generate -> workflows.automatic-updates.decision-force
+workflows.automatic-updates.decision-force -> workflows.automatic-updates.detect-changes: "否"
+workflows.automatic-updates.detect-changes -> workflows.automatic-updates.regen-affected
+workflows.automatic-updates.decision-force -> workflows.automatic-updates.regen-all: "是"
+workflows.automatic-updates.regen-affected -> updated-documentation
+workflows.automatic-updates.regen-all -> updated-documentation
+
+# Path 2: Individual Refinement
+developer -> workflows.manual-refinements.refine-individual.cmd-update: "3. 提供\n內容回饋"
+workflows.manual-refinements.refine-individual.cmd-update -> workflows.manual-refinements.refine-individual.regen-specific
+workflows.manual-refinements.refine-individual.regen-specific -> updated-documentation
+
+# Path 3: Structural Refinement
+developer -> workflows.manual-refinements.optimize-structure.cmd-generate-feedback: "4. 提供\n結構性回饋"
+workflows.manual-refinements.optimize-structure.cmd-generate-feedback -> workflows.manual-refinements.optimize-structure.re-evaluate-plan
+workflows.manual-refinements.optimize-structure.re-evaluate-plan -> updated-documentation: "以\n新結構重新生成"
 ```
 
 ---
 
-## 透過變更偵測自動更新
+## 具備變更偵測的自動更新
 
-當您執行 `aigne doc generate` 命令時，DocSmith 會分析您的程式碼庫，偵測自上次執行以來的任何變更，並僅重新生成受影響的文件。此過程可節省時間並減少不必要的 API 呼叫。
+當您執行 `aigne doc generate` 指令時，DocSmith 會先分析您的程式碼庫以偵測自上次生成以來的變更。接著，它只會重新生成受這些變更影響的文件。這種預設行為可以節省時間並減少 API 的使用。
 
 ```shell icon=lucide:terminal
 # DocSmith 將偵測變更並僅更新必要部分
@@ -78,7 +132,7 @@ aigne doc generate
 
 ### 強制完整重新生成
 
-如果您需要從頭開始重新生成所有文件，忽略任何快取或先前的狀態，請使用 `--forceRegenerate` 標記。這在進行重大的設定變更後，或當您想確保一個完全全新的建置時非常有用。
+若要從頭開始重新生成所有文件，繞過快取和變更偵測，請使用 `--forceRegenerate` 旗標。當您進行了重大的設定變更或需要完全重建以確保一致性時，這項操作是必要的。
 
 ```shell icon=lucide:terminal
 # 從頭開始重新生成所有文件
@@ -87,52 +141,52 @@ aigne doc generate --forceRegenerate
 
 ---
 
-## 優化單一文件
+## 完善個別文件
 
-若要在沒有相應程式碼變更的情況下改善特定文件，`aigne doc update` 命令允許您提供針對內容優化的具體指示。
+若要在沒有相應程式碼變更的情況下改善特定文件的內容，請使用 `aigne doc update` 指令。此指令允許您提供針對性的指示以進行完善。
 
-您可以用兩種方式使用此命令：互動式或直接透過命令列參數。
+這可以透過互動模式或透過命令列參數以非互動方式完成。
 
 ### 互動模式
 
-若要獲得引導式體驗，請在不帶任何參數的情況下執行此命令。DocSmith 將會顯示一個選單，讓您選擇要更新的文件。選擇後，系統會提示您輸入回饋意見。
+若要進行引導式流程，請在不帶任何參數的情況下執行該指令。DocSmith 將會顯示一個選單，讓您選擇想要更新的文件。選擇後，系統將提示您輸入回饋。
 
 ```shell icon=lucide:terminal
-# 開始互動式更新流程
+# 啟動互動式更新流程
 aigne doc update
 ```
 
-![以互動方式選擇您想更新的文件。](https://docsmith.aigne.io/image-bin/uploads/75e9cf9823bb369c3d2b5a2e2da4ac06.png)
+![以互動方式選擇您希望更新的文件。](https://docsmith.aigne.io/image-bin/uploads/75e9cf9823bb369c3d2b5a2e2da4ac06.png)
 
 ### 直接透過命令列更新
 
-為了更快速的工作流程或撰寫腳本，您可以使用標記直接指定文件和回饋意見。這允許進行精確、非互動式的更新。
+對於腳本化或更快速的工作流程，您可以使用旗標直接指定文件和回饋。這可以實現精確的非互動式更新。
 
 ```shell icon=lucide:terminal
-# 帶有回饋意見以更新特定文件
+# 透過回饋更新特定文件
 aigne doc update --docs overview.md --feedback "Add a more detailed FAQ section at the end."
 ```
 
-`update` 命令的主要參數：
+以下是 `update` 指令的關鍵參數：
 
 | 參數 | 說明 |
-| ---------- | ------------------------------------------------------------------------------------------------ |
-| `--docs` | 您想更新的文件的路徑。您可以多次使用此標記進行批次更新。 |
+| --- | --- |
+| `--docs` | 要更新的文件的路徑。此旗標可多次使用以進行批次更新。 |
 | `--feedback` | 重新生成內容時要使用的具體指示。 |
 
 ---
 
 ## 優化整體結構
 
-除了優化單一文件的內容，您還可以調整整體的文件結構。如果某個部分缺失或現有組織可以改進，您可以向 `generate` 命令提供回饋意見。
+除了完善個別文件內容外，您還可以調整整體的文件結構。如果現有組織不理想或缺少某個部分，您可以向 `generate` 指令提供回饋。
 
-此命令指示 DocSmith 根據您的新輸入重新評估整個文件計畫。
+這會指示 DocSmith 根據您的輸入重新評估整個文件計畫。
 
 ```shell icon=lucide:terminal
-# 帶有特定回饋意見以重新生成文件結構
+# 根據特定回饋重新生成文件結構
 aigne doc generate --feedback "Remove the 'About' section and add a detailed 'API Reference'."
 ```
 
-這種方法最適合對文件的目錄進行高層次的變更，而非逐行的內容編輯。
+此方法適用於對文件目錄進行高層次的變更，而非用於微小的內容編輯。
 
-有了這些工具，您可以維護與您的專案一同演進的準確文件。一旦您的內容被優化，您就可以將其提供給全球的受眾。請在[翻譯文件](./features-translate-documentation.md)指南中了解如何操作。
+一旦您的內容完善後，下一步就是為全球受眾準備。有關說明，請參閱 [翻譯文件](./features-translate-documentation.md) 指南。

package/docs/features-update-and-refine.zh.md

@@ -1,84 +1,138 @@
-# 更新与优化
+# 更新与完善
 
-让文档与不断演进的代码库保持同步是一项至关重要的任务。AIGNE DocSmith 提供了直接而灵活的方法来保持您的内容最新，无论是通过基于代码变更的自动更新，还是通过精确的、由反馈驱动的优化。
+让文档与不断演进的代码库保持同步是一个系统性的过程。AIGNE DocSmith 提供了直接而灵活的命令来保持内容最新，既可以通过基于代码变更的自动更新，也可以通过精确的、由反馈驱动的完善。
 
-本指南将介绍如何：
+本指南涵盖了以下操作流程：
 
-- 在源代码变更时自动更新文档。
-- 使用有针对性的反馈重新生成特定文档。
+- 在源代码修改时自动更新文档。
+- 使用针对性的反馈重新生成特定文档。
 - 调整整体文档结构。
 
 ### 文档更新工作流
 
-下图说明了更新文档可以采用的不同路径：
+下图展示了更新文档可用的不同工作流：
 
-```d2 Update Workflows
+```d2 文档更新工作流
 direction: down
 
-Start: {
-  shape: circle
-  label: "开始"
+developer: {
+  shape: c4-person
+  label: "开发者"
 }
 
-Code-Change: {
-  label: "源代码或\n配置变更"
-  shape: rectangle
+codebase: {
+  shape: cylinder
+  label: "源代码"
 }
 
-Content-Tweak: {
-  label: "需要内容\n改进？"
-  shape: rectangle
+updated-documentation: {
+  shape: cylinder
+  label: "更新后的\n文档"
 }
 
-Structure-Tweak: {
-  label: "需要结构\n改进？"
+workflows: {
+  label: "文档更新工作流"
   shape: rectangle
-}
-
-Start -> Code-Change
-Start -> Content-Tweak
-Start -> Structure-Tweak
-
-Code-Change -> Generate-Command: "aigne doc generate"
-
-Generate-Command -> Change-Detection: {
-  label: "变更检测"
-  shape: diamond
-}
-Change-Detection -> Auto-Regen: "重新生成\n受影响的文档"
-
-Content-Tweak -> Update-Command: "aigne doc update\n--feedback"
-Update-Command -> Manual-Regen: "重新生成\n特定文档"
-
-Structure-Tweak -> Generate-Feedback-Command: "aigne doc generate\n--feedback"
-Generate-Feedback-Command -> Replan: "重新规划文档\n结构"
 
-End: {
-  shape: circle
-  label: "文档已更新"
+  automatic-updates: {
+    label: "自动更新（代码驱动）"
+    shape: rectangle
+
+    cmd-generate: {
+      label: "aigne doc generate"
+    }
+
+    decision-force: {
+      label: "--forceRegenerate?"
+      shape: diamond
+    }
+
+    detect-changes: {
+      label: "检测变更"
+    }
+
+    regen-affected: {
+      label: "重新生成\n受影响的文档"
+    }
+
+    regen-all: {
+      label: "重新生成\n所有文档"
+    }
+  }
+
+  manual-refinements: {
+    label: "手动完善（反馈驱动）"
+    shape: rectangle
+    grid-columns: 2
+    grid-gap: 100
+
+    refine-individual: {
+      label: "完善单个文档"
+      shape: rectangle
+
+      cmd-update: {
+        label: "aigne doc update\n--feedback"
+      }
+
+      regen-specific: {
+        label: "重新生成\n特定文档"
+      }
+    }
+
+    optimize-structure: {
+      label: "优化整体结构"
+      shape: rectangle
+
+      cmd-generate-feedback: {
+        label: "aigne doc generate\n--feedback"
+      }
+
+      re-evaluate-plan: {
+        label: "重新评估\n文档计划"
+      }
+    }
+  }
 }
 
-Auto-Regen -> End
-Manual-Regen -> End
-Replan -> End
+# --- 连接 ---
+
+# 路径 1：自动更新
+developer -> codebase: "1. 进行变更"
+codebase -> workflows.automatic-updates.cmd-generate: "2. 运行命令"
+workflows.automatic-updates.cmd-generate -> workflows.automatic-updates.decision-force
+workflows.automatic-updates.decision-force -> workflows.automatic-updates.detect-changes: "否"
+workflows.automatic-updates.detect-changes -> workflows.automatic-updates.regen-affected
+workflows.automatic-updates.decision-force -> workflows.automatic-updates.regen-all: "是"
+workflows.automatic-updates.regen-affected -> updated-documentation
+workflows.automatic-updates.regen-all -> updated-documentation
+
+# 路径 2：单个完善
+developer -> workflows.manual-refinements.refine-individual.cmd-update: "3. 提供\n内容反馈"
+workflows.manual-refinements.refine-individual.cmd-update -> workflows.manual-refinements.refine-individual.regen-specific
+workflows.manual-refinements.refine-individual.regen-specific -> updated-documentation
+
+# 路径 3：结构完善
+developer -> workflows.manual-refinements.optimize-structure.cmd-generate-feedback: "4. 提供\n结构反馈"
+workflows.manual-refinements.optimize-structure.cmd-generate-feedback -> workflows.manual-refinements.optimize-structure.re-evaluate-plan
+workflows.manual-refinements.optimize-structure.re-evaluate-plan -> updated-documentation: "使用\n新结构重新生成"
 ```
 
 ---
 
-## 通过变更检测自动更新
+## 通过变更检测实现自动更新
 
-当您运行 `aigne doc generate` 命令时，DocSmith 会分析您的代码库，检测自上次运行以来的任何变更，并仅重新生成受影响的文档。这个过程可以节省时间并减少不必要的 API 调用。
+当您执行 `aigne doc generate` 命令时，DocSmith 会首先分析您的代码库以检测自上次生成以来的变更。然后，它仅重新生成受这些变更影响的文档。这种默认行为可以节省时间并减少 API 使用量。
 
 ```shell icon=lucide:terminal
-# DocSmith 将检测变更并仅更新必要的内容
+# DocSmith 将检测变更并仅更新必要的部分
 aigne doc generate
 ```
 
-![DocSmith 会检测变更并仅重新生成所需的文档。](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
+![DocSmith 检测变更并仅重新生成所需文档。](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
 
 ### 强制完全重新生成
 
-如果您需要从头开始重新生成所有文档，忽略任何缓存或先前的状态，请使用 `--forceRegenerate` 标志。这在进行重大配置更改后或当您希望确保完全重新构建时非常有用。
+要从头开始重新生成所有文档，绕过缓存和变更检测，请使用 `--forceRegenerate` 标志。当您进行了重大的配置更改或需要完全重建以确保一致性时，此操作是必需的。
 
 ```shell icon=lucide:terminal
 # 从头开始重新生成所有文档
@@ -87,52 +141,52 @@ aigne doc generate --forceRegenerate
 
 ---
 
-## 优化单个文档
+## 完善单个文档
 
-要在没有相应代码变更的情况下改进特定文档，`aigne doc update` 命令允许您为内容优化提供有针对性的指令。
+要在没有相应代码变更的情况下改进特定文档的内容，请使用 `aigne doc update` 命令。此命令允许您提供针对性的完善指令。
 
-您可以通过两种方式使用此命令：交互式或直接通过命令行参数。
+这可以通过交互方式或通过命令行参数以非交互方式完成。
 
 ### 交互模式
 
-要获得引导式体验，请在不带任何参数的情况下运行该命令。DocSmith 将会显示一个菜单，供您选择要更新的文档。选择后，系统将提示您输入反馈。
+要进行引导式流程，请不带参数运行该命令。DocSmith 将会显示一个菜单，供您选择要更新的文档。选择后，系统将提示您输入反馈。
 
 ```shell icon=lucide:terminal
-# 启动交互式更新过程
+# 启动交互式更新流程
 aigne doc update
 ```
 
-![交互式选择您希望更新的文档。](https://docsmith.aigne.io/image-bin/uploads/75e9cf9823bb369c3d2b5a2e2da4ac06.png)
+![以交互方式选择您希望更新的文档。](https://docsmith.aigne.io/image-bin/uploads/75e9cf9823bb369c3d2b5a2e2da4ac06.png)
 
 ### 直接通过命令行更新
 
-为了实现更快的工作流或脚本编写，您可以使用标志直接指定文档和反馈。这允许进行精确的非交互式更新。
+对于脚本化或更快速的工作流，您可以使用标志直接指定文档和反馈。这样可以实现精确的非交互式更新。
 
 ```shell icon=lucide:terminal
 # 使用反馈更新特定文档
 aigne doc update --docs overview.md --feedback "在末尾添加更详细的常见问题解答部分。"
 ```
 
-`update` 命令的关键参数：
+`update` 命令的主要参数如下：
 
-| 参数  | 描述                                                                                      |
-| ---------- | ------------------------------------------------------------------------------------------------ |
-| `--docs`     | 您想要更新的文档的路径。您可以多次使用此标志进行批量更新。 |
-| `--feedback` | 重新生成内容时使用的具体指令。                       |
+| 参数 | 描述 |
+| --- | --- |
+| `--docs` | 要更新的文档的路径。此标志可以多次使用以进行批量更新。 |
+| `--feedback` | 重新生成内容时要使用的具体指令。 |
 
 ---
 
 ## 优化整体结构
 
-除了优化单个文档的内容外，您还可以调整整体文档结构。如果缺少某个部分或现有组织结构可以改进，您可以向 `generate` 命令提供反馈。
+除了完善单个文档内容外，您还可以调整整体文档结构。如果现有组织结构不理想或缺少某个部分，您可以向 `generate` 命令提供反馈。
 
-此命令指示 DocSmith 根据您的新输入重新评估整个文档计划。
+这会指示 DocSmith 根据您的输入重新评估整个文档计划。
 
 ```shell icon=lucide:terminal
 # 使用特定反馈重新生成文档结构
 aigne doc generate --feedback "删除‘关于’部分，并添加详细的‘API 参考’。"
 ```
 
-这种方法最适合对文档目录进行高层级更改，而不是逐行编辑内容。
+此方法适用于文档目录的高级别更改，而非次要内容编辑。
 
-借助这些工具，您可以维护与项目一同演进的准确文档。内容优化后，您可以将其提供给全球受众。在 [翻译文档](./features-translate-documentation.md) 指南中了解如何操作。
+内容完善后，下一步是为全球受众做准备。有关说明，请参阅 [翻译文档](./features-translate-documentation.md) 指南。

package/docs/getting-started.ja.md

@@ -1,10 +1,10 @@
 # はじめに
 
-このガイドでは、AIGNE DocSmithをインストールし、プロジェクトを設定し、ソースコードから完全なドキュメント一式を生成するためのステップバイステップのウォークスルーを提供します。
+このガイドでは、AIGNE DocSmithをインストールし、プロジェクトを設定し、ソースコードから完全なドキュメントセットを生成するための手順をステップバイステップで説明します。
 
-## ステップ1: 前提条件
+## ステップ1：前提条件
 
-始める前に、システムにNode.jsとそのパッケージマネージャーであるnpmがインストールされていることを確認してください。DocSmithは、Node.js環境で実行されるコマンドラインツールです。
+始める前に、お使いのシステムにNode.jsとそのパッケージマネージャーであるnpmがインストールされていることを確認してください。DocSmithはNode.js環境で動作するコマンドラインツールです。
 
 ### Node.jsのインストール
 
@@ -16,13 +16,13 @@
 
 **macOS**
 
-推奨される方法は[Homebrew](https://brew.sh/)を使用することです:
+推奨される方法は[Homebrew](https://brew.sh/)を使用することです：
 
 ```bash Terminal icon=lucide:apple
-# Install Homebrew if you don't have it
+# Homebrewがインストールされていない場合はインストールします
 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
-# Install Node.js
+# Node.jsをインストールします
 brew install node
 ```
 
@@ -30,7 +30,7 @@ brew install node
 
 **Linux**
 
-Ubuntu/Debianベースのシステムの場合:
+Ubuntu/Debianベースのシステムの場合：
 
 ```bash Terminal icon=lucide:laptop
 sudo apt update
@@ -38,7 +38,7 @@ curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
 sudo apt-get install -y nodejs
 ```
 
-CentOS/RHEL/Fedoraベースのシステムの場合:
+CentOS/RHEL/Fedoraベースのシステムの場合：
 
 ```bash Terminal icon=lucide:laptop
 curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
@@ -47,32 +47,32 @@ sudo yum install nodejs
 
 ### 確認
 
-インストール後、ターミナルでこれらのコマンドを実行して、Node.jsとnpmが利用可能であることを確認します:
+インストール後、ターミナルで次のコマンドを実行して、Node.jsとnpmが利用可能であることを確認します：
 
 ```bash Terminal
 node --version
 npm --version
 ```
 
-## ステップ2: AIGNE CLIのインストール
+## ステップ2：AIGNE CLIのインストール
 
-The DocSmithツールは、AIGNEコマンドラインインターフェース(CLI)に含まれています。npmを使用してAIGNE CLIの最新バージョンをグローバルにインストールします:
+DocSmithツールは、AIGNEコマンドラインインターフェース（CLI）に含まれています。npmを使用してAIGNE CLIの最新バージョンをグローバルにインストールします：
 
 ```bash Terminal icon=logos:npm
 npm i -g @aigne/cli
 ```
 
-インストールが完了したら、ドキュメンテーションツールのヘルプコマンドを実行して確認します:
+インストールが完了したら、ドキュメンテーションツールのヘルプコマンドを実行して確認します：
 
 ```bash Terminal
 aigne doc -h
 ```
 
-このコマンドはDocSmithのヘルプメニューを表示し、使用準備が整っていることを確認します。
+このコマンドを実行すると、DocSmithのヘルプメニューが表示され、使用準備が整ったことを確認できます。
 
-## ステップ3: ドキュメントの生成
+## ステップ3：ドキュメントの生成
 
-CLIがインストールされたら、単一のコマンドでドキュメントを生成できます。ターミナルでプロジェクトのルートディレクトリに移動し、次を実行します:
+CLIがインストールされたので、1つのコマンドでドキュメントを生成できます。ターミナルでプロジェクトのルートディレクトリに移動し、次を実行します：
 
 ```bash Terminal icon=lucide:sparkles
 aigne doc generate
@@ -80,11 +80,11 @@ aigne doc generate
 
 ### 自動設定
 
-プロジェクトでこのコマンドを初めて実行すると、DocSmithは設定が存在しないことを検出し、対話式のセットアップウィザードを自動的に起動します。
+プロジェクトでこのコマンドを初めて実行すると、DocSmithは設定が存在しないことを検出し、自動的に対話式のセットアップウィザードを起動します。
 
 ![generateコマンドを実行するとセットアップウィザードが開始されます](https://docsmith.aigne.io/image-bin/uploads/0c45a32667c5250e54194a61d9495965.png)
 
-ドキュメントの特性を定義するための一連の質問が表示されます。これには以下が含まれます:
+ドキュメントの特性を定義するための一連の質問が表示されます。これには以下が含まれます：
 
 - 主な目的とスタイル。
 - 対象読者。
@@ -94,21 +94,21 @@ aigne doc generate
 
 ![プロンプトに答えてプロジェクトのセットアップを完了します](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
 
-設定が完了すると、DocSmithはソースコードの分析、ドキュメント構造の計画、コンテンツの生成に進みます。
+設定が完了すると、DocSmithはソースコードの分析、ドキュメント構造の計画、そしてコンテンツの生成に進みます。
 
-![DocSmithが構造を計画し、ドキュメントを生成しています](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
+![DocSmithが構造を計画し、ドキュメントを生成している様子](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
 
-## ステップ4: 出力の確認
+## ステップ4：出力の確認
 
 生成プロセスが終了すると、ターミナルに確認メッセージが表示されます。
 
 ![ドキュメント生成成功のメッセージ](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.png)
 
-新しいドキュメントは、セットアッププロセス中に指定した出力ディレクトリで利用可能になりました。デフォルトの場所は `.aigne/doc-smith/docs` です。
+新しいドキュメントは、セットアッププロセス中に指定した出力ディレクトリで利用可能になります。デフォルトの場所は`.aigne/doc-smith/docs`です。
 
 ## 次のステップ
 
-最初のドキュメントセットを生成したので、他の機能を試すことができます:
+最初のドキュメントセットを生成したので、他の機能を試すことができます：
 
 <x-cards>
   <x-card data-title="コア機能" data-icon="lucide:box" data-href="/features">

package/docs/getting-started.md

@@ -94,7 +94,7 @@ You will be prompted with a series of questions to define the documentation's ch
 
 ![Answer the prompts to complete the project setup](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
 
-Once the configuration is complete, DocSmith will proceed to analyze your source code, plan the document structure, and generate the content.
+Once the configuration is complete, DocSmith will proceed to analyze your source code, plan the documentation structure, and generate the content.
 
 ![DocSmith planning the structure and generating documents](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)