@aigne/doc-smith 0.8.12-beta.5 → 0.8.12-beta.7

package/docs/guides-translating-documentation.ja.md

@@ -1,14 +1,14 @@
 # ドキュメントの翻訳
 
-このガイドでは、`aigne doc translate` コマンドを使用して、生成されたドキュメントを複数の言語に翻訳する方法について説明します。このプロセスではAIを利用して、翻訳が文脈を認識し、技術的な正確性を維持するようにします。
+このガイドでは、`aigne doc translate` コマンドを使用して、生成されたドキュメントを多言語に翻訳する方法について説明します。このプロセスでは AI を使用して、翻訳が文脈を認識し、技術的な正確性を維持するようにします。
 
 このツールは12の言語をサポートしており、世界中のオーディエンスにリーチすることができます。ソースドキュメントの主要言語は、利用可能な翻訳言語のリストから自動的に除外されます。
 
 ## `translate` コマンド
 
-`aigne doc translate` コマンドは、既存のドキュメントファイルの翻訳を生成するために使用されます。インタラクティブに実行して、対象のドキュメントと言語を選択することも、コマンドラインフラグを使用してこれらのオプションを直接指定し、ワークフローを自動化することもできます。
+`aigne doc translate` コマンドは、既存のドキュメントファイルの翻訳を生成するために使用されます。対話形式で実行して、翻訳したいドキュメントと言語を選択することも、自動化されたワークフローのためにコマンドラインフラグを使用してこれらのオプションを直接指定することもできます。
 
-### インタラクティブモード
+### 対話モード
 
 ガイド付きのエクスペリエンスを利用するには、引数なしでコマンドを実行します。
 
@@ -18,21 +18,21 @@ aigne doc translate
 
 実行されると、ツールは以下の手順を実行します。
 1.  既存のドキュメントをスキャンします。
-2.  リストから翻訳したい特定のドキュメントを選択するよう促します。
-3.  翻訳の対象言語を選択するよう促します。以前に選択した言語は、便宜上あらかじめチェックされています。
-4.  選択された各ドキュメントと言語のペアについて翻訳プロセスを開始します。
-5.  翻訳されたファイルを、言語ごとに適切なディレクトリに保存します。
+2.  リストから翻訳したい特定のドキュメントを選択するように求めます。
+3.  翻訳の対象言語を選択するように求めます。以前に選択した言語は、便宜上、事前にチェックされています。
+4.  選択された各ドキュメントと言語のペアに対して翻訳プロセスを開始します。
+5.  翻訳されたファイルを同じディレクトリに保存します。新しいファイルは、元のファイル名に言語コードを追加して命名されます（例：`overview.md` の中国語翻訳は `overview.zh.md` になります）。
 
 ### コマンドラインオプション
 
-非インタラクティブな使用やスクリプト作成のために、以下のコマンドラインフラグを使用して翻訳プロセスを制御できます。
+非対話的な使用やスクリプト作成のために、以下のコマンドラインフラグを使用して翻訳プロセスを制御できます。
 
 <x-field-group>
   <x-field data-name="--docs" data-type="array<string>">
-    <x-field-desc markdown>翻訳するドキュメントのパスを1つ以上指定します。指定しない場合、ツールはインタラクティブモードに入り、利用可能なドキュメントのリストから選択できるようになります。</x-field-desc>
+    <x-field-desc markdown>翻訳する1つ以上のドキュメントパスを指定します。指定しない場合、ツールは対話モードに入り、利用可能なドキュメントのリストから選択できるようになります。</x-field-desc>
   </x-field>
   <x-field data-name="--langs" data-type="array<string>">
-    <x-field-desc markdown>対象となる言語コード（例：`zh`、`ja`）を1つ以上指定します。省略した場合、インタラクティブに言語を選択するよう促されます。</x-field-desc>
+    <x-field-desc markdown>1つ以上のターゲット言語コード（例：`zh`、`ja`）を指定します。省略した場合、対話形式で言語を選択するように求められます。</x-field-desc>
   </x-field>
   <x-field data-name="--glossary" data-type="string">
     <x-field-desc markdown>用語集ファイルへのパス（例：`@path/to/glossary.md`）を提供します。これにより、特定の技術用語がすべてのドキュメントで一貫して翻訳されるようになります。</x-field-desc>
@@ -46,13 +46,13 @@ aigne doc translate
 
 #### 1. 特定のドキュメントを複数の言語に翻訳する
 
-インタラクティブなプロンプトなしで `overview.md` と `examples.md` を中国語（`zh`）と日本語（`ja`）に翻訳するには：
+対話プロンプトなしで `overview.md` と `examples.md` を中国語（`zh`）と日本語（`ja`）に翻訳するには：
 
 ```bash
 aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 ```
 
-#### 2. 用語集を使用して用語の一貫性を保つ
+#### 2. 用語集を使用して一貫した用語を確保する
 
 技術用語が正しく翻訳されるように、用語集ファイルを提供します。これは、ブランド名や専門用語の一貫性を維持するのに役立ちます。
 
@@ -60,9 +60,9 @@ aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 aigne doc translate --glossary @./glossary.md
 ```
 
-#### 3. フィードバックを提供して翻訳スタイルを調整する
+#### 3. フィードバックを提供して翻訳スタイルを洗練させる
 
-フィードバックを提供することで、翻訳スタイルをガイドできます。例えば、よりフォーマルなトーンを要求するには：
+フィードバックを提供することで、翻訳スタイルをガイドできます。例えば、よりフォーマルなトーンをリクエストするには：
 
 ```bash
 aigne doc translate --feedback "Use a formal, technical tone for all translations."
@@ -88,8 +88,8 @@ aigne doc translate --feedback "Use a formal, technical tone for all translation
 | イタリア語 | `it` |
 | アラビア語 | `ar` |
 
-## まとめ
+## 概要
 
-`translate` コマンドは、ドキュメントをローカライズするための構造化された方法を提供します。ガイド付き翻訳のためのインタラクティブモードを使用することも、自動化されたワークフローのためのコマンドラインオプションを使用することもできます。用語集やフィードバックなどの機能を使用することで、翻訳されたコンテンツの品質と一貫性を維持するのに役立ちます。
+`translate` コマンドは、ドキュメントをローカライズするための構造化された方法を提供します。対話モードを使用してガイド付きの翻訳を行ったり、コマンドラインオプションを使用して自動化されたワークフローを構築したりできます。用語集やフィードバックなどの機能を使用することで、翻訳コンテンツの品質と一貫性を維持するのに役立ちます。
 
-ドキュメントを翻訳した後、[ドキュメントの公開](./guides-publishing-your-docs.md) に進むことができます。
+ドキュメントを翻訳した後、[ドキュメントの公開](./guides-publishing-your-docs.md)に進むことができます。

package/docs/guides-translating-documentation.md

@@ -21,7 +21,7 @@ When executed, the tool will perform the following steps:
 2.  Prompt you to select the specific documents you wish to translate from a list.
 3.  Prompt you to select the target languages for translation. Previously selected languages will be pre-checked for convenience.
 4.  Begin the translation process for each selected document and language pair.
-5.  Save the translated files in the appropriate language-specific directories.
+5.  Save the translated files in the same directory. The new files are named by appending a language code to the original filename (e.g., a Chinese translation of `overview.md` becomes `overview.zh.md`).
 
 ### Command-Line Options
 

package/docs/guides-translating-documentation.zh-TW.md

@@ -1,44 +1,44 @@
 # 翻譯文件
 
-本指南說明如何使用 `aigne doc translate` 指令將您產生的文件翻譯成多種語言。此過程使用 AI 來確保翻譯具有上下文感知能力並保持技術準確性。
+本指南說明如何使用 `aigne doc translate` 指令將您產生的文件翻譯成多種語言。此過程使用 AI 來確保翻譯具有情境感知能力並保持技術準確性。
 
-該工具支援 12 種語言，讓您能夠觸及全球受眾。您的源文件的主要語言將自動從可用的翻譯語言清單中排除。
+該工具支援 12 種語言，讓您能夠觸及全球受眾。您的來源文件的主要語言將自動從可用的翻譯語言清單中排除。
 
 ## `translate` 指令
 
-`aigne doc translate` 指令用於為您現有的文件檔案產生翻譯。您可以以互動模式執行它，以選擇您想要的文件和語言，或者您也可以使用命令列標誌直接指定這些選項，以實現自動化工作流程。
+`aigne doc translate` 指令用於為您現有的文件檔案產生翻譯。您可以以互動模式執行它來選擇您想要的文件和語言，或者您也可以使用命令列旗標直接指定這些選項以實現自動化工作流程。
 
 ### 互動模式
 
-若要獲得引導式體驗，請在不帶任何參數的情況下執行該指令：
+若要獲得引導式體驗，請在不帶任何參數的情況下執行此指令：
 
 ```bash
 aigne doc translate
 ```
 
-執行後，該工具將執行以下步驟：
+執行時，該工具將執行以下步驟：
 1.  掃描現有文件。
-2.  提示您從清單中選擇要翻譯的特定文件。
+2.  提示您從清單中選擇您希望翻譯的特定文件。
 3.  提示您選擇目標翻譯語言。為方便起見，先前選擇的語言將被預先勾選。
-4.  為每個選定的文件和語言對開始翻譯過程。
-5.  將翻譯後的文件儲存在相應的特定語言目錄中。
+4.  為每個選定的文件和語言組合開始翻譯過程。
+5.  將翻譯後的文件儲存在同一個目錄中。新檔案的命名方式是在原始檔名後附加語言代碼（例如，`overview.md` 的中文翻譯會變成 `overview.zh.md`）。
 
 ### 命令列選項
 
-對於非互動式使用或腳本編寫，您可以使用以下命令列標誌來控制翻譯過程。
+對於非互動式使用或腳本編寫，您可以使用以下命令列旗標來控制翻譯過程。
 
 <x-field-group>
   <x-field data-name="--docs" data-type="array<string>">
-    <x-field-desc markdown>指定一個或多個要翻譯的文件路徑。如果未提供，該工具將進入互動模式，讓您從可用文件清單中選擇。</x-field-desc>
+    <x-field-desc markdown>指定一個或多個要翻譯的文件路徑。若未提供，該工具將進入互動模式，讓您從可用文件清單中進行選擇。</x-field-desc>
   </x-field>
   <x-field data-name="--langs" data-type="array<string>">
-    <x-field-desc markdown>指定一個或多個目標語言代碼（例如，`zh`、`ja`）。如果省略，系統將提示您以互動方式選擇語言。</x-field-desc>
+    <x-field-desc markdown>指定一個或多個目標語言代碼（例如 `zh`、`ja`）。若省略，系統將提示您以互動方式選擇語言。</x-field-desc>
   </x-field>
   <x-field data-name="--glossary" data-type="string">
-    <x-field-desc markdown>提供一個詞彙表檔案的路徑（例如，`@path/to/glossary.md`）。這可以確保特定的技術術語在所有文件中得到一致的翻譯。</x-field-desc>
+    <x-field-desc markdown>提供詞彙表檔案的路徑（例如 `@path/to/glossary.md`）。這能確保特定的技術術語在所有文件中得到一致的翻譯。</x-field-desc>
   </x-field>
   <x-field data-name="--feedback" data-type="string">
-    <x-field-desc markdown>提供具體的說明或回饋來指導 AI 的翻譯風格，例如調整語氣或術語。</x-field-desc>
+    <x-field-desc markdown>提供具體的指示或回饋來引導 AI 的翻譯風格，例如調整語氣或術語。</x-field-desc>
   </x-field>
 </x-field-group>
 
@@ -46,7 +46,7 @@ aigne doc translate
 
 #### 1. 將特定文件翻譯成多種語言
 
-要將 `overview.md` 和 `examples.md` 翻譯成中文（`zh`）和日文（`ja`）而無需互動式提示：
+若要將 `overview.md` 和 `examples.md` 翻譯成中文（`zh`）和日文（`ja`）且不使用互動式提示：
 
 ```bash
 aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
@@ -54,25 +54,25 @@ aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 
 #### 2. 使用詞彙表以確保術語一致
 
-為確保技術術語翻譯正確，請提供一個詞彙表檔案。這對於保持品牌名稱或專業詞彙的一致性非常有用。
+為確保技術術語翻譯正確，請提供一個詞彙表檔案。這對於保持品牌名稱或專業詞彙的一致性很有用。
 
 ```bash
 aigne doc translate --glossary @./glossary.md
 ```
 
-#### 3. 提供回饋以優化翻譯風格
+#### 3. 提供回饋以完善翻譯風格
 
-您可以透過提供回饋來指導翻譯風格。例如，若要請求更正式的語氣：
+您可以透過提供回饋來引導翻譯風格。例如，若要請求更正式的語氣：
 
 ```bash
 aigne doc translate --feedback "Use a formal, technical tone for all translations."
 ```
 
-此回饋將記錄在更新文件的歷史記錄中。
+此回饋將記錄在更新後文件的歷史記錄中。
 
 ## 支援的語言
 
-該工具提供 12 種語言的翻譯支援。文件的原生語言是英文（`en`）。
+該工具支援 12 種語言的翻譯。文件的原生語言是英文（`en`）。
 
 | 語言 | 代碼 |
 | :--- | :--- |
@@ -90,6 +90,6 @@ aigne doc translate --feedback "Use a formal, technical tone for all translation
 
 ## 總結
 
-`translate` 指令為您的文件本地化提供了一種結構化的方法。您可以使用其互動模式進行引導式翻譯，或使用命令列選項進行自動化工作流程。使用詞彙表和回饋等功能有助於保持翻譯內容的品質和一致性。
+`translate` 指令提供了一種結構化的方法來本地化您的文件。您可以使用其互動模式進行引導式翻譯，或使用命令列選項進行自動化工作流程。使用詞彙表和回饋等功能有助於保持翻譯內容的品質和一致性。
 
-翻譯完文件後，您可以繼續進行[發布您的文件](./guides-publishing-your-docs.md)。
+翻譯完文件後，您可以繼續進行[發佈您的文件](./guides-publishing-your-docs.md)。

package/docs/guides-translating-documentation.zh.md

@@ -1,16 +1,16 @@
 # 翻译文档
 
-本指南介绍了如何使用 `aigne doc translate` 命令将您生成的文档翻译成多种语言。该过程使用 AI 来确保翻译能够感知上下文并保持技术准确性。
+本指南介绍如何使用 `aigne doc translate` 命令将您生成的文档翻译成多种语言。该过程利用 AI 来确保翻译能够感知上下文并保持技术准确性。
 
-该工具支持 12 种语言，使您能够触达全球受众。您源文档的主要语言将自动从可用翻译语言列表中排除。
+该工具支持 12 种语言，让您的内容能够触达全球受众。您源文档的主要语言将自动从可用翻译语言列表中排除。
 
 ## `translate` 命令
 
-`aigne doc translate` 命令用于为您现有的文档文件生成翻译。您可以以交互方式运行它来选择您想要的文档和语言，也可以使用命令行标志直接指定这些选项以实现自动化工作流。
+`aigne doc translate` 命令用于为现有文档文件生成翻译。您可以以交互方式运行它来选择要翻译的文档和语言，也可以直接使用命令行标志指定这些选项以实现自动化工作流程。
 
 ### 交互模式
 
-若需引导式体验，请不带任何参数运行该命令：
+如需引导式体验，请不带任何参数运行该命令：
 
 ```bash
 aigne doc translate
@@ -18,27 +18,27 @@ aigne doc translate
 
 执行后，该工具将执行以下步骤：
 1.  扫描现有文档。
-2.  提示您从列表中选择希望翻译的特定文档。
-3.  提示您选择目标翻译语言。为方便起见，先前选择的语言将被预先选中。
+2.  提示您从列表中选择要翻译的具体文档。
+3.  提示您选择目标翻译语言。为方便起见，先前选择的语言将被预先勾选。
 4.  为每个选定的文档和语言对开始翻译过程。
-5.  将翻译后的文件保存在相应的特定语言目录中。
+5.  将翻译后的文件保存在同一目录中。新文件通过在原始文件名后附加语言代码来命名（例如，`overview.md` 的中文翻译将变为 `overview.zh.md`）。
 
 ### 命令行选项
 
-对于非交互式使用或编写脚本，您可以使用以下命令行标志来控制翻译过程。
+对于非交互式使用或脚本编写，您可以使用以下命令行标志来控制翻译过程。
 
 <x-field-group>
   <x-field data-name="--docs" data-type="array<string>">
-    <x-field-desc markdown>指定一个或多个要翻译的文档路径。如果未提供，该工具将进入交互模式，让您从可用文档列表中进行选择。</x-field-desc>
+    <x-field-desc markdown>指定要翻译的一个或多个文档路径。如果未提供，该工具将进入交互模式，让您从可用文档列表中进行选择。</x-field-desc>
   </x-field>
   <x-field data-name="--langs" data-type="array<string>">
-    <x-field-desc markdown>指定一个或多个目标语言代码（例如，`zh`、`ja`）。如果省略，系统将提示您以交互方式选择语言。</x-field-desc>
+    <x-field-desc markdown>指定一个或多个目标语言代码（例如 `zh`、`ja`）。如果省略，系统将提示您以交互方式选择语言。</x-field-desc>
   </x-field>
   <x-field data-name="--glossary" data-type="string">
-    <x-field-desc markdown>提供词汇表文件的路径（例如，`@path/to/glossary.md`）。这可确保特定技术术语在所有文档中得到一致的翻译。</x-field-desc>
+    <x-field-desc markdown>提供词汇表文件的路径（例如 `@path/to/glossary.md`）。这可以确保特定技术术语在所有文档中得到一致的翻译。</x-field-desc>
   </x-field>
   <x-field data-name="--feedback" data-type="string">
-    <x-field-desc markdown>提供具体的说明或反馈来指导 AI 的翻译风格，例如调整语气或术语。</x-field-desc>
+    <x-field-desc markdown>提供具体说明或反馈以指导 AI 的翻译风格，例如调整语气或术语。</x-field-desc>
   </x-field>
 </x-field-group>
 
@@ -46,15 +46,15 @@ aigne doc translate
 
 #### 1. 将特定文档翻译成多种语言
 
-要将 `overview.md` 和 `examples.md` 翻译成中文（`zh`）和日文（`ja`）且无需交互式提示：
+要将 `overview.md` 和 `examples.md` 翻译成中文（`zh`）和日文（`ja`），且无需交互式提示：
 
 ```bash
 aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 ```
 
-#### 2. 使用词汇表以确保术语一致
+#### 2. 使用词汇表确保术语一致
 
-为确保技术术语翻译正确，请提供一个词汇表文件。这对于保持品牌名称或专业词汇的一致性非常有用。
+为确保技术术语翻译正确，请提供词汇表文件。这对于保持品牌名称或专业词汇的一致性非常有用。
 
 ```bash
 aigne doc translate --glossary @./glossary.md
@@ -62,7 +62,7 @@ aigne doc translate --glossary @./glossary.md
 
 #### 3. 提供反馈以优化翻译风格
 
-您可以通过提供反馈来指导翻译风格。例如，要请求更正式的语气：
+您可以通过提供反馈来指导翻译风格。例如，要求使用更正式的语气：
 
 ```bash
 aigne doc translate --feedback "Use a formal, technical tone for all translations."
@@ -72,7 +72,7 @@ aigne doc translate --feedback "Use a formal, technical tone for all translation
 
 ## 支持的语言
 
-该工具提供 12 种语言的翻译支持。文档的母语是英语（`en`）。
+该工具支持 12 种语言的翻译。文档的母语是英语（`en`）。
 
 | 语言 | 代码 |
 | :--- | :--- |
@@ -90,6 +90,6 @@ aigne doc translate --feedback "Use a formal, technical tone for all translation
 
 ## 总结
 
-`translate` 命令为本地化您的文档提供了一种结构化的方法。您可以使用其交互模式进行引导式翻译，或使用命令行选项实现自动化工作流。使用词汇表和反馈等功能有助于保持翻译内容的质量和一致性。
+`translate` 命令为本地化文档提供了一种结构化方法。您可以使用其交互模式进行引导式翻译，或使用命令行选项实现自动化工作流程。使用词汇表和反馈等功能有助于保持翻译内容的质量和一致性。
 
 翻译完文档后，您可以继续[发布您的文档](./guides-publishing-your-docs.md)。

package/docs/guides-updating-documentation.ja.md

@@ -1,77 +1,77 @@
 # ドキュメントの更新
 
-ドキュメントの正確性と関連性を維持することは、継続的なプロセスです。コードベースが進化したり、新しいフィードバックを受け取ったりするにつれて、既存のドキュメントを修正する必要があります。`update` コマンドは、新しい指示で特定のドキュメントを再生成するための構造化された方法を提供し、ドキュメントが常に最新の状態に保たれるようにします。
+ドキュメントの正確性と関連性を維持することは、継続的なプロセスです。コードベースが進化したり、新しいフィードバックを受け取ったりするにつれて、既存のドキュメントを修正する必要があります。`update` コマンドは、新しい指示で特定のドキュメントを再生成するための構造化された方法を提供し、ドキュメントを最新の状態に保ちます。
 
-このガイドでは、ドキュメントを更新するための2つの主要な方法について説明します。1つは、詳細な単一ドキュメントの改良のためのインタラクティブモード、もう1つは、一度に複数のドキュメントに変更を適用するためのバッチモードです。
+このガイドでは、ドキュメントを更新するための2つの主要な方法について説明します。1つは、単一ドキュメントの詳細な改良を行うための対話モード、もう1つは、複数のドキュメントに一度に変更を適用するためのバッチモードです。
 
-## 2つの操作モード
+## 2つの動作モード
 
 `update` コマンドは、選択したドキュメントの数と指定したオプションに応じて、2つのモードのいずれかで動作します。
 
-1.  **インタラクティブモード**：`--reset` フラグなしで単一のドキュメントを更新する際にトリガーされます。このモードは、フィードバックを提供し、変更を確認し、ドキュメントが基準を満たすまでプロセスを繰り返すことができる、反復的な改良のために設計されています。
-2.  **バッチモード**：複数のドキュメントを同時に更新する場合、または `--reset` フラグを使用する場合に使用されます。このモードは、フィードバックをすべての選択されたドキュメントに一度の操作で適用するため、広範な変更に効率的です。
+1.  **対話モード**: `--reset` フラグなしで単一のドキュメントを更新する際にトリガーされます。このモードは反復的な改良のために設計されており、フィードバックを提供し、変更を確認し、ドキュメントが基準を満たすまでプロセスを繰り返すことができます。
+2.  **バッチモード**: 複数のドキュメントを同時に更新する場合、または `--reset` フラグを使用する場合に使用されます。このモードは、1回の操作で選択したすべてのドキュメントにフィードバックを適用するため、広範な変更に効率的です。
 
-## インタラクティブモード：単一ドキュメントの改良
+## 対話モード: 単一ドキュメントの改良
 
-インタラクティブモードは、単一のドキュメントに正確な変更を加えるための管理された環境を提供します。特定のフィードバックに基づいてコンテンツを慎重に確認し、調整する必要がある場合に最適な選択肢です。
+対話モードは、単一のドキュメントに正確な変更を加えるための制御された環境を提供します。特定のフィードバックに基づいてコンテンツを慎重に確認し、調整する必要がある場合に最適な選択肢です。
 
-インタラクティブセッションを開始するには、`aigne doc update` コマンドを実行し、リストから単一のドキュメントを選択します。
+対話セッションを開始するには、`aigne doc update` コマンドを実行し、リストから単一のドキュメントを選択します。
 
 ```bash
 aigne doc update
 ```
 
-ツールは以下の手順を案内します：
+ツールは次の手順であなたをガイドします:
 
-1.  **ドキュメント分析**：システムはまず、選択されたドキュメントの構造的なアウトラインを表示し、その主要な見出しを示します。
-2.  **ユーザーアクション**：次に、3つのアクションから1つを選択するよう求められます：
-    *   **ドキュメントを表示**：ドキュメントの現在のバージョンの全内容をターミナルにレンダリングして表示し、簡単に読めるようにします。
-    *   **フィードバックを提供**：「エラーハンドリングに関するセクションを追加してください」から「`config` オブジェクトの目的を明確にしてください」まで、変更リクエストを入力するよう求められます。
-    *   **完了**：インタラクティブセッションを終了し、最後に生成されたバージョンのドキュメントを保存します。
-3.  **コンテンツの再生成**：フィードバックを送信すると、AIがあなたの指示に基づいてドキュメントのコンテンツを再生成します。その後、新しい見出し構造が表示されます。
-4.  **反復または終了**：結果に満足するまで、表示、フィードバック提供、再生成のこのループを続けることができます。「完了」を選択すると、プロセスは完了です。
+1.  **ドキュメント分析**: システムはまず、選択されたドキュメントの構造的なアウトラインを表示し、その主要な見出しを示します。
+2.  **ユーザーアクション**: 次に、3つのアクションのうち1つを選択するよう求められます:
+    *   **ドキュメントの表示**: ドキュメントの現行バージョンの全内容をターミナルにレンダリングして表示し、読みやすくします。
+    *   **フィードバックの提供**: 修正リクエストを入力するよう求められます。これは、「エラー処理に関するセクションを追加してください」から「`config` オブジェクトの目的を明確にしてください」まで、何でもかまいません。
+    *   **完了**: 対話セッションを終了し、最後に生成されたバージョンのドキュメントを保存します。
+3.  **コンテンツの再生成**: フィードバックを送信すると、AIがあなたの指示に基づいてドキュメントのコンテンツを再生成します。その後、新しい見出し構造が表示されます。
+4.  **反復または終了**: 結果に満足するまで、表示、フィードバックの提供、再生成のループを続けることができます。「完了」を選択すると、プロセスは終了です。
 
-この反復的なサイクルにより、最終的な出力に対してきめ細かな制御が可能になり、更新されたドキュメントが正確で完全なものになることが保証されます。
+この反復的なサイクルにより、最終的な出力を微調整でき、更新されたドキュメントが正確かつ完全であることが保証されます。
 
-## バッチモード：複数ドキュメントの更新
+## バッチモード: 複数ドキュメントの更新
 
-バッチモードは、同じ一般的なフィードバックを複数のドキュメントに適用したり、それらを完全に再生成したりする必要がある場合に効率的に設計されています。このモードは、複数のドキュメントを選択した場合や、`--docs` や `--reset` のようなコマンドラインフラグを使用した場合に自動的に有効になります。
+バッチモードは、複数のドキュメントに同じ一般的なフィードバックを適用したり、それらを完全に再生成したりする必要がある場合に、効率性を考慮して設計されています。このモードは、複数のドキュメントを選択した場合、または `--docs` や `--reset` のようなコマンドラインフラグを使用した場合に自動的に有効になります。
 
 ### 特定のフィードバックによる更新
 
-インタラクティブセッションに入ることなく、コマンドラインから直接フィードバックを提供して、1つ以上のドキュメントを更新できます。
+対話セッションに入ることなく、コマンドラインから直接フィードバックを提供して、1つまたは複数のドキュメントを更新できます。
 
-```bash title="フィードバックを付けて単一のドキュメントを更新"
-aigne doc update --docs /guides/overview.md --feedback "Add a section explaining the authentication flow"
+```bash title="フィードバック付きで単一ドキュメントを更新"
+aigne doc update --docs overview.md --feedback "Add a section explaining the authentication flow"
 ```
 
-```bash title="同じフィードバックで複数のドキュメントを更新"
-aigne doc update --docs /guides/overview.md --docs /guides/getting-started.md --feedback "Improve the clarity of all code examples"
+```bash title="複数のドキュメントを同じフィードバックで更新"
+aigne doc update --docs overview.md --docs guides-getting-started.md --feedback "Improve the clarity of all code examples"
 ```
 
 ### リセットと再生成
 
-`--reset` フラグは、ドキュメントの以前のバージョンを無視し、ソースコードに基づいて最初から再生成するようにツールに指示します。これは、コードの大幅な変更により既存のドキュメントが陳腐化した場合に便利です。
+`--reset` フラグは、ツールにドキュメントの以前のバージョンを無視し、ソースコードに基づいてゼロから再生成するよう指示します。これは、コードの大幅な変更によって既存のドキュメントが時代遅れになった場合に便利です。
 
-```bash title="特定のドキュメントを最初から再生成"
-aigne doc update --docs /guides/overview.md --reset
+```bash title="特定のドキュメントをゼロから再生成"
+aigne doc update --docs overview.md --reset
 ```
 
 ## コマンドリファレンス
 
-`update` コマンドは、その動作を制御するためにいくつかのフラグを受け入れます。
+`update` コマンドは、その動作を制御するためのいくつかのフラグを受け入れます。
 
 | パラメータ | 説明 | 例 |
 | :--- | :--- | :--- |
-| `--docs <path>` | 更新する1つ以上のドキュメントパスを指定します。複数回使用できます。 | `--docs /overview --docs /guides/generating-documentation` |
-| `--feedback <text>` | コンテンツの変更点を指示します。 | `--feedback "Add more detail to the installation steps"` |
-| `--glossary <file>` | 再生成時に一貫した用語を確保するために、用語集ファイルを指定します。 | `--glossary @/path/to/glossary.md` |
-| `--reset` | 選択したドキュメントの以前のバージョンを無視して、完全な再生成を強制するブール値フラグ。 | `--reset` |
+| `--docs <path>` | 更新する1つまたは複数のドキュメントパスを指定します。複数回使用できます。 | `--docs overview.md --docs guides-generating-documentation.md` |
+| `--feedback <text>` | コンテンツで何を変更するかについての指示を提供します。 | `--feedback "インストール手順に詳細を追加してください"` |
+| `--glossary <file>` | 再生成時に一貫した用語を保証するために、用語集ファイルを指定します。 | `--glossary @/path/to/glossary.md` |
+| `--reset` | 選択したドキュメントの以前のバージョンを無視して、完全な再生成を強制するブール型フラグです。 | `--reset` |
 
-## まとめ
+## 概要
 
-`update` コマンドは、ドキュメントをプロジェクトと整合性を保つための柔軟なワークフローを提供します。単一ドキュメントの詳細な反復的な変更にはインタラクティブモードを使用し、複数のファイルにわたる広範な更新を効率的に適用するにはバッチモードを使用してください。
+`update` コマンドは、ドキュメントをプロジェクトと整合性を保つための柔軟なワークフローを提供します。単一ドキュメントの詳細で反復的な変更には対話モードを、複数のファイルにわたる広範な更新を効率的に適用するにはバッチモードを使用してください。
 
-関連タスクについては、以下のガイドを参照してください：
+関連タスクについては、以下のガイドを参照してください:
 - [ドキュメントの生成](./guides-generating-documentation.md)
 - [ドキュメントの翻訳](./guides-translating-documentation.md)

package/docs/guides-updating-documentation.md

@@ -42,11 +42,11 @@ Batch mode is designed for efficiency when you need to apply the same general fe
 You can provide feedback directly from the command line to update one or more documents without entering an interactive session.
 
 ```bash title="Update a single document with feedback"
-aigne doc update --docs /guides/overview.md --feedback "Add a section explaining the authentication flow"
+aigne doc update --docs overview.md --feedback "Add a section explaining the authentication flow"
 ```
 
 ```bash title="Update multiple documents with the same feedback"
-aigne doc update --docs /guides/overview.md --docs /guides/getting-started.md --feedback "Improve the clarity of all code examples"
+aigne doc update --docs overview.md --docs guides-getting-started.md --feedback "Improve the clarity of all code examples"
 ```
 
 ### Resetting and Regenerating
@@ -54,7 +54,7 @@ aigne doc update --docs /guides/overview.md --docs /guides/getting-started.md --
 The `--reset` flag instructs the tool to ignore the previous versions of the documents and regenerate them from scratch based on the source code. This is useful when significant changes in the code have made the existing documentation obsolete.
 
 ```bash title="Regenerate a specific document from scratch"
-aigne doc update --docs /guides/overview.md --reset
+aigne doc update --docs overview.md --reset
 ```
 
 ## Command Reference
@@ -63,7 +63,7 @@ The `update` command accepts several flags to control its behavior.
 
 | Parameter | Description | Example |
 | :--- | :--- | :--- |
-| `--docs <path>` | Specifies one or more document paths to update. Can be used multiple times. | `--docs /overview --docs /guides/generating-documentation` |
+| `--docs <path>` | Specifies one or more document paths to update. Can be used multiple times. | `--docs overview.md --docs guides-generating-documentation.md` |
 | `--feedback <text>` | Provides instructions for what to change in the content. | `--feedback "Add more detail to the installation steps"` |
 | `--glossary <file>` | Specifies a glossary file to ensure consistent terminology during regeneration. | `--glossary @/path/to/glossary.md` |
 | `--reset` | A boolean flag that forces a complete regeneration of the selected documents, ignoring their previous versions. | `--reset` |

package/docs/guides-updating-documentation.zh-TW.md

@@ -1,21 +1,21 @@
 # 更新文件
 
-維護文件的準確性和相關性是一個持續的過程。隨著您的程式碼庫不斷演進或收到新的回饋，您將需要修改現有的文件。`update` 指令提供了一種結構化的方式，可根據新的指示重新產生特定文件，確保其保持最新狀態。
+維護文件的準確性和相關性是一個持續的過程。隨著您的程式碼庫不斷演進或收到新的回饋，您將需要修改現有文件。`update` 指令提供了一種結構化的方法，可根據新的指示重新生成特定文件，確保它們保持最新。
 
-本指南將說明更新文件的兩種主要方法：用於詳細、單一文件優化的互動模式，以及一次性將變更應用於多個文件的批次模式。
+本指南將說明更新文件的兩種主要方法：用於詳細、單一文件精修的互動模式，以及一次性將變更應用於多個文件的批次模式。
 
 ## 兩種操作模式
 
-`update` 指令根據您選擇的文件數量和提供的選項，在兩種模式之一中運作。
+`update` 指令根據您選擇的文件數量和提供的選項，以兩種模式之一運行。
 
-1.  **互動模式**：當您更新單一文件且未使用 `--reset` 旗標時觸發。此模式專為迭代優化而設計，讓您可以提供回饋、檢視變更並重複此過程，直到文件符合您的標準為止。
-2.  **批次模式**：當您同時更新多個文件或使用 `--reset` 旗標時使用。此模式會在一次操作中將您的回饋應用於所有選定的文件，對於廣泛的變更而言非常有效率。
+1.  **互動模式**：當您更新單一文件且未使用 `--reset` 旗標時觸發。此模式專為迭代式精修而設計，讓您可以提供回饋、檢視變更，並重複此過程，直到文件符合您的標準。
+2.  **批次模式**：當您同時更新多個文件或使用 `--reset` 旗標時使用。此模式將您的回饋一次性應用於所有選定的文件，對於進行廣泛變更而言非常有效率。
 
-## 互動模式：優化單一文件
+## 互動模式：精修單一文件
 
 互動模式提供了一個受控的環境，可對單一文件進行精確的變更。當您需要根據特定回饋仔細檢視和調整內容時，這是理想的選擇。
 
-若要啟動互動式會話，請執行 `aigne doc update` 指令並從清單中選擇單一文件。
+若要啟動互動式會話，請執行 `aigne doc update` 指令，並從列表中選擇一個文件。
 
 ```bash
 aigne doc update
@@ -24,37 +24,37 @@ aigne doc update
 該工具將引導您完成以下步驟：
 
 1.  **文件分析**：系統首先會顯示所選文件的結構大綱，展示其主要標題。
-2.  **使用者操作**：接著系統會提示您選擇以下三種操作之一：
-    *   **檢視文件**：顯示文件目前版本的完整內容，並在您的終端機中呈現以便於閱讀。
+2.  **使用者操作**：接著會提示您選擇以下三種操作之一：
+    *   **檢視文件**：顯示文件當前版本的完整內容，並在您的終端機中呈現以便閱讀。
     *   **提供回饋**：提示您輸入修改請求。這可以是任何內容，從「新增一個關於錯誤處理的章節」到「闡明 `config` 物件的用途」。
-    *   **完成**：退出互動式會話並儲存最後產生的文件版本。
-3.  **內容重新產生**：在您提交回饋後，AI 會根據您的指示重新產生文件內容。然後會顯示新的標題結構。
-4.  **迭代或完成**：您可以繼續這個檢視、提供回饋和重新產生的循環，直到您對結果滿意為止。一旦您選擇「完成」，此過程即告結束。
+    *   **完成**：退出互動式會話並儲存最後生成的文件版本。
+3.  **內容重新生成**：在您提交回饋後，AI 會根據您的指示重新生成文件內容。接著會顯示新的標題結構。
+4.  **迭代或完成**：您可以持續這個檢視、提供回饋和重新生成的循環，直到您對結果滿意為止。一旦您選擇「完成」，流程即告結束。
 
-這種迭代循環可以對最終輸出進行微調控制，確保更新後的文件準確且完整。
+這種迭代循環可以對最終產出進行精細的控制，確保更新後的文件準確且完整。
 
 ## 批次模式：更新多個文件
 
-當您需要將相同的通用回饋應用於多個文件或完全重新產生它們時，批次模式是為效率而設計的。如果您選擇了多個文件或使用 `--docs` 或 `--reset` 等命令列旗標，此模式將自動啟動。
+當您需要將相同的通用回饋應用於多個文件或完全重新生成它們時，批次模式是為效率而設計的。如果您選擇了多個文件，或使用了像 `--docs` 或 `--reset` 這樣的命令列旗標，此模式將會自動啟動。
 
 ### 使用特定回饋進行更新
 
 您可以直接從命令列提供回饋來更新一個或多個文件，而無需進入互動式會話。
 
 ```bash title="使用回饋更新單一文件"
-aigne doc update --docs /guides/overview.md --feedback "Add a section explaining the authentication flow"
+aigne doc update --docs overview.md --feedback "Add a section explaining the authentication flow"
 ```
 
 ```bash title="使用相同的回饋更新多個文件"
-aigne doc update --docs /guides/overview.md --docs /guides/getting-started.md --feedback "Improve the clarity of all code examples"
+aigne doc update --docs overview.md --docs guides-getting-started.md --feedback "Improve the clarity of all code examples"
 ```
 
-### 重設與重新產生
+### 重設與重新生成
 
-`--reset` 旗標指示工具忽略文件的先前版本，並根據原始程式碼從頭開始重新產生它們。當程式碼中的重大變更使現有文件過時時，這非常有用。
+`--reset` 旗標指示工具忽略文件先前的版本，並根據原始碼從頭開始重新生成它們。當程式碼發生重大變更，導致現有文件過時時，這個功能非常有用。
 
-```bash title="從頭開始重新產生特定文件"
-aigne doc update --docs /guides/overview.md --reset
+```bash title="從頭開始重新生成特定文件"
+aigne doc update --docs overview.md --reset
 ```
 
 ## 指令參考
@@ -63,15 +63,15 @@ aigne doc update --docs /guides/overview.md --reset
 
 | 參數 | 說明 | 範例 |
 | :--- | :--- | :--- |
-| `--docs <path>` | 指定要更新的一個或多個文件路徑。可多次使用。 | `--docs /overview --docs /guides/generating-documentation` |
-| `--feedback <text>` | 提供內容變更的指示。 | `--feedback "為安裝步驟新增更多細節"` |
-| `--glossary <file>` | 指定一個術語表檔案，以確保在重新產生過程中術語的一致性。 | `--glossary @/path/to/glossary.md` |
-| `--reset` | 一個布林旗標，強制完全重新產生所選文件，忽略其先前版本。 | `--reset` |
+| `--docs <path>` | 指定要更新的一個或多個文件路徑。可多次使用。 | `--docs overview.md --docs guides-generating-documentation.md` |
+| `--feedback <text>` | 提供內容修改的指示。 | `--feedback "Add more detail to the installation steps"` |
+| `--glossary <file>` | 指定一個詞彙表檔案，以確保重新生成時術語的一致性。 | `--glossary @/path/to/glossary.md` |
+| `--reset` | 一個布林旗標，強制完全重新生成所選文件，忽略其先前的版本。 | `--reset` |
 
 ## 總結
 
-`update` 指令提供了一個靈活的工作流程，讓您的文件與專案保持一致。使用互動模式對單一文件進行詳細的迭代變更，並使用批次模式有效率地將廣泛的更新應用於多個檔案。
+`update` 指令提供了一個靈活的工作流程，讓您的文件與您的專案保持一致。對於單一文件，使用互動模式進行詳細、迭代的變更；對於多個檔案，使用批次模式有效率地應用廣泛的更新。
 
-如需相關任務，請參閱以下指南：
-- [產生文件](./guides-generating-documentation.md)
+有關相關任務，請參閱以下指南：
+- [生成文件](./guides-generating-documentation.md)
 - [翻譯文件](./guides-translating-documentation.md)