| name | command-basic-patterns |
| description | 基本実装パターン（シンプル指示/ステップバイステップ/条件分岐/ファイル参照）を整理し、パターン選定とテンプレート適用を支援するスキル。
選定基準、実装の骨格、検証手順を一貫して整理する。
Anchors:
• The Pragmatic Programmer (Andrew Hunt, David Thomas) / 適用: コマンド設計 / 目的: 実践的な手順設計パターンの習得
Trigger:
Use when selecting or reviewing basic command patterns, or structuring workflows for simple/step/conditional/file-reference commands.
command basic patterns, simple command, step-by-step, conditional command, file reference
|
command-basic-patterns
概要
基本実装パターン（シンプル指示/ステップバイステップ/条件分岐/ファイル参照）を整理し、パターン選定とテンプレート適用を支援する。
ワークフロー
Phase 1: 要件整理
目的: 適用パターンと対象範囲を明確化する。
アクション:
- 対象コマンドの目的と制約を整理する。
- パターン選定ガイドで候補を絞る。
- 参照ガイドとテンプレートを確認する。
Task: agents/analyze-basic-patterns.md を参照
Phase 2: パターン設計
目的: パターン設計と実装方針を具体化する。
アクション:
- 選定パターンの構造とステップを設計する。
- テンプレートを使い設計を具体化する。
- 例外ケースとガードレールを整理する。
Task: agents/design-basic-patterns.md を参照
Phase 3: 検証と記録
目的: パターン整合を検証し、記録を残す。
アクション:
- パターン検証スクリプトで整合性を確認する。
- 検証結果と改善点を整理する。
- ログと評価情報を更新する。
Task: agents/validate-basic-patterns.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|
| analyze-basic-patterns | Phase 1開始時 | 対象コマンド/目的 | 要件整理メモ、適用パターン候補 |
| design-basic-patterns | Phase 2開始時 | 要件整理メモ | パターン設計案、テンプレ適用案 |
| validate-basic-patterns | Phase 3開始時 | パターン設計案 | 検証レポート、改善方針 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|
| パターンを明確に選定する | 実装ブレを防ぐため |
| テンプレートで設計を統一する | 読みやすさが保てるため |
| 検証スクリプトを実行する | 逸脱を検知するため |
避けるべきこと
| 禁止事項 | 問題点 |
|---|
| 複数パターンを無計画に混在させる | 挙動が不明確になる |
| 例外処理を後回しにする | 失敗時に対応できない |
| 記録を残さない | 改善が続かない |
リソース参照
scripts/（決定論的処理）
| スクリプト | 機能 |
|---|
scripts/validate-patterns.mjs | 基本パターン検証 |
scripts/log_usage.mjs | 使用記録と評価メトリクス更新 |
scripts/validate-skill.mjs | スキル構造の検証 |
references/（詳細知識）
assets/（テンプレート・素材）
| アセット | 用途 |
|---|
assets/simple-instruction-template.md | シンプル指示テンプレート |
assets/step-by-step-template.md | ステップバイステップテンプレート |
assets/conditional-template.md | 条件分岐テンプレート |
assets/file-reference-template.md | ファイル参照テンプレート |
運用ファイル
| ファイル | 目的 |
|---|
EVALS.json | レベル評価・メトリクス管理 |
LOGS.md | 実行ログの蓄積 |
CHANGELOG.md | 改善履歴の記録 |
