Skip to content

Nabledge(Nablarch 6専用AIツール)ドキュメントページを追加 - #732

Open
nakagawa131 wants to merge 14 commits into
developfrom
add-nabledge-guide-from-develop
Open

Nabledge(Nablarch 6専用AIツール)ドキュメントページを追加#732
nakagawa131 wants to merge 14 commits into
developfrom
add-nabledge-guide-from-develop

Conversation

@nakagawa131

Copy link
Copy Markdown

概要

Nablarch 6向けにNabledge(Nablarch専用AIコーディングツール)のドキュメントページを追加しました。

変更内容

  • 日本語・英語のAIコーディング支援ページを新規追加
    • ja/development_tools/ai_tools/index.rst
    • ja/development_tools/ai_tools/nabledge/index.rst
    • en/development_tools/ai_tools/index.rst
    • en/development_tools/ai_tools/nabledge/index.rst
  • トップページにAIツールの案内tipボックスを追加(/n6コマンド)
  • 開発ツール一覧にAIコーディング支援を追加

確認方法

ローカルでSphinxビルド後、各ページが正しく表示されることを確認済み

関連

V5向けのPRは add-nabledge-guide-from-V5-develop ブランチから別途作成予定

nakagawa131 and others added 3 commits July 29, 2026 19:32
- Nabledge → Nablarch専用AIコーディングツール向けプラグイン に変更
- パンくずリスト下の固定文字列を削除(視認性向上)
- トップページにtipボックス追加(4つのツールリンクの下に配置)
- セットアップ手順を簡潔化(curlコマンド直接記載)
- セクション名を「AIコーディング支援」に短縮
- バージョンごとのインストール先リンクを追加

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- 英語版にAI Coding Assistanceページを追加
- en/development_tools/ai_tools/index.rst 新規作成
- en/development_tools/ai_tools/nabledge/index.rst 新規作成
- 対応バージョン表を2列に簡素化(対応バージョン、プラグイン)
- 英語版の見出し重複問題を修正(Features → Functions Provided / Features)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Comment thread _templates/breadcrumbs.html Outdated
Comment thread ja/development_tools/ai_tools/nabledge/index.rst Outdated
Comment on lines +44 to +76
知識検索
--------------------------------------------

Nablarchのドキュメントに基づいて質問に回答する。

使用例: ::

/n6 コード値のプルダウン入力を実装するには?

Nablarchのドキュメント全体から関連セクションを検索し、コード例・設定例を含めた回答を返す。

仕組み:

* Nablarch公式ドキュメントをAIが読めるJSON形式に変換(約340ファイル、約300エントリ)
* キーワード全文検索+AIによる関連度判定の2段階で精度を確保
* 全文検索でヒットしない場合は目次からAIがファイルを選択するフォールバック経路あり

コード分析
--------------------------------------------

プロジェクト内のアプリケーションコードをNablarchの観点から分析し、全体像をドキュメント化する。

使用例: ::

/n6 code-analysis

以下の情報を可視化:

* クラス間の依存関係
* ハンドラキューの構成
* 処理フローをMermaid図で可視化

主な活用シーン:新メンバーがプロジェクトに入ったときの素早い全体把握。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

言葉だけで説明しているので、使ってみた場合の出力がイメージできない。スクショや回答例など入れたほうが良いと思います。

@nakagawa131 nakagawa131 Jul 31, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

906b6ee
e4d337b
対応しました。

  • 知識検索: 実際のチャット画面のスクリーンショットを追加
  • コード分析: クラス依存関係図とシーケンス図を追加
  • 日本語版・英語版の両方に対応(計6枚の画像)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

英語版の画像ファイル名を修正してくださってますが、日本語版もファイル名は英語にして欲しいです。他の箇所と合わせるためと、日本語ファイル名はURLエンコードされて長くなりがちなのでアルファベットのみのファイル名が嬉しいです。英語版と同じファイル名で良いです。

Comment thread ja/development_tools/ai_tools/index.rst Outdated
Comment thread ja/development_tools/ai_tools/nabledge/index.rst Outdated
Comment thread ja/development_tools/ai_tools/nabledge/index.rst Outdated
Comment thread ja/development_tools/ai_tools/nabledge/index.rst Outdated
Comment thread ja/development_tools/ai_tools/nabledge/index.rst Outdated
Comment thread en/development_tools/ai_tools/nabledge/index.rst Outdated
Comment thread en/development_tools/ai_tools/nabledge/index.rst Outdated
Comment thread en/development_tools/ai_tools/nabledge/index.rst Outdated
Comment thread en/development_tools/ai_tools/nabledge/index.rst Outdated
Comment thread en/development_tools/ai_tools/nabledge/index.rst Outdated
nakagawa131 and others added 11 commits July 31, 2026 17:48
知識検索と、コード分析の実際の出力例をスクリーンショット画像で追加。
日本語版・英語版の両方に対応。

追加した画像:
- 知識検索の回答例(チャット画面)
- クラス依存関係図とコンポーネント概要
- 処理フロー図(シーケンス図)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
テンプレートファイル内の経緯コメントを削除。
経緯はPR内に記載済み。

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
インストール方法セクションで「インストール先」と記載していた箇所を、
実際の列名「プラグイン」に修正。

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
AIツール一覧ページで、Claude CodeとGitHub Copilotのツール名に
公式サイトへのリンクを追加。日本語版・英語版の両方に対応。
Nabledgeガイドの「前提環境」セクションを最初のセクションとして配置。
Claude CodeとGitHub Copilotに公式サイトへのリンクを追加。
読者が最初に前提条件を把握できるように改善。
知識検索と特徴セクションからファイル数・エントリ数の記載を削除。
メンテナンスコスト削減と、数値の乖離リスクを回避。
「セットアップ手順」の親セクションを削除し、
Nablarch 6の手順を直接配置。
インストールコマンドを正しいバージョン指定形式に修正。
3つの明確な価値に整理して冗長な表現を削減。
1. 公式ドキュメントのみを根拠にした回答
2. わからないことは「わからない」と回答
3. 回答に必ず参照元を提示

日本語版・英語版の両方に対応。
Background セクション (26-27行目):
- "penetrated development sites" → "become part of everyday development"
- "cross-sectional understanding" → "broad understanding across sources"

セクション名の変更:
- "Solved by This Plugin" (40行目) → "How This Plugin Helps"
- "Functions Provided" (47行目) → "Features"
- "Features" (107行目) → "Reliability"
英語版ディレクトリ内の画像ファイル名が日本語になっていた問題を修正。
以下の変更を実施:

変更内容:
- Nabledge_知識検索サンプル画像_英語.png → Nabledge_Knowledge_Search_Example.png
- 依存関係図とコンポーネント概要_英語版.png → Class_Dependency_and_Component_Overview.png
- シーケンス図_英語.png → Sequence_Diagram.png

また、英語版ディレクトリに誤って含まれていた日本語版画像ファイル(3件)を削除。
index.rstの画像パス参照も対応するファイル名に更新。

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
claude.ai/code から claude.com の製品ページに変更。
- 日本語版: https://claude.com/ja/product/claude-code
- 英語版: https://claude.com/product/claude-code

変更箇所:
- ai_tools/index.rst(日英)
- ai_tools/nabledge/index.rst(日英)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
For Other Versions
--------------------------------------------

Check the setup procedure from the "Plugin" column link in the supported versions table for the corresponding version.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

日本語文の直訳という感じで語順に若干理解し難さを感じました。
Click the link in the "Plugin" column for your Nablarch version to view the setup procedure.
のほうが自然でわかりやすいかなと思います。


* クラス間の依存関係
* ハンドラキューの構成
* 処理フローをMermaid図で可視化

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

他が名詞なのにここだけ動詞句で並列性が崩れています。「処理フロー(Mermaid図)」のような名詞句に揃えた方が自然だと思います。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants