オリジナル・コンテンツ（イキナリLLMコーディング・エージェント）
をテンプレートにして作成
[
トップ
] [
新規
|
一覧
|
単語検索
|
最終更新
|
ヘルプ
]
開始行:
「[[.NET 開発基盤部会 Wiki>http://dotnetdevelopmentinfras...
-戻る（[[テキスト生成系（Transformer系）]] > [[学習系>テ...
--[[LLM Engineering：Master AI、Large Language Models＆Ag...
--[[The Complete Agentic AI Engineering Course (2025)]]
--[[オリジナル・コンテンツ（イキナリLLMからスタートしたい...
--[[Master Vibe Coding with AI Coding Agents：Claude Code...
--オリジナル・コンテンツ（イキナリLLMコーディング・エージ...
*目次 [#n80e5458]
#contents
*概要 [#y8372d92]
「[[生成AIを活用したプログラミング]]」ページ中で紹介した...
「[[Master Vibe Coding with AI Coding Agents：Claude Code...
...つまり、以下のような[[ユースケース>#y36341d5]]で活用可...
なお、以下の[[基礎知識>#d1186b77]]があることが望ましい（...
**基礎知識 [#d1186b77]
***[[LLM本体>テキスト生成系（Transformer系）]] [#reeb486e]
***[[LLMのPE]] [#s253c2b4]
***[[LLMのFT]] [#aae172c3]
***[[LLMエージェント]] [#j42a1f9c]
***[[推論エージェント]] [#y40562ba]
**ユースケース [#y36341d5]
***[[YOLO>#u184c92c]]（フィジスタ、PoC、MVP） [#x8f0d856]
要件のみ渡して開発を進める。フィジスタ、PoC、MVPなどで有...
***[[プロ用>#f924890e]]（フェーズ毎の実装＆検収） [#x6971...
-指示した仕様・計画で実装をさせて都度検収を行うプロ・ユー...
-[[ガイド（MDファイル）>#p678f949]]や[[スキル（最小構成で...
※ [[カスタム・フレームワークについての考察>https://claude...
***ドキュメント・フォワード [#fd70b0c1]
-[[YOLO>#x8f0d856]]で、要件のみで開発ができることから明ら...
-[[プロ・ユース>#x6971dcf]]の仕様や計画をエージェントが生...
※ 「[[生成AIを活用した設計書のブレークダウン]]」
***システム開発（インフラ構築） [#y2846cae]
（開発環境にも適用可能）
-構築系のシェル生成、シェル・スクリプト生成、IaC定義生成...
-Docker系の定義ファイル生成（Dockerfile、DockerCompose）...
※ 「[[生成AIを活用したシステム開発]]」（インフラ構築）
***移行・マイグレーション [#dfd64f65]
大規模コードベースを分析してAGENTS.md、AGENTS.md（CLAUDE....
-https://qiita.com/ryo_cresc/items/8d03bf0d9b4ee0a3c10b
-https://zenn.dev/idealog/articles/3707947be4f4aa
***ITアーキテクトの作業アレコレ [#ff3ecef8]
アーキテクトであればコーディング・エージェントとチャット...
-環境構築スクリプト、スキル開発
-開発用テンプレート実装
-各種の治工具ツール開発
-自動化スクリプトスキル、スキルスキル開発
-各種の問題点の修正：Review → Issue → Pull Request
-, etc.
***Coworkと変わらないカモ [#hf724b8e]
-Claude Cowork ≒ 推論エージェント
-Anthropic社製の推論エージェントラインナップ
-Coworkはエンド向けで、Codeでも同等のことが出来る。
--機能や処理のベースは同じなので、CodeでCoworkと同等のこ...
--GUIの操作性を重視するならCowork、ターミナル環境でのカス...
***PJマネージャーの作業アレコレ [#tddf3799]
PJマネージャーの作業は、[[アーキテクトの作業>#ff3ecef8]]...
-WordドキュメントのMarkDown化（Wiki公開）
-バグ・トラッキング・ツールのデータのメンテ、分析など。
-LLMの提案
--ブレークダウン
---要件からの仕様書生成
---仕様書からの実装プラン生成（工数見積も可能）
--品質管理とリスク検知
---非エンジニア目線でのセキュリティ・パフォーマンスリスク...
---「OWASP Top 10に基づく脆弱性」「ボトルネックになるクエ...
--クロス・リファレンス系
---影響範囲（ブラストレジアス）の自動特定
---コードベースからのアーキテクチャ・依存関係の自動図式化
---その他、仕様と実装の乖離を調査する。
--保守・運用フェーズ
---リリースノート・変更履歴の自動生成
---障害対応（インシデント）時の一次解析
**[[Chat>#xf267768]] / [[CLI>#x89a3719]]（UIの差異） [#g4...
***実は大きな差異はない。 [#a45c7914]
-GUIとCUIだが、そもそも文字列をプロンプトとして使用するLL...
-（ただし、IDE組込系チャットやパーソナルRAG系など、入力プ...
-また、[[昨今のCUIの隆盛>https://techinfoofmicrosofttech....
***ユースケースへの影響 [#w83dba74]
コレだけ単純なI/Fの話なので[[ユースケース>#y36341d5]]から...
-これに対し、モードの話の[[YOLO>#x8f0d856]]/[[プロ用>#x69...
-強いて言えば、[[Cowork系>#hf724b8e]]は、エンドユーザー向...
*詳細 [#y999f4cd]
**共通 [#e9a7cb9b]
プロダクトごとに共通
***MDファイル [#p678f949]
-一般的には、AGENTS.mdとPLAN.mdがある。~
その他にも、SPEC.mdなど、任意のMDファイルがあっても良い。
-実行前には、読む必要のあるMDファイルをエージェントに通知...
--「AGENTS.mdを参照し、SPEC.mdを生成して下さい。」（DOCフ...
--「AGENTS.md、SPEC.mdを参照し、PLAN.mdを生成して下さい。...
--「AGENTS.md、SPEC.md、PLAN.mdを参照し、PLAN の Phase N ...
-ファイルの配置場所
--プロジェクトに適用されるMDファイルはリポジトリ内に配置...
--階層が深い場合、サブ・プロジェクトのサブ・フォルダ毎に...
--個人に適用されるMDファイルはホーム・ディレクトリの「.プ...
-プロダクトごとの差異
--一般的には、AGENTS.md、PLAN.mdだが、
--Claude Codeの場合は、CLAUDE.md＝AGENTS.mdなので、
---CLAUDE.mdからAGENTS.mdをリンクするなどとすると共通化出...
---リンクには、MD記法（相対パスが必要）と「@」メンション...
--ホーム・ディレクトリの「.プロダクト名」のフォルダ名は、
---Cursor：.cursor
---GitHub Copilot：.copilot
---Claude Code：.claude
---OpenAI Codex：.codex
---Antigravity：.agents
-ガイドラインなど
--コーディング基準は、~
CODING_GUIDE.md（OSSではCONTRIBUTING.md）
--実装ガイドは、以下の様にするのが良い。
---概要をMDファイルをIMPLEMENTATION_GUIDE.md
---必要に応じて詳細を[[スキル>#gcfc7708]]として実装
※ [[事例>#vdaa54b6]]
***タスク [#o826db19]
エージェントに与えたお題に対して実行する作業単位。[[プロ...
-DOCフォワード：
--内容：要件 → 仕様（基本・詳細設計）へのブレークダウン
--プロンプト：「AGENTS.mdを参照し、SPEC.mdを生成して下さ...
-プランニング：
--内容：仕様（基本・詳細設計）→ 実装計画（概要）へのブレ...
--プロンプト：「AGENTS.md、SPEC.mdを参照し、PLAN.mdを生成...
-コーディング：
--内容：実装計画（概要）→ 実装計画（詳細）を作成してのコ...
--プロンプト：「AGENTS.md、SPEC.mdを参照し、PLAN.mdを参照...
※ [[実行順>#r389991b]]
***YOLO [#u184c92c]
YOLOモードは、確認無しにドンドン実装が進むオートパイロッ...
-レアだが危険な操作がされる可能性があるので、サンド・ボッ...
-CLAUDE.md＝AGENTS.mdのみで、SPECやPLANはエージェントに立...
-受入者も未知の技術を使用しPoC、MVPを実装させるケースで有...
***プロ用 [#f924890e]
プロ・モードはYOLOモードでなく、都度確認を行う。
-フェーズやステップ毎に実装を細切れに実行させ、都度作業内...
-ちなみに、SPECやPLANのブレークダウンをエージェントの助け...
-エンプラ開発のウォーターフォールや、サービス開発のアジャ...
**Chat [#xf267768]
***利用の流れ [#a7f3dca3]
[[コチラ>#r389991b]]
***使える機能 [#o68d389b]
[[CLI>#f91b7e22]]と同じ。ただし、CLIの「-」コマンドは使用...
**CLI [#x89a3719]
[[Chat>#xf267768]]と同じ。違いは、指示がし易い点。
-何気に、ChatもGUIと見せかけて文字列ベースなので、その差...
-両方文字列ベースのI/Fだと、機能差は無くとも、CLI風のI/F...
***利用の流れ [#bc6a8668]
-基本は、[[Chat>#xf267768]]と同じだが、以下の点で、CLIが...
-「/」コマンドの活用
--/status：実行にあたっての様々な状態を一望できる。
--/context、/compact、/clear：などでコンテキスト管理が容易
-実はインタラクティブ性能もCLIの方が高い。
--Chatだと基本は文字列になる。一部、Chatでの対応もされて...
--しかし、近年のCLIは「Chatでの対応」より優れたインタラク...
---疑似タブ切り替え（Tabs）
---セレクトボックス（Select / List Prompt）
---マルチセレクト / チェックボックス（Checkbox / Multi-se...
---トグル / トグルスイッチ（Toggle / Confirm）
***使える機能 [#f91b7e22]
[[各種機能>#p859f691]]が利用可能
-MDファイル、[[ツール>#pbd34c23]]、[[MCP>#ceb5e0e8]]、[[...
--[[コマンド>#l49ae306]]、[[サブ・エージェント>#pabed78f]...
--今となっては、GHCのチャットUIからも機能する。
-ただし、コマンドはCLIのモノと、LLMのモノとで内容が異なる。
--CLIの「-」コマンドは所謂、CLIのコマンドとして機能する。
--LLMの「/」コマンドは、内部でプロンプト/エージェント・フ...
**実装可能機能 [#p859f691]
-[[スキル>#gcfc7708]]、[[コマンド>#l49ae306]]、[[サブ・エ...
-標準化も進んでおり、選んだプラットフォームにまだ適用され...
***ツール [#pbd34c23]
-所謂一つの「[[Function calling>LLMエージェント#m3aa0a0b]...
-ただ、通常のエージェントでは基本的なツールは使えるようで...
***[[MCP>MCP（Model Context Protocol）]] [#ceb5e0e8]
-メイン・エージェントで使用可能なMCPサーバを追加する。
-セキュアに大規模なSaaS（GitHubやAtlassian）機能を活用す...
-認証が必要で再認証しないとエラーになったりすることが多い...
***サブ・エージェント [#pabed78f]
-別のコンテキスト・ウィンドウで実行する。
-メイン・エージェントと並列で動作させることができる。
-使用するLLM、ツール、システム・プロンプトを追加する。
-単純作業を廉価なLLMで実行したりすると良い。
***コマンド [#l49ae306]
（カスタムSlashコマンド）
-name属性をcommandとして利用可能な文字列を指定。
-description属性にユースケースについての解説を書く。
-メインコンテンツにコマンドが実行する内容を書く。
***[[スキル>Agent Skills]] [#gcfc7708]
-以前はcommandsに実装していたが、現在はskillsに実装するよ...
-name属性をcommandとして利用可能な文字列にすれば、カスタ...
-最小限のものであれば、MDファイル１つで定義可能。定義中に...
***フック [#h518819f]
-あまり使用されない。
-イベント発生時に自動的に処理を実行するなどの目的で使用す...
***[[プラグイン>Agent Plugins]] [#j4e59cd9]
-マーケット・プレイスから[[MCP>#ceb5e0e8]]、[[スキル>#gcf...
-これらの複数の機能を活用して、１つの処理（論理的な機能）...
*事例 [#ja0f2841]
**手順 [#r389991b]
-[[プロ・ユース>#x6971dcf]]では、[[タスク>#o826db19]]に書...
-[[なお「AGENTS.md」には様々なガイドラインへのリンクを張...
-[[AGENTS.md>#q703b854]]、[[SPEC.md>#qaeb62d7]]、[[PLAN.m...
--細かくフェーズやステップを分ける場合、「PLAN_X.md、SPEC...
--エージェントが生成したPLAN.mdに問題がなければ実装を実行...
***DOCフォワード [#n487f14b]
以下プロンプト例
-「AGENTS.mdを参照し、SPEC.mdを生成して下さい。」
-「AGENTS.md、SPEC.mdを参照し、モジュールXを対象としたSPE...
-...
***プランニング [#a84578ad]
以下プロンプト例
-「AGENTS.md、SPEC.mdを参照し、PLAN.mdを生成して下さい。」
-「AGENTS.md、SPEC_X.mdを参照し、PLAN_X.mdを生成して下さ...
-...
***コーディング [#u54728c5]
以下プロンプト例
-「AGENTS.md、SPEC(_X).mdを参照し、PLAN(_X).mdを実行して...
-「AGENTS.md、SPEC(_X).md、PLAN(_X).mdを参照し、PLAN(_X) ...
-...
※ エージェントがコーディングの前に「ホーム・ディレクトリ\...
**MDファイル [#vdaa54b6]
-[[AGENTS.md>#q703b854]]はリポジトリ直下に配置。
-エージェントの実装可能機能の定義はプロダクト指定のフォル...
（ルートフォルダ名以外は標準化されているケースが多い）
-ソレ以外のMDファイルのルート・フォルダは「docs」などとする
***AGENTS.md [#q703b854]
記載項目
-各種要件
--ビジネス要件：なぜやるか
--業務要件：業務をどう変えるか
--システム要件：システムに何を求めるか
---機能要件：システムに求める機能の要件（モジュール（責務...
---非機能要件：システムに求める非機能（品質系：性能、可用...
-環境構築
--開発環境
--デプロイ先環境
-プランニング方針
--始点と終点：要件からか仕様からか（何処までがFIXしている...
--共通的な開発フロー：プラン概要を詳細プランにブレークダ...
---設計：
・既存パターンを確認し、無いパターンは追加しない。
・新規実装の追加時は再利用を確認する。
---実装
・最初に、必要となるD層や共通部品を実装する。
・次いで、画面項目定義から画面を実装する。
・次いで、トランザクションルートとなるB層メソッドの土台...
・次いで、必要に応じてトランザクションを引き継ぐB層、引...
・次いで、画面イベントのハンドラを実装し、共通部品やトラ...
・次いで、B層メソッドを実装し、共通部品やD層メソッド呼び...
---テスト：
・基本方針：TDD的か？など。
・テスト実施タイミング：D層、B層、P層コード作成・修正後
-その他
--プロダクトに依っては、CLAUDE.md、GEMINI.mdに書く。
--CLAUDE.md、GEMINI.md内からインポート構文で「@AGENTS.md...
***SPEC.md [#qaeb62d7]
-開発対象のシステム機能の一覧と仕様を記載する。
-共通仕様をSPEC.md、個別仕様をSPEC_X.mdに記載するなど。
-一覧：機能一覧、画面一覧、画面遷移
--機能要件が主入力。
--ただし、業務要件・非機能要件から派生する機能も確認する。
-仕様：画面項目一覧、イベント一覧、イベント定義
--前述の一覧が主入力（画面一覧、画面遷移）。
--加えて、非機能要件、業務要件（業務ルール、権限、外部連...
※ 参考：[[生成AIを活用した設計書のブレークダウン]]
***PLAN.md [#r4ab70de]
-ハイレベルの実装計画をPLAN.mdに記述、サブプランをPLAN_X....
-個別のプランは実装開始前にエージェントがホーム・ディレク...
*** *_GUIDE.md [#pfb72985]
-コーディング基準：CODING_GUIDE.md
-ネーミング基準：NAMING_GUIDE.md
-実装ガイド：IMPLEMENTATION_GUIDE.md
-その他、必要に応じて追加：MMI標準など, etc.
**[[スキル>#gcfc7708]] [#xcc22a3e]
***... [#w19ea679]
***開発のコツ [#n0e50fad]
-実装ガイドの具体的な内容をスキル化する。
--スキルはある意味、MD形式の推論エージェント向け文字列開...
---新規作成時はドキュメントやコードを読ませ立ち上げ、以降...
---生成された文字列は人間が読むよりアテンションの効いた推...
---「人間から見ると記号的で無機質、あるいは過剰に厳密で読...
---カナリ多くのスキルを開発してみたが、自分で書くことはほ...
--スキル開発で人間が主に指摘した事
---「重複、分割、記載箇所、実測したがスキル記載には不要。...
---AI曰く編集規律「正確性、正しい配置・範囲、簡潔さ、体系...
-環境構築、自動化スキル
--「[[生成AIを活用したシステム開発]]」にも書いたが「環境...
--LLMは揺らぎがあり、且つ、高コストなのでエージェントが自...
-ドキュメント・フォワード
--きっと何かあるケド、現状は不明
*参考 [#r1ca168f]
終了行:
「[[.NET 開発基盤部会 Wiki>http://dotnetdevelopmentinfras...
-戻る（[[テキスト生成系（Transformer系）]] > [[学習系>テ...
--[[LLM Engineering：Master AI、Large Language Models＆Ag...
--[[The Complete Agentic AI Engineering Course (2025)]]
--[[オリジナル・コンテンツ（イキナリLLMからスタートしたい...
--[[Master Vibe Coding with AI Coding Agents：Claude Code...
--オリジナル・コンテンツ（イキナリLLMコーディング・エージ...
*目次 [#n80e5458]
#contents
*概要 [#y8372d92]
「[[生成AIを活用したプログラミング]]」ページ中で紹介した...
「[[Master Vibe Coding with AI Coding Agents：Claude Code...
...つまり、以下のような[[ユースケース>#y36341d5]]で活用可...
なお、以下の[[基礎知識>#d1186b77]]があることが望ましい（...
**基礎知識 [#d1186b77]
***[[LLM本体>テキスト生成系（Transformer系）]] [#reeb486e]
***[[LLMのPE]] [#s253c2b4]
***[[LLMのFT]] [#aae172c3]
***[[LLMエージェント]] [#j42a1f9c]
***[[推論エージェント]] [#y40562ba]
**ユースケース [#y36341d5]
***[[YOLO>#u184c92c]]（フィジスタ、PoC、MVP） [#x8f0d856]
要件のみ渡して開発を進める。フィジスタ、PoC、MVPなどで有...
***[[プロ用>#f924890e]]（フェーズ毎の実装＆検収） [#x6971...
-指示した仕様・計画で実装をさせて都度検収を行うプロ・ユー...
-[[ガイド（MDファイル）>#p678f949]]や[[スキル（最小構成で...
※ [[カスタム・フレームワークについての考察>https://claude...
***ドキュメント・フォワード [#fd70b0c1]
-[[YOLO>#x8f0d856]]で、要件のみで開発ができることから明ら...
-[[プロ・ユース>#x6971dcf]]の仕様や計画をエージェントが生...
※ 「[[生成AIを活用した設計書のブレークダウン]]」
***システム開発（インフラ構築） [#y2846cae]
（開発環境にも適用可能）
-構築系のシェル生成、シェル・スクリプト生成、IaC定義生成...
-Docker系の定義ファイル生成（Dockerfile、DockerCompose）...
※ 「[[生成AIを活用したシステム開発]]」（インフラ構築）
***移行・マイグレーション [#dfd64f65]
大規模コードベースを分析してAGENTS.md、AGENTS.md（CLAUDE....
-https://qiita.com/ryo_cresc/items/8d03bf0d9b4ee0a3c10b
-https://zenn.dev/idealog/articles/3707947be4f4aa
***ITアーキテクトの作業アレコレ [#ff3ecef8]
アーキテクトであればコーディング・エージェントとチャット...
-環境構築スクリプト、スキル開発
-開発用テンプレート実装
-各種の治工具ツール開発
-自動化スクリプトスキル、スキルスキル開発
-各種の問題点の修正：Review → Issue → Pull Request
-, etc.
***Coworkと変わらないカモ [#hf724b8e]
-Claude Cowork ≒ 推論エージェント
-Anthropic社製の推論エージェントラインナップ
-Coworkはエンド向けで、Codeでも同等のことが出来る。
--機能や処理のベースは同じなので、CodeでCoworkと同等のこ...
--GUIの操作性を重視するならCowork、ターミナル環境でのカス...
***PJマネージャーの作業アレコレ [#tddf3799]
PJマネージャーの作業は、[[アーキテクトの作業>#ff3ecef8]]...
-WordドキュメントのMarkDown化（Wiki公開）
-バグ・トラッキング・ツールのデータのメンテ、分析など。
-LLMの提案
--ブレークダウン
---要件からの仕様書生成
---仕様書からの実装プラン生成（工数見積も可能）
--品質管理とリスク検知
---非エンジニア目線でのセキュリティ・パフォーマンスリスク...
---「OWASP Top 10に基づく脆弱性」「ボトルネックになるクエ...
--クロス・リファレンス系
---影響範囲（ブラストレジアス）の自動特定
---コードベースからのアーキテクチャ・依存関係の自動図式化
---その他、仕様と実装の乖離を調査する。
--保守・運用フェーズ
---リリースノート・変更履歴の自動生成
---障害対応（インシデント）時の一次解析
**[[Chat>#xf267768]] / [[CLI>#x89a3719]]（UIの差異） [#g4...
***実は大きな差異はない。 [#a45c7914]
-GUIとCUIだが、そもそも文字列をプロンプトとして使用するLL...
-（ただし、IDE組込系チャットやパーソナルRAG系など、入力プ...
-また、[[昨今のCUIの隆盛>https://techinfoofmicrosofttech....
***ユースケースへの影響 [#w83dba74]
コレだけ単純なI/Fの話なので[[ユースケース>#y36341d5]]から...
-これに対し、モードの話の[[YOLO>#x8f0d856]]/[[プロ用>#x69...
-強いて言えば、[[Cowork系>#hf724b8e]]は、エンドユーザー向...
*詳細 [#y999f4cd]
**共通 [#e9a7cb9b]
プロダクトごとに共通
***MDファイル [#p678f949]
-一般的には、AGENTS.mdとPLAN.mdがある。~
その他にも、SPEC.mdなど、任意のMDファイルがあっても良い。
-実行前には、読む必要のあるMDファイルをエージェントに通知...
--「AGENTS.mdを参照し、SPEC.mdを生成して下さい。」（DOCフ...
--「AGENTS.md、SPEC.mdを参照し、PLAN.mdを生成して下さい。...
--「AGENTS.md、SPEC.md、PLAN.mdを参照し、PLAN の Phase N ...
-ファイルの配置場所
--プロジェクトに適用されるMDファイルはリポジトリ内に配置...
--階層が深い場合、サブ・プロジェクトのサブ・フォルダ毎に...
--個人に適用されるMDファイルはホーム・ディレクトリの「.プ...
-プロダクトごとの差異
--一般的には、AGENTS.md、PLAN.mdだが、
--Claude Codeの場合は、CLAUDE.md＝AGENTS.mdなので、
---CLAUDE.mdからAGENTS.mdをリンクするなどとすると共通化出...
---リンクには、MD記法（相対パスが必要）と「@」メンション...
--ホーム・ディレクトリの「.プロダクト名」のフォルダ名は、
---Cursor：.cursor
---GitHub Copilot：.copilot
---Claude Code：.claude
---OpenAI Codex：.codex
---Antigravity：.agents
-ガイドラインなど
--コーディング基準は、~
CODING_GUIDE.md（OSSではCONTRIBUTING.md）
--実装ガイドは、以下の様にするのが良い。
---概要をMDファイルをIMPLEMENTATION_GUIDE.md
---必要に応じて詳細を[[スキル>#gcfc7708]]として実装
※ [[事例>#vdaa54b6]]
***タスク [#o826db19]
エージェントに与えたお題に対して実行する作業単位。[[プロ...
-DOCフォワード：
--内容：要件 → 仕様（基本・詳細設計）へのブレークダウン
--プロンプト：「AGENTS.mdを参照し、SPEC.mdを生成して下さ...
-プランニング：
--内容：仕様（基本・詳細設計）→ 実装計画（概要）へのブレ...
--プロンプト：「AGENTS.md、SPEC.mdを参照し、PLAN.mdを生成...
-コーディング：
--内容：実装計画（概要）→ 実装計画（詳細）を作成してのコ...
--プロンプト：「AGENTS.md、SPEC.mdを参照し、PLAN.mdを参照...
※ [[実行順>#r389991b]]
***YOLO [#u184c92c]
YOLOモードは、確認無しにドンドン実装が進むオートパイロッ...
-レアだが危険な操作がされる可能性があるので、サンド・ボッ...
-CLAUDE.md＝AGENTS.mdのみで、SPECやPLANはエージェントに立...
-受入者も未知の技術を使用しPoC、MVPを実装させるケースで有...
***プロ用 [#f924890e]
プロ・モードはYOLOモードでなく、都度確認を行う。
-フェーズやステップ毎に実装を細切れに実行させ、都度作業内...
-ちなみに、SPECやPLANのブレークダウンをエージェントの助け...
-エンプラ開発のウォーターフォールや、サービス開発のアジャ...
**Chat [#xf267768]
***利用の流れ [#a7f3dca3]
[[コチラ>#r389991b]]
***使える機能 [#o68d389b]
[[CLI>#f91b7e22]]と同じ。ただし、CLIの「-」コマンドは使用...
**CLI [#x89a3719]
[[Chat>#xf267768]]と同じ。違いは、指示がし易い点。
-何気に、ChatもGUIと見せかけて文字列ベースなので、その差...
-両方文字列ベースのI/Fだと、機能差は無くとも、CLI風のI/F...
***利用の流れ [#bc6a8668]
-基本は、[[Chat>#xf267768]]と同じだが、以下の点で、CLIが...
-「/」コマンドの活用
--/status：実行にあたっての様々な状態を一望できる。
--/context、/compact、/clear：などでコンテキスト管理が容易
-実はインタラクティブ性能もCLIの方が高い。
--Chatだと基本は文字列になる。一部、Chatでの対応もされて...
--しかし、近年のCLIは「Chatでの対応」より優れたインタラク...
---疑似タブ切り替え（Tabs）
---セレクトボックス（Select / List Prompt）
---マルチセレクト / チェックボックス（Checkbox / Multi-se...
---トグル / トグルスイッチ（Toggle / Confirm）
***使える機能 [#f91b7e22]
[[各種機能>#p859f691]]が利用可能
-MDファイル、[[ツール>#pbd34c23]]、[[MCP>#ceb5e0e8]]、[[...
--[[コマンド>#l49ae306]]、[[サブ・エージェント>#pabed78f]...
--今となっては、GHCのチャットUIからも機能する。
-ただし、コマンドはCLIのモノと、LLMのモノとで内容が異なる。
--CLIの「-」コマンドは所謂、CLIのコマンドとして機能する。
--LLMの「/」コマンドは、内部でプロンプト/エージェント・フ...
**実装可能機能 [#p859f691]
-[[スキル>#gcfc7708]]、[[コマンド>#l49ae306]]、[[サブ・エ...
-標準化も進んでおり、選んだプラットフォームにまだ適用され...
***ツール [#pbd34c23]
-所謂一つの「[[Function calling>LLMエージェント#m3aa0a0b]...
-ただ、通常のエージェントでは基本的なツールは使えるようで...
***[[MCP>MCP（Model Context Protocol）]] [#ceb5e0e8]
-メイン・エージェントで使用可能なMCPサーバを追加する。
-セキュアに大規模なSaaS（GitHubやAtlassian）機能を活用す...
-認証が必要で再認証しないとエラーになったりすることが多い...
***サブ・エージェント [#pabed78f]
-別のコンテキスト・ウィンドウで実行する。
-メイン・エージェントと並列で動作させることができる。
-使用するLLM、ツール、システム・プロンプトを追加する。
-単純作業を廉価なLLMで実行したりすると良い。
***コマンド [#l49ae306]
（カスタムSlashコマンド）
-name属性をcommandとして利用可能な文字列を指定。
-description属性にユースケースについての解説を書く。
-メインコンテンツにコマンドが実行する内容を書く。
***[[スキル>Agent Skills]] [#gcfc7708]
-以前はcommandsに実装していたが、現在はskillsに実装するよ...
-name属性をcommandとして利用可能な文字列にすれば、カスタ...
-最小限のものであれば、MDファイル１つで定義可能。定義中に...
***フック [#h518819f]
-あまり使用されない。
-イベント発生時に自動的に処理を実行するなどの目的で使用す...
***[[プラグイン>Agent Plugins]] [#j4e59cd9]
-マーケット・プレイスから[[MCP>#ceb5e0e8]]、[[スキル>#gcf...
-これらの複数の機能を活用して、１つの処理（論理的な機能）...
*事例 [#ja0f2841]
**手順 [#r389991b]
-[[プロ・ユース>#x6971dcf]]では、[[タスク>#o826db19]]に書...
-[[なお「AGENTS.md」には様々なガイドラインへのリンクを張...
-[[AGENTS.md>#q703b854]]、[[SPEC.md>#qaeb62d7]]、[[PLAN.m...
--細かくフェーズやステップを分ける場合、「PLAN_X.md、SPEC...
--エージェントが生成したPLAN.mdに問題がなければ実装を実行...
***DOCフォワード [#n487f14b]
以下プロンプト例
-「AGENTS.mdを参照し、SPEC.mdを生成して下さい。」
-「AGENTS.md、SPEC.mdを参照し、モジュールXを対象としたSPE...
-...
***プランニング [#a84578ad]
以下プロンプト例
-「AGENTS.md、SPEC.mdを参照し、PLAN.mdを生成して下さい。」
-「AGENTS.md、SPEC_X.mdを参照し、PLAN_X.mdを生成して下さ...
-...
***コーディング [#u54728c5]
以下プロンプト例
-「AGENTS.md、SPEC(_X).mdを参照し、PLAN(_X).mdを実行して...
-「AGENTS.md、SPEC(_X).md、PLAN(_X).mdを参照し、PLAN(_X) ...
-...
※ エージェントがコーディングの前に「ホーム・ディレクトリ\...
**MDファイル [#vdaa54b6]
-[[AGENTS.md>#q703b854]]はリポジトリ直下に配置。
-エージェントの実装可能機能の定義はプロダクト指定のフォル...
（ルートフォルダ名以外は標準化されているケースが多い）
-ソレ以外のMDファイルのルート・フォルダは「docs」などとする
***AGENTS.md [#q703b854]
記載項目
-各種要件
--ビジネス要件：なぜやるか
--業務要件：業務をどう変えるか
--システム要件：システムに何を求めるか
---機能要件：システムに求める機能の要件（モジュール（責務...
---非機能要件：システムに求める非機能（品質系：性能、可用...
-環境構築
--開発環境
--デプロイ先環境
-プランニング方針
--始点と終点：要件からか仕様からか（何処までがFIXしている...
--共通的な開発フロー：プラン概要を詳細プランにブレークダ...
---設計：
・既存パターンを確認し、無いパターンは追加しない。
・新規実装の追加時は再利用を確認する。
---実装
・最初に、必要となるD層や共通部品を実装する。
・次いで、画面項目定義から画面を実装する。
・次いで、トランザクションルートとなるB層メソッドの土台...
・次いで、必要に応じてトランザクションを引き継ぐB層、引...
・次いで、画面イベントのハンドラを実装し、共通部品やトラ...
・次いで、B層メソッドを実装し、共通部品やD層メソッド呼び...
---テスト：
・基本方針：TDD的か？など。
・テスト実施タイミング：D層、B層、P層コード作成・修正後
-その他
--プロダクトに依っては、CLAUDE.md、GEMINI.mdに書く。
--CLAUDE.md、GEMINI.md内からインポート構文で「@AGENTS.md...
***SPEC.md [#qaeb62d7]
-開発対象のシステム機能の一覧と仕様を記載する。
-共通仕様をSPEC.md、個別仕様をSPEC_X.mdに記載するなど。
-一覧：機能一覧、画面一覧、画面遷移
--機能要件が主入力。
--ただし、業務要件・非機能要件から派生する機能も確認する。
-仕様：画面項目一覧、イベント一覧、イベント定義
--前述の一覧が主入力（画面一覧、画面遷移）。
--加えて、非機能要件、業務要件（業務ルール、権限、外部連...
※ 参考：[[生成AIを活用した設計書のブレークダウン]]
***PLAN.md [#r4ab70de]
-ハイレベルの実装計画をPLAN.mdに記述、サブプランをPLAN_X....
-個別のプランは実装開始前にエージェントがホーム・ディレク...
*** *_GUIDE.md [#pfb72985]
-コーディング基準：CODING_GUIDE.md
-ネーミング基準：NAMING_GUIDE.md
-実装ガイド：IMPLEMENTATION_GUIDE.md
-その他、必要に応じて追加：MMI標準など, etc.
**[[スキル>#gcfc7708]] [#xcc22a3e]
***... [#w19ea679]
***開発のコツ [#n0e50fad]
-実装ガイドの具体的な内容をスキル化する。
--スキルはある意味、MD形式の推論エージェント向け文字列開...
---新規作成時はドキュメントやコードを読ませ立ち上げ、以降...
---生成された文字列は人間が読むよりアテンションの効いた推...
---「人間から見ると記号的で無機質、あるいは過剰に厳密で読...
---カナリ多くのスキルを開発してみたが、自分で書くことはほ...
--スキル開発で人間が主に指摘した事
---「重複、分割、記載箇所、実測したがスキル記載には不要。...
---AI曰く編集規律「正確性、正しい配置・範囲、簡潔さ、体系...
-環境構築、自動化スキル
--「[[生成AIを活用したシステム開発]]」にも書いたが「環境...
--LLMは揺らぎがあり、且つ、高コストなのでエージェントが自...
-ドキュメント・フォワード
--きっと何かあるケド、現状は不明
*参考 [#r1ca168f]
ページ名:
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
