ai-dev-template

KO | EN

gitlite — search

#javascript #python #ai #android #linux #macos #nodejs #windows #awesome #kubernetes #vue #ios #openai #open-source

ai-dev-template

(★ 11)

No description available.

ai-dev-template Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# .github 配下の概要

> `.github/` 配下のカスタムエージェントとスキルの全体像

---

## 概要

このリポジトリでは、`.github/` 配下に GitHub Copilot のカスタムエージェント（`agents/`）とスキル（`skills/`）を格納している。これらを組み合わせることで、仕様策定から実装・テスト・マージまでの機能開発ライフサイクルを自律的に進行できる。

### 主要コンポーネント

| コンポーネント | 配置 | 概要 |
|---------------|------|------|
| カスタムエージェント | `.github/agents/` | 7 つの専門エージェントが協調して機能開発を遂行する |
| スキル | `.github/skills/` | エージェントや開発者が参照するルール・ナレッジ・ツール定義（23 スキル） |
| Copilot 指示書 | `.github/copilot-instructions.md` | リポジトリ全体の開発ワークフローガイド |

---

## 1. 開発の流れ

開発は以下の流れで進行する。

```mermaid
flowchart LR
    A[ユーザーストーリー読み取り] --> B{変更規模}
    B -->|機能開発| C["/feature-lifecycle"]
    B -->|軽微な修正| D["/quick-fix"]
    C --> E[仕様策定]
    E --> F[設計・実装]
    F --> G[テスト・レビュー]
    G --> H[マージ・ドキュメント更新]
    D --> F
```

1. **ユーザーストーリーの読み取り** — `docs/user-stories/` 配下の Excel 設計書を `office-document-analyzer` スキルで解析し、要件を把握する
2. **feature-lifecycle による開発** — 新機能や大きな変更は `/feature-lifecycle` スキルで Orchestrator を起動し、仕様策定からマージまでの全サイクルを自律的に進行する
3. **quick-fix による軽微な修正** — 既存 PR に対する小規模な修正は `/quick-fix` スキルで、仕様策定・E2E テストをスキップして迅速に対応する

---

## 2. Orchestrator とエージェント

Orchestrator は機能開発のライフサイクル全体を駆動する指揮者エージェントである。各フェーズで適切な専門エージェントに作業を委譲し、状態管理とエスカレーションを担う。

### エージェント一覧

| エージェント | 役割 | 主な成果物 |
|------------|------|-----------|
| Orchestrator | ライフサイクル全体の駆動・状態管理・委譲 | Issue/PR コメントによる進捗記録 |
| Product Manager | 要件分析・仕様書 Issue 作成 | GitHub Issue（仕様書） |
| Architect | 設計レビュー・完成判断 | COMPLETE / INCOMPLETE 判定 |
| Developer | 実装・ビルド・ユニットテスト・PR 作成 | feature ブランチ・Draft PR |
| Reviewer | 仕様/コードレビュー | APPROVE / REQUEST CHANGES 判定 |
| Tester | E2E テスト実行・バグ報告 | PASS / FAIL 判定・バグレポート |
| Documentation | ドキュメント追従更新 | docs/ 配下の更新 |

### 連携フロー

```mermaid
sequenceDiagram
    participant O as Orchestrator
    participant PM as Product Manager
    participant A as Architect
    participant D as Developer
    participant R as Reviewer
    participant T as Tester
    participant Doc as Documentation

O->>PM: 仕様策定を依頼
    PM-->>O: 仕様書 Issue 作成完了
    O->>A: 設計レビューを依頼
    A-->>O: COMPLETE
    O->>D: 実装を依頼
    D-->>O: Draft PR 作成完了
    O->>R: コードレビューを依頼
    R-->>O: APPROVE
    O->>T: E2E テストを依頼
    T-->>O: PASS
    O->>Doc: ドキュメント更新を依頼
    Doc-->>O: DONE
    O->>O: Squash Merge
```

---

## 3. Skills

### 開発ワークフロー

自律的な開発サイクルを駆動するスキル。

| スキル | 概要 |
|--------|------|
| [feature-lifecycle](.github/skills/feature-lifecycle/SKILL.md) | Orchestrator 主導で仕様策定からマージまでの全ライフサイクルを自律的に進行する |
| [quick-fix](.github/skills/quick-fix/SKILL.md) | 既存 PR に対する軽微な修正を、重いフェーズをスキップして迅速に実行する |

### プロジェクトの設計思想

アーキテクチャと開発フローの基本方針を定義するスキル。

| スキル | 概要 |
|--------|------|
| [clean-architecture-guide](.github/skills/clean-architecture-guide/SKILL.md) | Modular Monolith + Clean Architecture の設計ルールを定義する |
| [github-flow](.github/skills/github-flow/SKILL.md) | feature ブランチから Draft PR、Squash Merge までの GitHub Flow を定義する |

### LLM の知識ギャップを埋める最新情報

LLM の学習データに含まれない最新の技術情報を補完するスキル。

| スキル | 概要 |
|--------|------|
| [dotnet10](.github/skills/dotnet10/SKILL.md) | .NET 10 / C# 14 の新機能リファレンス |
| [aspnetcore-blazor10](.github/skills/aspnetcore-blazor10/SKILL.md) | ASP.NET Core 10 / Blazor .NET 10 の新機能リファレンス |
| [microsoft-docs](.github/skills/microsoft-docs/SKILL.md) | Microsoft 公式ドキュメントの検索・参照 |
| [microsoft-code-reference](.github/skills/microsoft-code-reference/SKILL.md) | Microsoft API リファレンス・コードサンプルの検索 |

### 技術スタック

このリポジトリで扱う主要技術に関するスキル。

| スキル | 概要 |
|--------|------|
| [aspire](.github/skills/aspire/SKILL.md) | Aspire による分散アプリケーションの構成・実行・デバッグ |
| [aspnet-minimal-api-openapi](.github/skills/aspnet-minimal-api-openapi/SKILL.md) | ASP.NET Minimal API + OpenAPI のエンドポイント実装 |
| [cosmosdb-datamodeling](.github/skills/cosmosdb-datamodeling/SKILL.md) | Azure Cosmos DB のデータモデル設計 |

### Azure インフラ

Azure のアーキテクチャ設計とデプロイ検証に関するスキル。

| スキル | 概要 |
|--------|------|
| [azure-architecture-autopilot](.github/skills/azure-architecture-autopilot/SKILL.md) | 自然言語による Azure アーキテクチャ設計・分析・Bicep 生成 |
| [azure-deployment-preflight](.github/skills/azure-deployment-preflight/SKILL.md) | Azure / Bicep / azd デプロイ前の事前検証 |

### コーディング品質

.NET / C# のコーディング品質を維持するためのスキル。

| スキル | 概要 |
|--------|------|
| [dotnet-best-practices](.github/skills/dotnet-best-practices/SKILL.md) | .NET / C# のベストプラクティスとコーディング規約 |
| [csharp-async](.github/skills/csharp-async/SKILL.md) | C# 非同期プログラミングのベストプラクティス |

### テスト

ユニットテストと E2E テストに関するスキル。

| スキル | 概要 |
|--------|------|
| [csharp-mstest](.github/skills/csharp-mstest/SKILL.md) | MSTest によるユニットテストの作成 |
| [e2e-test](.github/skills/e2e-test/SKILL.md) | ヘッドレスブラウザによる E2E テストの実行とスクリーンショット保存 |
| [playwright-cli](.github/skills/playwright-cli/SKILL.md) | Playwright を使ったブラウザ自動化（テスト生成・トレース・録画） |

### 仕様・ドキュメント管理

仕様書とドキュメントの作成・更新に関するスキル。

| スキル | 概要 |
|--------|------|
| [create-specification](.github/skills/create-specification/SKILL.md) | AI 向けに最適化された仕様書を GitHub Issue として新規作成する |
| [update-specification](.github/skills/update-specification/SKILL.md) | 既存の仕様書 Issue を変更内容に基づいて更新する |
| [office-document-analyzer](.github/skills/office-document-analyzer/SKILL.md) | Excel / PowerPoint 等の設計書を解析して内容を読み取る |
| [documentation-guide](.github/skills/documentation-guide/SKILL.md) | Markdown ドキュメント作成・更新時の共通ルール |

### ユーティリティ

その他の補助スキル。

| スキル | 概要 |
|--------|------|
| [scripting-guide](.github/skills/scripting-guide/SKILL.md) | Python / C# スクリプトによる小規模データ処理のガイド |

ai-dev-template

ai-dev-template Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ai-dev-template

ai-dev-template Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README