feat: add official_doc_urls and hints to browsable markdown (#155) (#167)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: kiyotis

.claude/skills/nabledge-6/docs/about/about-nablarch/about-nablarch-01.md

@@ -1,9 +1,18 @@
 # データベースを用いたパスワード認証機能サンプル
 
+**公式ドキュメント**: [データベースを用いたパスワード認証機能サンプル](https://nablarch.github.io/docs/LATEST/doc/biz_samples/01/index.html)
+
 ## 提供パッケージ
 
 **パッケージ**: `please.change.me.common.authentication`
 
+<details>
+<summary>keywords</summary>
+
+please.change.me.common.authentication, PasswordAuthenticator, PasswordEncryptor, パッケージ, パスワード認証サンプル
+
+</details>
+
 ## 概要
 
 データベースに保存されたアカウント情報（ユーザIDとパスワード）を使用したユーザ認証のサンプル実装。ログイン処理を実行する業務処理の中で使用することを想定している。
@@ -18,6 +27,13 @@
 
 設定内容の詳細は `0101_PBKDF2PasswordEncryptor` を参照。
 
+<details>
+<summary>keywords</summary>
+
+PBKDF2, パスワード暗号化, ユーザ認証, ストレッチング, 0101_PBKDF2PasswordEncryptor, アカウント情報
+
+</details>
+
 ## 構成：クラス構成
 
 **インタフェース**:
@@ -62,6 +78,13 @@
 | `PasswordExpiredException` | 認証時にパスワード有効期限切れの場合の例外。ユーザID、パスワード有効期限、業務日付を保持する |
 | `UserIdLockedException` | 認証時にユーザIDがロックされている場合の例外。ユーザIDとロックする認証失敗回数を保持する |
 
+<details>
+<summary>keywords</summary>
+
+SystemAccountAuthenticator, PBKDF2PasswordEncryptor, AuthenticationUtil, SystemAccount, AuthenticationException, AuthenticationFailedException, PasswordExpiredException, UserIdLockedException, PasswordAuthenticator, PasswordEncryptor, クラス図, クラス構成, 例外クラス, インタフェース定義
+
+</details>
+
 ## 構成：テーブル定義
 
 本サンプルで使用しているアカウントテーブルの定義。本サンプルを導入プロジェクトに取り込む際は、プロジェクトのテーブル定義に従いSQLファイルおよびソースコードを修正すること。
@@ -82,6 +105,13 @@
 
 > **補足**: 上記テーブル定義は本サンプルで必要な属性のみ。導入プロジェクトでは必要なユーザ属性の追加や関連テーブルの作成など要件に応じてテーブル設計すること。
 
+<details>
+<summary>keywords</summary>
+
+SYSTEM_ACCOUNT, テーブル定義, USER_ID, LOGIN_ID, USER_PASSWORD, USER_ID_LOCKED, PASSWORD_EXPIRATION_DATE, FAILED_COUNT, LAST_LOGIN_DATE_TIME, システムアカウント
+
+</details>
+
 ## 使用方法：概要
 
 パスワード認証の特徴:
@@ -95,6 +125,13 @@ PasswordAuthenticatorおよびPasswordEncryptorはNablarchのシステムリポ
 
 プロジェクトで実装するログイン機能やユーザ登録機能などからは`AuthenticationUtil`を使用すること。
 
+<details>
+<summary>keywords</summary>
+
+パスワード認証, 有効日チェック, パスワード有効期限, ユーザIDロック, 認証失敗回数, 最終ログイン日時, AuthenticationUtil, システムリポジトリ
+
+</details>
+
 ## SystemAccountAuthenticatorの使用方法
 
 **コンポーネント設定例**:
@@ -126,6 +163,13 @@ PasswordAuthenticatorおよびPasswordEncryptorはNablarchのシステムリポ
 
 > **重要**: SystemAccountAuthenticatorのトランザクション制御が個別アプリケーションに影響しないよう、個別アプリケーションとは別のトランザクションを使用すること。設定例のdbTransactionNameに指定した `"authenticator"` は個別アプリケーションでは使用しないこと。
 
+<details>
+<summary>keywords</summary>
+
+SystemAccountAuthenticator, passwordEncryptor, dbManager, failedCountToLock, SimpleDbTransactionManager, コンポーネント設定, XML設定, authenticator
+
+</details>
+
 ## AuthenticationUtilの使用方法
 
 AuthenticationUtilでは以下のユーティリティメソッドを実装している。システムリポジトリからコンポーネントを取得する際のコンポーネント名は、SystemAccountAuthenticatorの設定で登録しているコンポーネント名と合わせる必要がある。設定例と異なるコンポーネント名で登録している場合はソースコードを修正すること。
@@ -160,3 +204,10 @@ try {
     // 例外処理
 }
 ```
+
+<details>
+<summary>keywords</summary>
+
+AuthenticationUtil, authenticate, encryptPassword, AuthenticationFailedException, UserIdLockedException, PasswordExpiredException, AuthenticationException, 使用例, 認証処理実装例
+
+</details>

.claude/skills/nabledge-6/docs/about/about-nablarch/about-nablarch-0101_PBKDF2PasswordEncryptor.md

@@ -1,13 +1,29 @@
 # PBKDF2を用いたパスワード暗号化機能サンプル
 
+**公式ドキュメント**: [PBKDF2を用いたパスワード暗号化機能サンプル](https://nablarch.github.io/docs/LATEST/doc/biz_samples/01/0101_PBKDF2PasswordEncryptor.html)
+
 ## 提供パッケージ
 
 **パッケージ**: `please.change.me.common.authentication.encrypt`
 
+<details>
+<summary>keywords</summary>
+
+PBKDF2PasswordEncryptor, please.change.me.common.authentication.encrypt, パッケージ
+
+</details>
+
 ## 概要
 
 PBKDF2を使用して、ソルト付加およびストレッチングを行ってパスワードを暗号化する機能の実装サンプル。認証機能内で使用することを想定している。
 
+<details>
+<summary>keywords</summary>
+
+PBKDF2, パスワード暗号化, ソルト, ストレッチング
+
+</details>
+
 ## 要求
 
 **実装済み**
@@ -21,6 +37,13 @@ PBKDF2を使用して、ソルト付加およびストレッチングを行っ
 - ユーザごとにランダムなソルトを付加する機能
 - ソルトをデータベース外のセキュアなストレージに保管する機能
 
+<details>
+<summary>keywords</summary>
+
+レインボーテーブル対策, 総当り攻撃対策, ソルト, ストレッチング, 実装済み機能, 未検討機能
+
+</details>
+
 ## パスワード暗号化機能の詳細
 
 [PBKDF2](https://www.ietf.org/rfc/rfc2898.txt)を使用してパスワードを暗号化する。暗号化されたパスワードはBase64エンコードされた文字列として返却される。
@@ -32,6 +55,13 @@ PBKDF2を使用して、ソルト付加およびストレッチングを行っ
 
 ストレッチング回数の検討方法は「ストレッチング回数の設定値について」を参照。
 
+<details>
+<summary>keywords</summary>
+
+PBKDF2, fixedSalt, iterationCount, Base64, ソルト, レインボーテーブル対策, 総当り攻撃対策
+
+</details>
+
 ## 設定方法
 
 **クラス**: `please.change.me.common.authentication.encrypt.PBKDF2PasswordEncryptor`
@@ -55,6 +85,13 @@ PBKDF2を使用して、ソルト付加およびストレッチングを行っ
 
 > **補足**: ストレッチング処理はCPU負荷の高い処理。PCIDSSに準拠するシステムでなく特別なセキュリティが必要なければ`iterationCount`に`1`を指定すればよい。
 
+<details>
+<summary>keywords</summary>
+
+PBKDF2PasswordEncryptor, fixedSalt, iterationCount, keyLength, XML設定, ソルト長, 最新情報確認
+
+</details>
+
 ## ストレッチング回数の設定値について
 
 `iterationCount`デフォルト値3966の根拠:
@@ -72,3 +109,10 @@ PBKDF2での1回の計算時間がSHA-256の15000倍以上となるように`ite
 開発PC（Intel Core i7-4770 3.40GHz）での実測: `iterationCount`を3500〜4000程度に設定するとPBKDF2の計算時間はSHA-256の15000倍程度となる。`iterationCount`=4000時の1回の計算時間は15ms〜20ms程度。
 
 > **重要**: PBKDF2の暗号化処理実行中はCPUをほぼ占有する。実際に稼動する環境でCPUを占有する時間が許容範囲内かどうかを必ず検証すること。
+
+<details>
+<summary>keywords</summary>
+
+iterationCount, ストレッチング回数, デフォルト値, 3966, SHA-256, 総当り攻撃, 計算時間, CPU負荷
+
+</details>