README.md

OpenTouryoCodingAgentAssets

Assets used by coding agents utilizing OpenTouryo

OpenTouryo を利用したアプリケーション開発を、 コーディングエージェント（Claude Code / GitHub Copilot / Codex など）に行わせるためのアセット集。

構成

src/
  instructions/AGENTS.md        概要・規約（常時コンテキストに載る / これが原本）
  skills/                        （用途・利用者で分類。アルファベット順ではない）

    # ── ① 立ち上げ・構成（初期設定：立ち上げ担当／纏め者。主に一度きり）──
    opentouryo-project-setup/           新規プロジェクトの立ち上げ（入口＝ファサード。全体の流れと呼び出し順）
    opentouryo-project-setup-selection/ ①② サンプル選択・取得元（固定タグ/develop）
    opentouryo-project-setup-build/     ③ 基盤 DLL のビルドとベンダ（タグ更新の焼き直しにも単独で）
    opentouryo-project-setup-core/      ④⑤ 取り出しと参照張り替え（HintPath・CS0246 解消）
    opentouryo-project-setup-config/    ⑥⑦ resource 移設・config 張替・.gitignore・検証
    opentouryo-project-transform/       セットアップ後の変形（2層化・サンプル整理・CS0246 解消）
    opentouryo-project-policy/          プロジェクト方針（親クラス2 の挙動）の確認
    opentouryo-base2-customize/         親クラス2（基盤 Business 層）のカスタマイズ（纏め者向け）

    # ── ② 各層のコード実装（日常常用：アプリ開発者）──
    opentouryo-layer-p-mvc/             P層：ASP.NET MVC / ASP.NET Core MVC
    opentouryo-layer-p-webforms-screen/ P層：Web Forms 画面の新規作成
    opentouryo-layer-p-webforms-event/  P層：Web Forms イベント実装
    opentouryo-webforms-dialog/         P層：Web Forms 子画面（ダイアログ）表示
    opentouryo-layer-p-winforms-screen/ P層：Windows Forms 画面の新規作成
    opentouryo-layer-p-winforms-event/  P層：Windows Forms イベント実装
    opentouryo-p-call-business/         P層から B層を呼び出す（横断）
    opentouryo-richclient-async/        リッチクライアントの非同期呼び出し（WinForms / WPF）
    opentouryo-layer-b/                 B層（業務ロジック層）の実装
    opentouryo-layer-d/                 D層の全体像と Dao 3系統の使い分け
    opentouryo-dao-custom/              個別Dao
    opentouryo-dao-common/              共通Dao（CmnDao）
    opentouryo-dao-generated/           自動生成Dao
    opentouryo-query-definition/        SQL定義ファイル（静的 .sql / 動的 .xml）

    # ── ③ 制御・定義／横断機能（機能利用：必要になったとき参照）──
    opentouryo-message/                 メッセージ（MSGDefinition.xml）
    opentouryo-shared-property/         共有情報（SPDefinition.xml）
    opentouryo-transaction-control/     トランザクション制御（TCDefinition.xml）
    opentouryo-screen-transition/       画面遷移制御（SCDefinition.xml）
    opentouryo-transmission/            通信制御（サービス論理名による呼び出し）
    opentouryo-exception/               例外処理方式
    opentouryo-logging/                 ログ出力
    opentouryo-config/                  構成ファイル
    opentouryo-auth/                    認証・ユーザ情報
    opentouryo-oauth2-client/           外部IdP連携（OAuth2 / OIDC クライアント）
    opentouryo-common-parts/            共通部品（ユーティリティ）を用途から探す
install/
  install.ps1                   対象リポジトリへのインストーラ
docs/
  authoring.md                  アセット執筆ガイド

インストラクション（概要）とスキル（具体的なコードの書き方）に分かれている。 前者は常にコンテキストへ載り、後者はエージェントが必要と判断したときだけ読まれる。 使い分けの基準は docs/authoring.md を参照。

スキルの互換性

スキルは Agent Skills のオープン標準（SKILL.md）に準拠している。 Claude Code / GitHub Copilot / Cursor / Codex CLI / Gemini CLI など、標準に対応した 30以上のツールが同一のスキルを読める。1回書けば全プロダクトで使える。

プロダクト差分はインストラクション側にのみ存在し、インストーラが吸収する。

インストール

このリポジトリを git clone し、clone した場所からインストーラを実行する。 install.ps1 は隣接する src/（instructions / skills）を読むため、単体でコピーしても動かない。 導入先のアプリ リポジトリは -TargetRoot で指定する（既定はカレント ディレクトリ）。 Windows PowerShell 5.1 / PowerShell 7 のどちらでも動く。

# ① このリポジトリを取得
git clone https://github.com/OpenTouryoProject/OpenTouryoCodingAgentAssets.git
cd OpenTouryoCodingAgentAssets

# ② clone した場所から実行。導入先は -TargetRoot（Claude Code 向けに全スキル）
./install/install.ps1 -Product claude -TargetRoot C:\git\MyApp

# 複数プロダクト・スキルを絞って
./install/install.ps1 -Product claude,copilot -Skill opentouryo-layer-d -TargetRoot C:\git\MyApp

# 実際には書き込まず、何が行われるか確認
./install/install.ps1 -Product agents -WhatIf -TargetRoot C:\git\MyApp

配置先

プロダクト	インストラクション	スキル
claude	CLAUDE.md（AGENTS.md を @ import）	.claude/skills/
copilot	.github/copilot-instructions.md（複製）	.github/skills/
agents	AGENTS.md	.agents/skills/

AGENTS.md はどのプロダクトでも対象リポジトリのルートへ配置される（これが原本）。 Claude Code は AGENTS.md を読まないため、それを @ import する CLAUDE.md を別途生成する。

既存ファイルは、インストーラが生成したもの（生成マーカー付き）でない限り上書きされない。 上書きするには -Force を指定する。

ライセンス

MIT