mcpField
L
load-plain-reference

load-plain-reference

github.com/plainlang開発8042 回インストール今日更新
リポジトリ

load-plain-reference について

`***plain` の作成タスクに応じて、該当する構文ルールやリファレンスを選ぶスキルです。セッションで初めて呼び出された際にルールの更新状況を確認し、無関係なガイダンスは読み込みません。

主な機能

  1. 01タスクに応じたルールファイルの選択
  2. 02初回読み込み前のバージョン確認
  3. 03コンテキスト内のルールの読み込み省略
  4. 04必要に応じた統合ガイダンスの読み込み

活用シーン

  1. 01`.plain` ファイルの読み書き前の準備
  2. 02特定の作成タスク向けルールの確認
  3. 03統合仕様向けガイダンスの読み込み

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/plainlang/plain-forge --skill load-plain-reference

インストール後、Claude Code で/load-plain-referenceを入力して読み込まれたか確認します。

詳細

***plain リファレンスを読み込む

現在のタスクに必要なルールとリファレンスのみを読み込みます。この SKILL.md と同じ場所にある rules/ 内のファイルが、.plain の構文と作成上の制約に関する信頼できる情報源です。これらを言い換えたり、上書きしたりしないでください。

まず、これから読み込むルールが最新であることを確認してください。 このスキルをセッションで初めて呼び出すときは、ルールファイルを読み込む前に check-forge-version を実行してください。古い plain-forge には古いルールが含まれているため、以下のすべてのルーティング判断はその判定の影響を受けます。

そのスキルからインストールが古い、または確認できないと報告された場合は、古い plain-forge での作成は推奨されないことをユーザーにはっきり伝え、続行する前に npx plain-forge update を実行するよう依頼してください。以下で読み込むルールは、現在のレンダラーが想定する内容と一致しない可能性があります。

処理を止めるのではなく、ユーザーに選択肢を示してください。更新を見送る場合は、ディスク上のルールを使って続行し、その後の予期しない動作については、まず古いインストールを疑ってください。

同じセッションでの以降の呼び出しでは確認を省略し、ネットワークが利用できない場合も省略してください。

1. すでに読み込まれているルールを確認する

  • 完全な内容が現在のコンテキストにすでに含まれているルールは、再度読み込まないでください。
  • それ以外の場合は、.plain の内容を調べたり変更したりする前に、以下のルーティング表に該当するファイルを読み込んでください。

2. 該当する作成ルールを読み込む

すべてのパスは、この SKILL.md からの相対パスです。

タスクまたは内容ルールファイル
新しいモジュール、ファイルの骨組み、セクションの配置、またはコメントrules/module-structure.md
セクション間での事実の移動(resolve-section-ownership を参照)rules/module-structure.md と、関係する各セクションのルールファイル
定義または概念の使用rules/definitions.md
機能仕様rules/func-specs.md、rules/semantic-ids.md
テスト用の plain ファイルまたはシナリオrules/test-plain-files.md、rules/semantic-ids.md
実装要件またはユニットテストrules/impl-reqs.md
テスト要件または適合性テストrules/test-reqs.md
import モジュールrules/import-modules.md
requires モジュールrules/requires-modules.md
required_conceptsrules/required-concepts.md
exported_conceptsrules/exported-concepts.md
リンク先ファイルまたは resources/rules/linked-resources.md
定義、実装要件、またはテスト要件のテキストrules/bullet-continuation.md
.plain のテキストまたは例rules/concise-specs.md
仕様の文言の作成または簡潔化、あるいは冗長さに関する仕様のレビューrules/concise-specs-examples.md

ファイル全体のレビューや複数のセクションにまたがるタスクでは、該当するルールファイルをすべて読み込んでください。デフォルトですべてのルールを読み込まないでください。

3. 統合の作業でのみ統合ルールを読み込む

統合仕様の場合は、必ず次を読み込んでください。

  • rules/integrations.md

次に、統合の形式に合ったルールを読み込んでください。

  • 埋め込み型の統合:rules/integration-embedded.md
  • スタンドアロン型の統合:rules/integration-standalone.md
  • 埋め込み型統合のテストスクリプト:rules/integration-embedded-testing.md

統合仕様の文言を作成または簡潔化する場合は、rules/concise-specs-integration-examples.md も読み込んでください。

通常の非統合仕様では、統合ルールを読み込まないでください。

4. 必要な場合にのみ運用リファレンスを読み込む

リファレンスと作成ルールが矛盾しているように見える場合は、作成ルールを優先してください。

必要な情報リファレンス
プロジェクト構成、信頼できる情報源のモデル、またはテンプレートの組み込みreferences/project-model.md
レンダリング順序、生成物、適合性ワークフロー、またはテストスクリプトreferences/rendering-and-testing.md

5. タスクを続行する

該当する資料を読み込んだら、呼び出し元のスキルまたはユーザーの依頼に戻ってください。生成されたコードは読み取り専用とし、すべての修正を該当する .plain のソースに反映してください。

コメント