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

package/docs/configuration-preferences.zh.md

@@ -1,68 +1,83 @@
 # 管理偏好设置
 
-AIGNE DocSmith 旨在从您的反馈中学习。当您优化或更正生成的内容时，DocSmith 可以将该反馈转换为持久性规则，称为偏好设置。这些规则确保您特定的风格、结构要求和内容策略在未来的文档任务中得到一致的应用。所有偏好设置都存储在项目根目录下一个人类可读的 YAML 文件中，路径为 `.aigne/doc-smith/preferences.yml`。
+AIGNE DocSmith 旨在从您的反馈中学习。当您优化或纠正生成的内容时，DocSmith 可以将该反馈转换为持久性规则，称为偏好设置。这些规则确保您特定的风格、结构要求和内容策略在未来的文档任务中得到一致的应用。所有偏好设置都存储在位于您项目根目录下的一个人类可读的 YAML 文件中：`.aigne/doc-smith/preferences.yml`。
 
 ## 偏好设置的生命周期
 
-下图说明了您的反馈如何成为一个可重用的规则，该规则可以应用于未来的任务，并可以通过命令行进行管理。
+下图说明了您的反馈如何成为一个可重用的规则，该规则可以应用于未来的任务并通过命令行进行管理。
 
 ```d2 偏好设置的生命周期
 direction: down
 
-feedback: {
-  label: "1. 用户在“优化”或“翻译”期间\n提供反馈"
-  shape: rectangle
+developer: {
+  label: "开发者"
+  shape: person
 }
 
-refiner: {
-  label: "2. 反馈优化 Agent\n分析反馈"
+docsmith_system: {
+  label: "AIGNE DocSmith 系统"
   shape: rectangle
-}
 
-decision: {
-  label: "这是一个可重用的策略吗？"
-  shape: diamond
+  cli: {
+    label: "CLI 命令\n(refine / translate)"
+    shape: rectangle
+  }
+
+  agent: {
+    label: "内部分析 Agent"
+    shape: rectangle
+  }
+
+  decision: {
+    label: "反馈是否为\n可重用策略？"
+    shape: diamond
+  }
+
+  create_rule: {
+    label: "创建新偏好规则"
+    shape: rectangle
+  }
 }
 
-pref_file: {
-  label: "3. preferences.yml\n规则已保存"
+preferences_file: {
+  label: ".aigne/doc-smith/preferences.yml"
   shape: cylinder
 }
 
-future_tasks: {
-  label: "4. 未来的任务\n应用已保存的规则"
-  shape: rectangle
-}
-
-cli: {
-  label: "5. CLI 管理\n('aigne doc prefs')"
-  shape: rectangle
+one_time_fix: {
+  label: "作为一次性修复应用"
+  shape: oval
 }
 
-feedback -> refiner: "输入"
-refiner -> decision: "分析"
-decision -> pref_file: "是"
-decision -> "丢弃（一次性修复）": "否"
-pref_file -> future_tasks: "应用于"
-cli <-> pref_file: "管理"
-
+developer -> docsmith_system.cli: "1. 提供反馈"
+docsmith_system.cli -> docsmith_system.agent: "2. 捕获反馈"
+docsmith_system.agent -> docsmith_system.decision: "3. 分析"
+docsmith_system.decision -> docsmith_system.create_rule: "是"
+docsmith_system.create_rule -> preferences_file: "4. 将规则保存到文件"
+docsmith_system.decision -> one_time_fix: "否"
 ```
 
 ### 如何创建偏好设置
 
-当您在 `refine` 或 `translate` 阶段提供反馈时，一个内部 Agent 会分析您的输入。它会判断反馈是一次性修复（例如，更正拼写错误）还是可重用的策略（例如，“始终用英语编写代码注释”）。如果它代表一个持久的指令，它就会创建一个新的偏好设置规则。
+当您在 `refine` 或 `translate` 阶段提供反馈时，一个内部 Agent 会分析您的输入。它会判断该反馈是一次性修复（例如，纠正拼写错误）还是可重用策略（例如，“代码注释必须用英文编写”）。如果它代表一个持久性指令，Agent 就会创建一条新的偏好规则并将其保存到您项目的 `preferences.yml` 文件中。
 
 ### 规则属性
 
-保存在 `preferences.yml` 中的每个规则都具有以下结构：
-
-<x-field data-name="id" data-type="string" data-desc="规则的唯一、随机生成的标识符（例如，pref_a1b2c3d4e5f6g7h8）。"></x-field>
-<x-field data-name="active" data-type="boolean" data-desc="指示规则当前是否已启用。在生成任务期间，非活动规则将被忽略。"></x-field>
-<x-field data-name="scope" data-type="string" data-desc="定义规则应在何时应用。有效范围是 'global'、'structure'、'document' 或 'translation'。"></x-field>
-<x-field data-name="rule" data-type="string" data-desc="将在未来任务中传递给 AI 的具体、精炼的指令。"></x-field>
-<x-field data-name="feedback" data-type="string" data-desc="用户提供的原始自然语言反馈，保留以供参考。"></x-field>
-<x-field data-name="createdAt" data-type="string" data-desc="表示规则创建时间的 ISO 8601 时间戳。"></x-field>
-<x-field data-name="paths" data-type="string[]" data-required="false" data-desc="一个可选的文件路径列表。如果存在，该规则仅适用于为这些特定源文件生成的内容。"></x-field>
+保存在 `preferences.yml` 中的每条规则都具有以下结构：
+
+<x-field-group>
+  <x-field data-name="id" data-type="string" data-desc="规则的唯一、随机生成的标识符（例如，pref_a1b2c3d4e5f6g7h8）。"></x-field>
+  <x-field data-name="active" data-type="boolean" data-desc="指示规则当前是否已启用。未激活的规则在生成任务期间将被忽略。"></x-field>
+  <x-field data-name="scope" data-type="string">
+    <x-field-desc markdown>定义规则何时应用。有效范围是 `global`、`structure`、`document` 或 `translation`。</x-field-desc>
+  </x-field>
+  <x-field data-name="rule" data-type="string" data-desc="将在未来任务中传递给 AI 的具体、提炼后的指令。"></x-field>
+  <x-field data-name="feedback" data-type="string" data-desc="用户提供的原始自然语言反馈，保留以供参考。"></x-field>
+  <x-field data-name="createdAt" data-type="string" data-desc="指示规则创建时间的 ISO 8601 时间戳。"></x-field>
+  <x-field data-name="paths" data-type="string[]" data-required="false">
+    <x-field-desc markdown>一个可选的文件路径列表。如果存在，该规则仅适用于为这些特定源文件生成的内容。</x-field-desc>
+  </x-field>
+</x-field-group>
 
 ## 使用 CLI 管理偏好设置
 
@@ -70,39 +85,39 @@ cli <-> pref_file: "管理"
 
 ### 列出所有偏好设置
 
-要查看所有已保存的偏好设置（包括活动的和非活动的），请使用 `--list` 标志。
+要查看所有已保存的偏好设置（包括激活和未激活的）的完整列表，请使用 `--list` 标志。
 
 ```bash 列出所有偏好设置 icon=lucide:terminal
 aigne doc prefs --list
 ```
 
-该命令会显示一个格式化的列表，显示每个规则的状态、范围、ID 和任何路径限制。
+该命令会显示一个格式化的列表，其中显示了每条规则的状态、范围、ID 以及任何路径限制。
 
-```text 示例输出 icon=lucide:clipboard-list
+```text 输出示例 icon=lucide:clipboard-list
 # 用户偏好设置
 
 **格式说明：**
-- 🟢 = 活动偏好设置，⚪ = 非活动偏好设置
-- [scope] = 偏好设置范围 (global, structure, document, translation)
-- ID = 唯一偏好设置标识符
-- Paths = 特定文件路径（如果适用）
+- 🟢 = 激活的偏好设置, ⚪ = 未激活的偏好设置
+- [scope] = 偏好范围 (global, structure, document, translation)
+- ID = 唯一偏好标识符
+- Paths = 特定文件路径 (如果适用)
 
 🟢 [structure] pref_a1b2c3d4e5f6g7h8 | Paths: overview.md
-   在概述文档的末尾添加一个“后续步骤”部分。
+   在概览文档末尾添加一个“后续步骤”部分。
  
 ⚪ [document] pref_i9j0k1l2m3n4o5p6
-   代码注释必须用英语编写。
+   代码注释必须用英文编写。
 ```
 
 ### 停用和重新激活偏好设置
 
-如果您想暂时禁用某个规则而不删除它，可以使用 `--toggle` 标志来切换其活动状态。在不带 ID 的情况下运行该命令将启动交互模式，允许您选择一个或多个偏好设置进行切换。
+如果您需要暂时禁用某条规则而不删除它，可以使用 `--toggle` 标志切换其激活状态。在不带 ID 的情况下运行该命令将启动交互模式，允许您选择一个或多个偏好设置进行切换。
 
 ```bash 以交互方式切换偏好设置 icon=lucide:terminal
 aigne doc prefs --toggle
 ```
 
-要直接切换特定规则，请使用 `--id` 标志提供其 ID。这对应于 `deactivateRule` 函数，该函数将规则的 `active` 属性设置为 `false`。
+要直接切换特定规则，请使用 `--id` 标志提供其 ID。此操作会更改规则的 `active` 属性。
 
 ```bash 切换特定偏好设置 icon=lucide:terminal
 aigne doc prefs --toggle --id pref_i9j0k1l2m3n4o5p6
@@ -110,15 +125,15 @@ aigne doc prefs --toggle --id pref_i9j0k1l2m3n4o5p6
 
 ### 删除偏好设置
 
-要永久删除一个或多个偏好设置，请使用 `--remove` 标志。此操作对应于 `removeRule` 函数，且无法撤销。
+要永久删除一个或多个偏好设置，请使用 `--remove` 标志。此操作无法撤销。
 
-要进入交互式选择提示，请在不带 ID 的情况下运行该命令。
+要获得交互式选择提示，请在不带 ID 的情况下运行该命令。
 
 ```bash 以交互方式删除偏好设置 icon=lucide:terminal
 aigne doc prefs --remove
 ```
 
-要通过其 ID 直接删除特定规则，请使用 `--id` 标志。
+要直接删除特定规则，请使用 `--id` 标志提供其 ID。
 
 ```bash 删除特定偏好设置 icon=lucide:terminal
 aigne doc prefs --remove --id pref_a1b2c3d4e5f6g7h8
@@ -126,4 +141,4 @@ aigne doc prefs --remove --id pref_a1b2c3d4e5f6g7h8
 
 ## 后续步骤
 
-管理偏好设置是根据项目特定需求定制 DocSmith 的关键部分。要了解更多自定义选项，请探索主要的[配置指南](./configuration.md)。
+管理偏好设置是根据项目特定需求定制 DocSmith 的关键部分。有关更多自定义选项，请浏览主要的[配置指南](./configuration.md)。

package/docs/configuration.ja.md

@@ -1,87 +1,71 @@
 # 設定ガイド
 
-AIGNE DocSmithの動作は、中央設定ファイル`.aigne/doc-smith/config.yaml`によって制御されます。このファイルを使用すると、ドキュメントのスタイル、対象読者、言語、構造を特定のニーズに合わせてカスタマイズできます。
+AIGNE DocSmith の動作は、中央設定ファイル `.aigne/doc-smith/config.yaml` によって制御されます。このファイルを使用して、ドキュメントのスタイル、対象読者、言語、構造を特定のニーズに合わせてカスタマイズできます。
 
-`aigne doc init`を実行して、対話式セットアップウィザードを使用してこのファイルを作成および管理できます。ステップバイステップのウォークスルーについては、[対話式セットアップ](./configuration-interactive-setup.md)ガイドを参照してください。あるいは、より詳細な制御のためにファイルを直接編集することもできます。
+`aigne doc init` を実行して、対話式のセットアップウィザードを使用してこのファイルを作成および管理できます。手順ごとのウォークスルーについては、[対話式セットアップ](./configuration-interactive-setup.md)ガイドを参照してください。または、ファイルを直接編集して、より詳細な制御を行うこともできます。
 
 以下の図は、設定のワークフローを示しています。
 
 ```d2 設定ワークフロー
 direction: down
 
-ユーザー: {
-  shape: c4-person
+User: {
+  shape: person
 }
 
 CLI: {
-  label: "`aigne doc init`\n(対話式セットアップ)"
+  label: "コマンド実行\n'aigne doc init'"
   shape: rectangle
 }
 
-ConfigFile: {
-  label: ".aigne/doc-smith/config.yaml"
+Setup-Wizard: {
+  label: "対話式セットアップウィザード"
   shape: rectangle
-  
-  プロジェクト情報: {
-    label: "プロジェクト情報"
-    shape: rectangle
-  }
-  
-  ドキュメント戦略: {
-    label: "ドキュメント戦略"
-    shape: rectangle
-  }
-  
-  カスタムディレクティブ: {
-    label: "カスタムディレクティブ"
-    shape: rectangle
-  }
-  
-  言語とパスの設定: {
-    label: "言語とパスの設定"
-    shape: rectangle
-  }
 }
 
-AIGNE-DocSmith: {
-  label: "AIGNE DocSmith\n(生成プロセス)"
-  icon: "https://www.arcblock.io/image-bin/uploads/89a24f04c34eca94f26c9dd30aec44fc.png"
+Config-File: {
+  label: ".aigne/doc-smith/config.yaml"
+  shape: rectangle
 }
 
-生成されたドキュメント: {
-  label: "生成されたドキュメント"
-  shape: rectangle
+AIGNE-DocSmith-Engine: {
+  label: "AIGNE DocSmith エンジン"
 }
 
-ユーザー -> CLI: "実行"
-CLI -> ConfigFile: "作成/変更"
-ユーザー -> ConfigFile: "直接編集"
-ConfigFile -> AIGNE-DocSmith: "制御"
-AIGNE-DocSmith -> 生成されたドキュメント: "生成"
+# パス1: 対話式セットアップ (推奨)
+User -> CLI: "推奨パス"
+CLI -> Setup-Wizard: "起動"
+Setup-Wizard -> Config-File: "作成 / 変更"
+
+# パス2: 手動編集
+User -> Config-File: "代替パス:\n直接編集"
+
+# 最終ステップ
+Config-File -> AIGNE-DocSmith-Engine: "設定"
 ```
 
-## 主要な設定エリア
+## 主要な設定領域
 
-ドキュメントは、いくつかの主要な設定エリアによって形成されます。これらのガイドを参照して、生成プロセスの各側面を微調整する方法を理解してください。
+ドキュメントは、いくつかの主要な設定領域によって形成されます。これらのガイドを参照して、生成プロセスの各側面を微調整する方法を理解してください。
 
 <x-cards data-columns="2">
   <x-card data-title="対話式セットアップ" data-icon="lucide:wand-2" data-href="/configuration/interactive-setup">
     推奨設定や競合検出を含む、ドキュメントプロジェクトの設定を支援するガイド付きウィザードについて学びます。
   </x-card>
-  <x-card data-title="LLMセットアップ" data-icon="lucide:brain-circuit" data-href="/configuration/llm-setup">
-    APIキーが不要な組み込みのAIGNE Hubの使用方法など、さまざまなAIモデルの接続方法をご覧ください。
+  <x-card data-title="LLM セットアップ" data-icon="lucide:brain-circuit" data-href="/configuration/llm-setup">
+    APIキーが不要な組み込みのAIGNEハブの使用を含む、さまざまなAIモデルの接続方法を発見します。
   </x-card>
   <x-card data-title="言語サポート" data-icon="lucide:languages" data-href="/configuration/language-support">
-    サポートされている言語の全リストを確認し、主要言語の設定方法や自動翻訳の有効化について学びます。
+    サポートされている言語の全リストを確認し、主要言語の設定方法や自動翻訳の有効化方法を学びます。
   </x-card>
   <x-card data-title="設定の管理" data-icon="lucide:sliders-horizontal" data-href="/configuration/preferences">
-    DocSmithがフィードバックを利用して永続的なルールを作成する方法と、CLIを介してそれらを管理する方法を理解します。
+    DocSmithがフィードバックを使用して永続的なルールを作成する方法と、CLIを介してそれらを管理する方法を理解します。
   </x-card>
 </x-cards>
 
 ## パラメータリファレンス
 
-`config.yaml`ファイルには、ドキュメントの出力を制御するいくつかのキーと値のペアが含まれています。以下は、各パラメータの詳細なリファレンスです。
+`config.yaml` ファイルには、ドキュメントの出力を制御するいくつかのキーと値のペアが含まれています。以下は、各パラメータの詳細なリファレンスです。
 
 ### プロジェクト情報
 
@@ -89,56 +73,56 @@ AIGNE-DocSmith -> 生成されたドキュメント: "生成"
 
 | パラメータ | 説明 |
 |---|---|
-| `projectName` | プロジェクトの名前。`package.json`が存在する場合、そこから検出されます。 |
-| `projectDesc` | プロジェクトの簡単な説明。`package.json`から検出されます。 |
-| `projectLogo` | プロジェクトのロゴ画像へのパスまたはURL。 |
+| `projectName` | プロジェクトの名前。`package.json` があればそこから検出されます。 |
+| `projectDesc` | プロジェクトの短い説明。`package.json` から検出されます。 |
+| `projectLogo` | プロジェクトのロゴ画像へのパスまたは URL。 |
 
-### ドキュメント戦略
+### ドキュメンテーション戦略
 
 これらのパラメータは、生成されるコンテンツのトーン、スタイル、深さを定義します。
 
 #### `documentPurpose`
-読者に達成してほしい主な成果を定義します。この設定は、ドキュメント全体の構造と焦点に影響を与えます。
+読者に達成してもらいたい主な成果を定義します。この設定は、ドキュメントの全体的な構造と焦点に影響を与えます。
 
 | オプション | 名前 | 説明 |
 |---|---|---|
-| `getStarted` | すぐに始める | 新規ユーザーが30分未満でゼロから作業を開始できるように支援します。 |
+| `getStarted` | 迅速な開始 | 新規ユーザーが30分未満でゼロから作業を開始できるように支援します。 |
 | `completeTasks` | 特定のタスクを完了する | 一般的なワークフローとユースケースを通じてユーザーをガイドします。 |
-| `findAnswers` | 素早く答えを見つける | すべての機能とAPIに対して検索可能なリファレンスを提供します。 |
+| `findAnswers` | 迅速に答えを見つける | すべての機能とAPIの検索可能なリファレンスを提供します。 |
 | `understandSystem`| システムを理解する | それがどのように機能し、なぜ設計上の決定がなされたかを説明します。 |
-| `solveProblems` | 一般的な問題をトラブルシューティングする | ユーザーが問題をトラブルシューティングし、修正するのを支援します。 |
+| `solveProblems` | 一般的な問題のトラブルシューティング | ユーザーが問題をトラブルシューティングし、修正するのを助けます。 |
 | `mixedPurpose` | 複数の目的を果たす | 複数のニーズをカバーするドキュメント。 |
 
 #### `targetAudienceTypes`
-誰がこのドキュメントを最も頻繁に読むかを定義します。この選択は、ライティングスタイルと例に影響します。
+このドキュメントを最も頻繁に読むであろう人物を定義します。この選択は、ライティングスタイルと例に影響を与えます。
 
 | オプション | 名前 | 説明 |
 |---|---|---|
 | `endUsers` | エンドユーザー（非技術者） | 製品を使用するがコーディングはしない人々。 |
 | `developers` | 製品/APIを統合する開発者 | これを自分のプロジェクトに追加するエンジニア。 |
-| `devops` | DevOps / SRE / インフラチーム | システムをデプロイ、監視、維持するチーム。 |
+| `devops` | DevOps / SRE / インフラストラクチャチーム | システムの展開、監視、保守を行うチーム。 |
 | `decisionMakers`| 技術的な意思決定者 | 実装を評価または計画するアーキテクトやリード。 |
 | `supportTeams` | サポートチーム | 他の人が製品を使用するのを助ける人々。 |
-| `mixedTechnical`| 混合技術者オーディエンス | 開発者、DevOps、その他の技術ユーザー。 |
+| `mixedTechnical`| 混合技術オーディエンス | 開発者、DevOps、その他の技術ユーザー。 |
 
 #### `readerKnowledgeLevel`
-読者が通常、どのような知識を持っているかを定義します。これにより、どれだけの基礎知識が前提とされるかが調整されます。
+読者が通常、到着時に何を知っているかを定義します。これにより、どれだけの基礎知識が前提とされるかが調整されます。
 
 | オプション | 名前 | 説明 |
 |---|---|---|
-| `completeBeginners` | 完全な初心者、ゼロから始める | このドメイン/技術に全く新しい。 |
-| `domainFamiliar` | 以前に類似のツールを使用したことがある | 問題領域は知っているが、この特定のソリューションは初めて。 |
+| `completeBeginners` | 完全な初心者で、ゼロから始める | このドメイン/テクノロジーに全く新しい。 |
+| `domainFamiliar` | 以前に類似のツールを使用したことがある | 問題領域は知っているが、この特定の解決策には新しい。 |
 | `experiencedUsers` | 特定のことをしようとしている専門家 | リファレンスや高度なトピックを必要とする通常のユーザー。 |
 | `emergencyTroubleshooting`| 緊急/トラブルシューティング | 何かが壊れており、迅速に修正する必要がある。 |
 | `exploringEvaluating` | このツールを他と比較評価している | これが自分のニーズに合うかどうかを理解しようとしている。 |
 
 #### `documentationDepth`
-ドキュメントがどの程度包括的であるべきかを定義します。
+ドキュメントがどれだけ包括的であるべきかを定義します。
 
 | オプション | 名前 | 説明 |
 |---|---|---|
-| `essentialOnly` | 必須事項のみ | 80%のユースケースをカバーし、簡潔に保ちます。 |
-| `balancedCoverage`| バランスの取れたカバレッジ | 実践的な例を含む適切な深さ[推奨]。 |
+| `essentialOnly` | 不可欠なもののみ | 80%のユースケースをカバーし、簡潔に保ちます。 |
+| `balancedCoverage`| バランスの取れたカバレッジ | 実用的な例を含む適切な深さ [推奨]。 |
 | `comprehensive` | 包括的 | すべての機能、エッジケース、高度なシナリオをカバーします。 |
 | `aiDecide` | AIに決定させる | コードの複雑さを分析し、適切な深さを提案します。 |
 
@@ -149,7 +133,7 @@ AIGNE-DocSmith -> 生成されたドキュメント: "生成"
 | パラメータ | 説明 |
 |---|---|
 | `rules` | 特定のドキュメント生成ルール（例：「常にパフォーマンスベンチマークを含める」）を定義できる複数行の文字列。 |
-| `targetAudience`| プリセットで許容されるよりも詳細に特定の対象読者を記述するための複数行の文字列。 |
+| `targetAudience`| プリセットで許容されるよりも詳細に特定のターゲットオーディエンスを記述するための複数行の文字列。 |
 
 ### 言語とパスの設定
 
@@ -157,54 +141,54 @@ AIGNE-DocSmith -> 生成されたドキュメント: "生成"
 
 | パラメータ | 説明 |
 |---|---|
-| `locale` | ドキュメントの主要言語（例：`en`, `zh`）。 |
+| `locale` | ドキュメントの主要言語（例：`en`、`zh`）。 |
 | `translateLanguages` | ドキュメントを翻訳する言語コードのリスト（例：`[ja, fr, es]`）。 |
 | `docsDir` | 生成されたドキュメントファイルが保存されるディレクトリ。 |
-| `sourcesPath` | DocSmithが分析するためのソースコードパスまたはglobパターンのリスト（例：`['./src', './lib/**/*.js']`）。 |
+| `sourcesPath` | DocSmithが分析するソースコードのパスまたはグロブパターンのリスト（例：`['./src', './lib/**/*.js']`）。 |
 | `glossary` | 一貫した翻訳を保証するために、プロジェクト固有の用語を含むマークダウンファイル（`@glossary.md`）へのパス。 |
 
 ## config.yaml の例
 
-これは完全な設定ファイルの例です。このファイルを直接編集して、いつでも設定を変更できます。
+以下は、完全な設定ファイルの例です。このファイルを直接編集して、いつでも設定を変更できます。
 
 ```yaml config.yaml の例 icon=logos:yaml
-# ドキュメント公開用のプロジェクト情報
+# ドキュメント公開のためのプロジェクト情報
 projectName: AIGNE DocSmith
-projectDesc: An AI-driven documentation generation tool.
+projectDesc: AI駆動のドキュメント生成ツール。
 projectLogo: https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png
 
 # =============================================================================
 # ドキュメント設定
 # =============================================================================
 
-# 目的：読者に達成してほしい主な成果は何か？
-# オプション：getStarted, completeTasks, findAnswers, understandSystem, solveProblems, mixedPurpose
+# 目的: 読者に達成してもらいたい主な成果は何か？
+# オプション: getStarted, completeTasks, findAnswers, understandSystem, solveProblems, mixedPurpose
 documentPurpose:
   - completeTasks
   - findAnswers
 
-# 対象読者：誰がこれを最も頻繁に読むか？
-# オプション：endUsers, developers, devops, decisionMakers, supportTeams, mixedTechnical
+# 対象読者: これを最も頻繁に読むのは誰か？
+# オプション: endUsers, developers, devops, decisionMakers, supportTeams, mixedTechnical
 targetAudienceTypes:
   - developers
 
-# 読者の知識レベル：読者は通常、どのような知識を持っているか？
-# オプション：completeBeginners, domainFamiliar, experiencedUsers, emergencyTroubleshooting, exploringEvaluating
+# 読者の知識レベル: 読者は通常、到着時に何を知っているか？
+# オプション: completeBeginners, domainFamiliar, experiencedUsers, emergencyTroubleshooting, exploringEvaluating
 readerKnowledgeLevel: domainFamiliar
 
-# ドキュメントの深さ：ドキュメントはどの程度包括的であるべきか？
-# オプション：essentialOnly, balancedCoverage, comprehensive, aiDecide
+# ドキュメントの深さ: ドキュメントはどれだけ包括的であるべきか？
+# オプション: essentialOnly, balancedCoverage, comprehensive, aiDecide
 documentationDepth: balancedCoverage
 
-# カスタムルール：特定のドキュメント生成ルールと要件を定義する
+# カスタムルール: 特定のドキュメント生成ルールと要件を定義します
 rules: |+
   
 
-# 対象読者：特定の対象読者とその特性を記述する
+# 対象読者: 特定の対象読者とその特徴を記述します
 targetAudience: |+
   
 
-# 用語集：プロジェクト固有の用語と定義を含むマークダウンファイルへのパス
+# 用語集: プロジェクト固有の用語と定義を含むマークダウンファイルへのパス
 # glossary: "@glossary.md"
 
 # ドキュメントの主要言語
@@ -218,11 +202,11 @@ locale: en
 # 生成されたドキュメントを保存するディレクトリ
 docsDir: .aigne/doc-smith/docs
 
-# 分析するソースコードパス
+# 分析するソースコードのパス
 sourcesPath:
   - ./
 ```
 
 設定が完了したら、プロジェクトのニーズに合ったドキュメントを作成する準備ができました。次のステップは、生成コマンドを実行することです。
 
-➡️ **次へ：** [ドキュメントの生成](./features-generate-documentation.md)
+➡️ **次へ:** [ドキュメントの生成](./features-generate-documentation.md)

package/docs/configuration.md

@@ -10,54 +10,38 @@ The following diagram illustrates the configuration workflow:
 direction: down
 
 User: {
-  shape: c4-person
+  shape: person
 }
 
 CLI: {
-  label: "`aigne doc init`\n(Interactive Setup)"
+  label: "Run Command\n'aigne doc init'"
   shape: rectangle
 }
 
-ConfigFile: {
-  label: ".aigne/doc-smith/config.yaml"
+Setup-Wizard: {
+  label: "Interactive Setup Wizard"
   shape: rectangle
-  
-  Project-Info: {
-    label: "Project Information"
-    shape: rectangle
-  }
-  
-  Doc-Strategy: {
-    label: "Documentation Strategy"
-    shape: rectangle
-  }
-  
-  Custom-Directives: {
-    label: "Custom Directives"
-    shape: rectangle
-  }
-  
-  Lang-Path: {
-    label: "Language & Path Config"
-    shape: rectangle
-  }
 }
 
-AIGNE-DocSmith: {
-  label: "AIGNE DocSmith\n(Generation Process)"
-  icon: "https://www.arcblock.io/image-bin/uploads/89a24f04c34eca94f26c9dd30aec44fc.png"
+Config-File: {
+  label: ".aigne/doc-smith/config.yaml"
+  shape: rectangle
 }
 
-Generated-Docs: {
-  label: "Generated Documentation"
-  shape: rectangle
+AIGNE-DocSmith-Engine: {
+  label: "AIGNE DocSmith Engine"
 }
 
-User -> CLI: "Runs"
-CLI -> ConfigFile: "Creates / Modifies"
-User -> ConfigFile: "Directly Edits"
-ConfigFile -> AIGNE-DocSmith: "Controls"
-AIGNE-DocSmith -> Generated-Docs: "Produces"
+# Path 1: Interactive Setup (Recommended)
+User -> CLI: "Recommended Path"
+CLI -> Setup-Wizard: "Launches"
+Setup-Wizard -> Config-File: "Creates / Modifies"
+
+# Path 2: Manual Editing
+User -> Config-File: "Alternative Path:\nDirectly Edits"
+
+# Final Step
+Config-File -> AIGNE-DocSmith-Engine: "Configures"
 ```
 
 ## Core Configuration Areas