Skip to content

Commit 8e65894

Browse files
icoxfog417Copilot
andauthored
Update Amazon Q Developer CLI references to Kiro CLI (#175)
* Update Amazon Q Developer CLI references to Kiro CLI - Renamed .amazonq directory to .kiro - Updated all documentation references from Amazon Q Developer CLI to Kiro CLI - Updated agent configuration paths - Added Kiro branding assets * Update README.md Co-authored-by: Copilot <[email protected]> --------- Co-authored-by: Copilot <[email protected]>
1 parent f8f083a commit 8e65894

File tree

9 files changed

+58
-40
lines changed

9 files changed

+58
-40
lines changed
File renamed without changes.

README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@ ML Enablement Workshop は、生成 AI を含めた AI/ML 技術をプロダク
1313
ワークショップを始める際は、参加者に対しワークショップの意義と役割を伝える [Day0](https://github.com/aws-samples/aws-ml-enablement-workshop/blob/main/docs/organizer/day0.md) から始めます。Day0 実施後、実践編・改善編の 2 部構成プログラムに進みます。
1414

1515
* [**Day0**](./docs/organizer/day0.md) で、開始条件の確認と開始前の準備事項を確認します
16-
* [**実践編**](./docs/organizer/day1.md) で Amazon のプロダクト開発プロセスを実践し新規プロダクト / 機能のプレスリリースを複数作成します。同時に、それらを生成 AI に与え仮説検証を行うためのモックを構築します
17-
* [**改善編**](./docs/organizer/day2.md) でモックを通じて得られた知見を統合し、参加者自信で Amazon のプロセスを実践しプレスリリースを更新します。その後、今後 3~6 カ月でリリースするための最初のステップを計画します
16+
* [**実践編**](./docs/organizer/day1.md) で Amazon のプロダクト開発プロセスを実践し、**生成 AI と共に**新規プロダクト / 機能のプレスリリースを複数作成します。同時に、それらから仮説検証を行うためのモックを構築します (参考 : [当日の流れ](https://github.com/aws-samples/aws-ml-enablement-workshop/tree/main/yourwork))
17+
* [**改善編**](./docs/organizer/day2.md) でモックを通じて得られた知見を統合し、参加者自身で Amazon のプロセスを実践しプレスリリースを更新します。その後、今後 3~6 カ月でリリースするための最初のステップを計画します
1818

1919
| Title |Day0: 目的と役割の確認|実践編: Amazon 流を実践|改善編: 仮説検証の自走を開始|
2020
|:--------|:---------|:------|:------|
@@ -28,6 +28,10 @@ ML Enablement Workshop のメリットは次の通りです。
2828
* 🤖 **生成 AI を企画からモック構築の全工程に適用する経験を通じプロダクト開発プロセスを洗練できる**
2929
* 🛠 **モックを使ったフィードバック取得を実践することで、机上の空論に留まらない企画を作成できる**
3030

31+
| Point | Message|
32+
|:------|:------|
33+
|<img src="docs/images/top/kiro.svg" width=50/> | 生成 AI として仕様駆動を実践する [Kiro CLI](https://kiro.dev/docs/cli/) を使用しており、ワークショップ実施後に仕様を基にした設計・実装へとスムーズに移行できます。|
34+
3135
### 成果物例
3236

3337
企画の一例として、「英語会議を開催するための英会話能力向上」をテーマにワークショップのガイドに従い生成 AI で Working Backwards を進めた例を示します。この例はすべて生成 AI で作成し人の手は入っていません。生成 AI により、人間の時間を細部の確認やよりインパクトの大きい問いの作成などに割り当てられることを示すための例です。

docs/images/top/kiro.svg

Lines changed: 11 additions & 0 deletions
Loading
50.3 KB
Loading

docs/organizer/generative_ai_setup.md

Lines changed: 27 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# ML Enablement Workshop 生成 AI 環境事前準備
22

3-
ML Enablement Workshop で開発者 / データサイエンティスト担当の方は、**チーム全員が生成 AI を扱えるように**下記の環境セットアップをワークショップ開始前に完了してください。環境セットアップは、[Amazon Q Developer CLI](https://docs.aws.amazon.com/ja_jp/amazonq/latest/qdeveloper-ug/command-line.html) を想定しています。
3+
ML Enablement Workshop で開発者 / データサイエンティスト担当の方は、**チーム全員が生成 AI を扱えるように**下記の環境セットアップをワークショップ開始前に完了してください。環境セットアップは、[Kiro CLI](https://kiro.dev/docs/cli/installation/) を想定しています。
44

55
なお、Mock の生成以外は [GenU : Generative AI Use Cases](https://aws-samples.github.io/generative-ai-use-cases/en/) で行うこともできます。GenU を使用する場合は、[ワークショップ用のユースケース](/docs/organizer/assets/day0/ML_Enablement_Workshop_GenU.json) をダウンロードし、[ユースケースビルダーにインポート](https://aws-samples.github.io/sample-one-click-generative-ai-solutions/solutions/generative-ai-use-cases-ready-to-use/) してください。
66

@@ -10,31 +10,29 @@ ML Enablement Workshop で開発者 / データサイエンティスト担当の
1010
- Administrator 権限を保有する IAM ユーザーを人数分発行し、認証情報(アクセスキー、シークレットキー)を準備する
1111
- ※最小権限の法則上好ましくないため、あくまで一時的な対応としてください。すでに参加者に IAM ユーザーをはじめとした AWS にアクセス可能なプロファイル等が払い出されている場合この手順は不要ですが、モックの作成が可能なことを事前に確認ください
1212

13-
### Amazon Q Developer Pro のライセンス準備
14-
- Amazon Q Developer Pro のライセンスを人数分準備する
13+
### サブスクリプションの用意
14+
- Kiro、もしくは Amazon Q Developer のサブスクリプションを人数分用意します
15+
16+
※ Free/Individual のサブスクリプションで進めて頂くことができます。ただ、この場合データの取り扱いについて十分確認・検討の上でご判断ください。
17+
18+
* [Kiro 導入ガイド:始める前に知っておくべきすべてのこと](https://aws.amazon.com/jp/blogs/news/kiroweeeeeeek-in-japan-day-1-implementation-guide/)
1519

1620
## 端末でのセットアップ
1721

18-
### 1. Amazon Q Developer CLI のインストール
22+
### 1. Kiro CLI のインストール
1923

20-
Amazon Q Developer CLIは、コマンドラインでAI支援によるコード生成、チャット、コマンド自動補完を提供するツールです。
24+
Kiro CLIは、コマンドラインでAI支援によるコード生成、チャット、コマンド自動補完を提供するツールです。
2125

22-
- Windows 以外: [公式ドキュメント](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-installing.html)
23-
- Windows の場合: [Qiita記事](https://qiita.com/nagisa_53/items/ab5ef9a8d799ea964e1e)
26+
- Windows 以外: [AWS Blog](https://aws.amazon.com/jp/blogs/news/introducing-kiro-cli/)
27+
- Windows の場合: WSL を設定し、Ubuntu としてセットアップします。Amazon Q Developer の設定をご参照ください : [Qiita記事](https://qiita.com/nagisa_53/items/ab5ef9a8d799ea964e1e)
2428

2529
### 2. AWS CLI のインストールと設定
2630

2731
[AWS CLI インストール方法](https://docs.aws.amazon.com/ja_jp/cli/latest/userguide/getting-started-install.html)
2832

2933
```bash
30-
# AWS CLI の設定(IAMユーザーの認証情報を入力)
31-
aws configure
32-
33-
# 以下の項目を順番に入力:
34-
# AWS Access Key ID [None]: [IAMユーザーのアクセスキーID]
35-
# AWS Secret Access Key [None]: [IAMユーザーのシークレットアクセスキー]
36-
# Default region name [None]: ap-northeast-1
37-
# Default output format [None]: json
34+
# AWS CLI の設定(ブラウザで認証)
35+
aws login
3836

3937
# 設定確認
4038
aws sts get-caller-identity
@@ -56,22 +54,27 @@ npm --version
5654

5755
https://git-scm.com/downloads
5856

59-
### 5. Amazon Q Developer CLI へのログイン
57+
### 5. Kiro CLI へのログイン
58+
59+
AWS コンソールから、Amazon Q Developer / Kiro を検索しサービスページにアクセス。Start URL とリージョンを確認。
60+
61+
**Amazon Q Developer:**
62+
![Amazon Q Developer](/docs/organizer/assets/day0/amazon-q-developer.png)
6063

61-
AWS コンソールから、Amazon Q Developer を検索しサービスページにアクセス。Start URL とリージョンを確認。
62-
![Amazon Q](/docs/organizer/assets/day0/amazon-q-developer.png)
64+
**Kiro:**
65+
![Kiro](/docs/organizer/assets/day0/kiro.png)
6366

6467
```bash
65-
# Q Developer Pro にログイン
66-
q login
68+
# Kiro にログイン
69+
kiro-cli login
6770

68-
# Select login method => Use with Pro license
71+
# Select login method => Use with IDC Account (Free の場合 Builder ID)
6972
# Enter Start URL => AWS コンソールで確認した値
7073
# Enter Region => AWS コンソールで確認した Region
71-
# 表示される URL にアクセスし、Amazon Q Developer の利用を許可
74+
# 表示される URL にアクセスし、認証・Kiro のアクセスを許可
7275

7376
# 認証後、確認
74-
q chat
77+
kiro-cli
7578
```
7679

7780
### (Optional) 画像生成用
@@ -93,7 +96,7 @@ git clone https://github.com/aws-samples/aws-ml-enablement-workshop.git
9396
cd aws-ml-enablement-workshop/yourwork
9497

9598
# 3. Q Developer CLI のカスタムエージェントを起動
96-
q chat --agent mock-builder
99+
kiro-cli --agent mock-builder
97100

98101
# 4. 「アプリを作りたい」など適当な指示を入力
99102
# 5. アプリケーションの詳細を入力

yourwork/README.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -37,11 +37,10 @@ cd aws-ml-enablement-workshop/yourwork
3737
pwd
3838
```
3939

40-
移っていることを確認ののち、Amazon Q Developer 等のツールを起動します。
40+
移っていることを確認ののち、Kiro CLI 等のツールを起動します。
4141

4242
```
43-
q
44-
# q chat でも構いません
43+
kiro-cli
4544
```
4645

4746
以下、プロンプトについては "**🤖[Prompt]**" と明示しているので、そちらをコピー、編集して生成 AI のツールに入力してワークを進めてください。
@@ -50,7 +49,7 @@ q
5049

5150
### 実践編 : ユーザー行動の推定・確認
5251

53-
ワークでは次のプロンプトを使用してください。Amazon Q Developer CLI などの生成 AI ツールに次のプロンプトを与えます。
52+
ワークでは次のプロンプトを使用してください。Kiro CLI などの生成 AI ツールに次のプロンプトを与えます。
5453

5554
> [!IMPORTANT]
5655
> 事前に、今回検討する顧客についてまとめたスライドが `customer.png` として `discovery` ディレクトリに保存されているか確認ください。
@@ -190,11 +189,11 @@ Invent を始める前に、事前準備したソリューションを評価し
190189

191190
```
192191
yourwork
193-
├── .amazonq/ # カスタムエージェント等、Q Developer CLI 用設定ファイルディレクトリ
194-
├── prompt/ # プロンプトファイルディレクトリ
195-
│ └── prompt.md # アプリケーション仕様記述ファイル
196-
├── template/ # アプリケーションテンプレート
197-
└── product/ # 生成されるアプリケーション(Q Developer CLI により作成されます)
192+
├── .kiro/ # カスタムエージェント等、Kiro CLI 用設定ファイルディレクトリ
193+
├── prompt/ # プロンプトファイルディレクトリ
194+
│ └── prompt.md # アプリケーション仕様記述ファイル
195+
├── template/ # アプリケーションテンプレート
196+
└── product/ # 生成されるアプリケーション(Kiro CLI により作成されます)
198197
```
199198

200199
### モックの構築
@@ -206,7 +205,7 @@ yourwork
206205

207206
#### 1. ディレクトリの移動
208207

209-
`yourwork` で作業しているか確認します。いなければ、以下のコマンドを実行し、`yourwork` ディレクトリに移動します。
208+
**`yourwork` で作業しているか確認します。いなければ、以下のコマンドを実行し、`yourwork` ディレクトリに移動します。**
210209

211210
```
212211
pwd
@@ -250,12 +249,12 @@ Dashboard URL: https://dxxxxxxxxxx.cloudfront.net
250249

251250
これらの情報は `4. カスタムエージェントの実行` で利用します。
252251

253-
#### 3. Amazon Q Developer CLI の起動
252+
#### 3. Kiro CLI の起動
254253

255-
以下のコマンドで Amazon Q Developer CLI のモデル構築用エージェントを起動します。
254+
以下のコマンドで Kiro CLI のモデル構築用エージェントを起動します。
256255

257256
```
258-
q chat --agent mock-builder
257+
kiro-cli --agent mock-builder
259258
```
260259

261260
#### 4. カスタムエージェントの実行
@@ -271,7 +270,7 @@ q chat --agent mock-builder
271270

272271
#### 4. ホスティングしたアプリケーションの削除
273272

274-
AWS にデプロイしたアプリケーションを削除したい場合は、Q Developer CLI に、`/product/ ディレクトリを参照し、デプロイしたアプリケーションを削除したい` と伝えてください。
273+
AWS にデプロイしたアプリケーションを削除したい場合は、Kiro CLI に、`/product/ ディレクトリを参照し、デプロイしたアプリケーションを削除したい` と伝えてください。
275274
各種リソースの削除が行われます。
276275

277276
## Test/Iterate

yourwork/prompt/prompt.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@
3636
- `/template/DEPLOYMENT_GUIDE.md` の技術選定ガイドラインに従う
3737
- `/product/` ディレクトリを作成し、`/template/app/` の構成を参考にする
3838
- `template/TRACKER_INTEGRATION_GUIDE.md` に従ってトラッカーを完全に統合する
39+
- **Tailwind CSS v4の設定**: `/template/app/src/styles/globals.css` を参考に、必ず `@theme` ディレクティブでカスタムカラーを定義し、`@layer base` 内にベーススタイルを記述すること
3940
</technical_requirements>
4041

4142
<tracker_integration_rules>

0 commit comments

Comments
 (0)