| name | command-agent-skill-integration |
| description | コマンド/エージェント/スキルの統合設計を整理し、連携パターンと複合ワークフローを支援するスキル。
起動パターン、参照パターン、統合検証の手順を一貫して整理する。
Anchors:
• The Pragmatic Programmer (Andrew Hunt, David Thomas) / 適用: 連携手順の設計 / 目的: 再現性の確保
• Multi-Agent Systems (Wooldridge) / 適用: エージェント連携 / 目的: 協調設計の整理
• Workflow Patterns (van der Aalst) / 適用: 複合ワークフロー / 目的: 実行フローの明確化
Trigger:
Use when integrating commands with agents and skills, designing composite workflows, or validating integration rules.
command agent skill integration, composite workflow, agent invocation, skill reference
|
command-agent-skill-integration
概要
コマンドとエージェント、スキルの連携パターンを整理し、統合フローの設計と検証を行う。
ワークフロー
Phase 1: 要件整理
目的: 統合対象と連携要件を明確化する。
アクション:
- 統合対象(コマンド/エージェント/スキル)を整理する。
- 起動パターンと参照パターンを選定する。
- 参照すべきアーキテクチャ資料を確認する。
Task: agents/analyze-integration-requirements.md を参照
Phase 2: 統合設計
目的: 連携パターンとワークフロー設計を具体化する。
アクション:
- コマンド→エージェント/スキルの連携フローを設計する。
- 複合ワークフローをテンプレートで整理する。
- 例外ケースとガードレールを定義する。
Task: agents/design-integration-flow.md を参照
Phase 3: 検証と記録
目的: 統合ルールを検証し、記録を残す。
アクション:
- 統合検証スクリプトで整合性を確認する。
- 検証結果と改善点を記録する。
- ログと評価情報を更新する。
Task: agents/validate-integration.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|
| analyze-integration-requirements | Phase 1開始時 | 統合対象/要件 | 要件整理メモ、参照一覧 |
| design-integration-flow | Phase 2開始時 | 要件整理メモ | 連携フロー設計、テンプレ適用案 |
| validate-integration | Phase 3開始時 | 連携フロー設計 | 検証レポート、改善方針 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|
| 連携パターンを明確に選定する | 連携ミスを防ぐため |
| テンプレートを活用する | 実装の一貫性が保てるため |
| 統合検証を実行する | 逸脱を検知するため |
避けるべきこと
| 禁止事項 | 問題点 |
|---|
| 連携仕様を省略する | 実装がブレる |
| 例外処理を後回しにする | 障害時に対応できない |
| 記録を残さない | 改善が続かない |
リソース参照
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|
scripts/validate-integration.mjs | 統合パターン検証 |
scripts/log_usage.mjs | 使用記録と評価メトリクス更新 |
scripts/validate-skill.mjs | スキル構造の検証 |
references/(詳細知識)
assets/(テンプレート・素材)
| アセット | 用途 |
|---|
assets/agent-invocation-template.md | エージェント起動テンプレート |
assets/skill-reference-template.md | スキル参照テンプレート |
assets/composite-workflow-template.md | 複合ワークフローテンプレート |
運用ファイル
| ファイル | 目的 |
|---|
EVALS.json | レベル評価・メトリクス管理 |
LOGS.md | 実行ログの蓄積 |
CHANGELOG.md | 改善履歴の記録 |