scaffold

Files (1)

• SKILL.md

SKILL.md (first lines)

# Project Scaffold Skill

このスキルは、AI駆動開発（Agent Skills Ecosystem）に対応した新規プロジェクト環境を構築するための手順と知識を提供します。
エージェントがプロジェクトの初期化が必要だと判断した際に、専門的な知識セットとして使用されることを想定しています。

## 核となる原則

- **Standard Commands**: スキルのインストールには `npx skills add` を使用し、常に最新かつ適切なバージョンを取得します。
- **Documentation First**: コードよりも先に、プロジェクトの「ルール（AGENTS.md）」と「指示（instructions.md）」を確立します。
- **Modular Setup**: 必要な機能（スキル）を選択的に導入できる構造にします。

## ワークフロー

### 1. プロジェクト定義の確立 (`AGENTS.md`)

プロジェクトのルートに `AGENTS.md` を作成し、エージェントの役割とプロジェクト全体の指示（システムプロンプト）を定義します。

**Action:**
以下のテンプレートを使用して `AGENTS.md` を作成してください。

```markdown
# Agent Definitions & Instructions

このプロジェクトでは、以下の役割を持つAIエージェントが協調して開発を行います。

## Project Instructions (System Prompt)
このプロジェクトでは「ドキュメント駆動開発」と「Agent Skills」ワークフローを採用しています。
すべての変更は、実装の前にドキュメント（SPEC.md, DESIGN.mdなど）に反映される必要があります。
(その他、コーディング規約や振る舞いに関するルールをここに記述してください)

## Roles
(プロジェクトのニーズに合わせて役割を追加・削除してください)

### 1. [Role Name] (role description)
- **責任**: ...
- **スキル**: ...

### examples:

### Architect (設計)
- **責任**: 要件定義、システム設計、技術選定、ドキュメント管理。
- **スキル**: `architect` (recommended)

### Developer (実装)
- **責任**: コードの実装、リファクタリング、単体テスト作成。
- **スキル**: `developer` (recommended)
```

### 2. スキルのインストール

`AGENTS.md` で定義した役割に必要なスキルをインストールします。

**Action:**
ユーザーと相談し、必要なスキルを選択してインストールしてください。

```bash
# 構文: npx skills add [skill-name]
npx skills add [required-skill]
```

> [!TIP]
> Tech Stack固有のスキルがある場合はそれらも提案してください。

### 4.- **プロジェクト構造の初期化**: 新しい機能開発やプロジェクト開始時に、標準的なディレクトリ構造と空のドキュメントセットを生成する。
- **一貫性の維持**: プロジェクトごとのルールや慣習に従った命名と配置を行う。

## ワークフロー

### 1. 構造の決定
- プロジェクトの標準ルール（`AGENTS.md` や既存のディレクトリ構成）を確認し、作成すべきディレクトリ構造を決定する。
- ユーザーからの指定があればそれに従う。

### 2. ディレクトリとファイルの生成
- 必要なディレクトリを作成（例: 機能別ドキュメントフォルダ）。
- 必須ドキュメント（要件定義書、設計書、コンテキストログなど）の空ファイルまたはテンプレートを作成。

### 3. 初期化
- 作成したファイルのヘッダーにタイトルや目的を記述し、スムーズに作業を開始できる状態にする。

## 完了後のステップ

環境構築手順の完了後、次のアクションについてはプロジェクトの現在のフェーズやユーザーの指示に基づき、エージェントが判断して提案を行ってください。
特定のスキルへの自動的な移行指示は含めないでください。

From Keiji-Miyake/kanon-ag, MIT.

More from Keiji-Miyake/kanon-ag