スキルの適切な粒度を定義（1スキル1目的、分割基準、結合基準）する。スキル設計時、粒度判断時、またはユーザーがスキル粒度、1スキル1目的、分割基準、結合基準、スキル設計原則に言及した際に使用する。
Provides guidelines for defining optimal skill granularity, including when to split or combine skills. Use when designing skills or when users mention skill granularity, 1-skill-1-purpose, or split/combine criteria.
/plugin marketplace add RevTechStudio/rts-plugins/plugin install rts-plugin-generator@rts-pluginsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
このSkillは、スキルの適切な粒度を定義し、1スキル1目的の原則を明確化する。スキルを分割すべき基準、結合すべき基準、適切な粒度の判断方法について指針を提供し、保守性と再利用性の高いスキル設計を実現することを目的とする。
このSkillは以下の範囲をカバーする:
各スキルは、一つの明確な目的を持つべきである。
目的の定義:
スキルの目的が明確であることを確認する:
良い例:
---
name: api-designer
description: RESTful API仕様を設計する
---
## 責任範囲
- エンドポイントの定義
- リクエスト/レスポンス形式の設計
- 認証・認可方式の設計
（目的が「API仕様を設計する」と明確）
悪い例:
---
name: system-designer
description: システム全体を設計する
---
## 責任範囲
- アーキテクチャ設計
- データベース設計
- API設計
- UI/UX設計
- セキュリティ設計
- パフォーマンス設計
（目的が広すぎて、複数のスキルに分割すべき）
以下の場合は、スキルを分割することを検討する:
複数の異なる目的が含まれる場合
ワークフローが複雑すぎる場合
カテゴリが多すぎる場合
規約部分が肥大化する場合
システム設計スキルを目的別に分割:
要件定義スキルをフェーズ別に分割:
コード生成スキルから規約を分離:
良い例:
分割前:
- system-designer（システム全体を設計する）
分割後:
- architecture-designer（システムアーキテクチャを設計する）
- database-schema-designer（データベーススキーマを設計する）
- api-designer（RESTful API仕様を設計する）
- ui-component-architect（UIコンポーネント構成を設計する）
悪い例:
分割前:
- api-designer（RESTful API仕様を設計する）
分割後:
- endpoint-designer（エンドポイントを設計する）
- request-designer（リクエスト形式を設計する）
- response-designer（レスポンス形式を設計する）
- auth-designer（認証方式を設計する）
（過度に細分化されており、実用性が低い）
以下の場合は、スキルを結合することを検討する:
スキルが小さすぎる場合
スキル間の依存関係が強い場合
重複が多い場合
エンドポイント設計、リクエスト設計、レスポンス設計を統合:
コード生成スキルに規約を直接記述:
良い例:
結合前:
- endpoint-designer（エンドポイントを設計する）
- request-designer（リクエスト形式を設計する）
- response-designer（レスポンス形式を設計する）
結合後:
- api-designer（RESTful API仕様を設計する）
悪い例:
結合前:
- architecture-designer（システムアーキテクチャを設計する）
- database-schema-designer（データベーススキーマを設計する）
- api-designer（RESTful API仕様を設計する）
結合後:
- system-designer（システム全体を設計する）
（目的が広すぎて、1スキル1目的の原則に反する）
以下の指標を使用して、スキルの粒度が適切かどうかを判断する:
descriptionの明確さ
責任範囲の項目数
ワークフローのフェーズ数（Workflow Skill）
カテゴリ数（Convention Skill）
ドキュメントサイズ
1. descriptionが1行で説明できるか？
├─ はい → 2へ
└─ いいえ → 分割を検討
2. 責任範囲が3〜5項目か？
├─ はい → 3へ
├─ いいえ（1〜2項目） → 結合を検討
└─ いいえ（6項目以上） → 分割を検討
3. ワークフロー/カテゴリが2〜5個か？
├─ はい → 適切な粒度
├─ いいえ（1個） → 結合を検討
└─ いいえ（6個以上） → 分割を検討