tdn-lookup について
ローカル資料で情報が不足する場合に、TDNでTOTVS公式ドキュメントを探すための検索手順を定めたスキルです。キャッシュからAPI、ブラウザー、サイト内の手動検索へ段階的に切り替えます。
主な機能
- 01ローカルキャッシュを優先
- 02Confluence REST API検索
- 03PlaywrightによるAPI検索
- 04Web検索とサイト巡回
- 05TDNの手動検索
活用シーン
- 01未記載のネイティブ関数やエラーの調査
- 02TOTVS公式ドキュメントの検索
- 03ローカル資料不足時の段階的な検索
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill tdn-lookupインストール後、Claude Code で/tdn-lookupを入力して読み込まれたか確認します。
同梱ファイルreference.md
詳細
TDN 検索 — オンライン検索戦略
このスキルでは、ローカルの参照資料だけでは不十分な場合に、TDN(tdn.totvs.com、未認証の REST API を備えた公開 Confluence Data Center 7.19 サイト)で TOTVS の公式ドキュメントを探すための標準的なフォールバック戦略を定義します。5 段階のエスカレーションを指定します。Tier 1 では、必ず関連するローカルキャッシュファイルを最初に確認します(ネイティブ関数、SX 辞書、一般的なエラー、エントリーポイント、業務モジュール)。Tier 2 では、CQL クエリを使って WebFetch 経由で Confluence REST 検索 API に直接クエリします。Tier 3 では、WebFetch がブロックされた場合、同じ API にアクセスするために Playwright を使用します。Tier 4 では、CQL 検索で結果が得られない場合、WebSearch と Playwright によるナビゲーションを使用します。Tier 5 は最終手段として、TDN サイト自体で手動または視覚的に検索します。
ネイティブ関数、エントリーポイント、エラーコード、または業務プロセスがローカルの参照ファイルで見つからない場合(または一部しか見つからない場合)、あるいはユーザーが TOTVS の公式ドキュメントを明示的に求めた場合は、このスキルを有効にしてください。このスキル自体にはドメイン知識は含まれていません。検索プロセスを調整するだけです。ネイティブ関数、エントリーポイント、エラーの各カタログは、protheus-reference、advpl-code-generation、advpl-debugging、protheus-business にあります。
| 参照ファイル | 読み込むタイミング |
|---|---|
| reference.md | 常に。段階ごとの検索戦略、CQL クエリの作成方法、HTML/JSON の解析手順、各段階のフォールバック条件を確認します。 |