ルールとスキル

AIDKはAIをガイドするために**ルール（Rules）とスキル（Skills）**という2つの主要なメカニズムを使用します。どちらも .agent/ ディレクトリに配置されます。

ルール（Rules）

ルールは .agent/rules/ 内の .md ファイルです。AIはすべてのタスクの前にこれらを読み取り、プロジェクトの制約と基準を理解します。

# ルール名

## 説明
このルールが何を強制するかの簡単な説明。

## 必須ガイドライン
- ルール1
- ルール2

## 正しい例
...

## 間違った例
...

ルール	優先度	説明
`0-force-rule.md`	0（最高）	タスク開始前にすべてのルール/スキルをレビューするようAIに強制する
`2-dotenv-environments.md`	2	`.env` ファイルを使用した環境変数設定基準
`3-coding-style.md`	3	コーディングスタイルルール（ファイルサイズ制限、イミュータビリティなど）

番号が小さいルールが優先されます。例えば、0-force-rule.md は常に最初に適用されます。

スキルは .agent/skills/ 内のディレクトリで、各ディレクトリには少なくとも SKILL.md ファイルが含まれます。スキルは技術またはタスク固有のガイダンスを提供します。

.agent/skills/
└── my-skill/
    ├── SKILL.md        # メイン指示（必須）
    ├── examples/       # 参考例（オプション）
    └── templates/      # ファイルテンプレート（オプション）

---
name: my-skill
description: >
  このスキルをいつ使用するかを説明します。
  AIはこの説明を読んでスキルを適用するかどうかを判断します。
---

スキル	使用するタイミング
`cxl-brainstorming`	創造的/構築的な作業の前
`cxl-fastapi`	FastAPIでのREST API構築
`cxl-docusaurus-setup`	Docusaurusドキュメントサイトの作成/更新
`cxl-terraform`	Terraform/OpenToFuでの作業
`cxl-ansible`	Ansibleプレイブックの作成
`cxl-postgres-patterns`	スキーマ設計とPostgreSQLクエリ
`cxl-dynamodb`	DynamoDBデータモデリング
`cxl-aws-architecture`	AWSアーキテクチャ設計
`cxl-security-review`	認証/API追加時のセキュリティレビュー
`cxl-python`	Pythonコーディング基準
`cxl-coding-standards`	TypeScript/JavaScript/React基準
`cxl-seo`	SEO最適化
`cxl-gitignore`	`.gitignore` の作成/更新

aidk add skill my-new-skill
# 作成：.agent/skills/my-new-skill/SKILL.md

プロジェクトの特定のニーズに応じて SKILL.md を編集します。

ワークフローは .agent/workflows/ 内の .md ファイルで、スラッシュコマンドで呼び出せるプロセスを定義します。