shared-patterns

共通パターン

概要

スキルおよびフックの開発で再利用できるパターンとテンプレートです。

使用しない場合

• スキルを最初から最後まで作成する場合（abstract:skill-authoring を使用してください）
• ここではなく leyline に置くべき、プラグイン間の契約

目的

このスキルは、abstract プラグイン内の他のスキルから参照される共通パターンを提供します。共通パターンを一元管理することで、DRY の原則に従います。

パターンのカテゴリー

バリデーションパターン

modules/validation-patterns.md を参照してください。

• 入力バリデーションのテンプレート
• スキーマバリデーションのパターン
• エラー報告の形式

エラー処理

modules/error-handling.md を参照してください。

• 例外の階層
• エラーメッセージのフォーマット
• 復旧方法

テスト用テンプレート

modules/testing-templates.md を参照してください。

• 単体テストのひな形
• 統合テストのパターン
• モックのフィクスチャ

ワークフローパターン

modules/workflow-patterns.md を参照してください。

• チェックリストのテンプレート
• フィードバックループのパターン
• 段階的に情報を開示する構成

使用方法

他のスキルからこれらのパターンを参照します。

For validation patterns, see the `shared-patterns` skill's
[validation-patterns](../shared-patterns/modules/validation-patterns.md) module.

検証： コマンドに --help フラグを付けて実行し、利用可能であることを確認してください。

完了条件

• 4 つのモジュールファイル（validation-patterns.md、error-handling.md、 testing-templates.md、workflow-patterns.md）が plugins/abstract/skills/shared-patterns/modules/ 以下に存在する。
• これらのモジュールへのスキル間参照では、../shared-patterns/modules/ で始まる相対パスを使用し、 ディスク上に存在するファイルを指している。
• 使用するスキルから、非推奨の skills/shared/modules/ ディレクトリパターン以下のパスを参照していない。そのような参照はリンク切れとして報告される。
• ハブの SKILL.md 自体は 150 行未満に保ち、リンク先のモジュールにある実質的なパターンの内容を 重複して記載しない。