load-plain-reference について
`***plain` の作成タスクに応じて、該当する構文ルールやリファレンスを選ぶスキルです。セッションで初めて呼び出された際にルールの更新状況を確認し、無関係なガイダンスは読み込みません。
主な機能
- 01タスクに応じたルールファイルの選択
- 02初回読み込み前のバージョン確認
- 03コンテキスト内のルールの読み込み省略
- 04必要に応じた統合ガイダンスの読み込み
活用シーン
- 01`.plain` ファイルの読み書き前の準備
- 02特定の作成タスク向けルールの確認
- 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_concepts | rules/required-concepts.md |
exported_concepts | rules/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 のソースに反映してください。