Feature/0001

[Koonosuke]

概要

PR作成時に走る、GeminiのPR説明をここに転記してください。

その他

[github-actions]

🔗 関連するNotionタスク

• HCLOUD-PR-1

状態: 進行中

[gemini-code-assist]

Summary of Changes

Hello @Koonosuke, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

このプルリクエストは、主にプロジェクトのファイル構造を整理し、ドキュメントの視認性と互換性を向上させることを目的としています。具体的には、AWS関連ファイルのディレクトリを再編成し、Mermaid図の表示をGitHub環境に最適化しました。また、IoT CoreとのインタラクションをテストするためのPostmanリクエストのサンプルを追加し、開発者が容易に機能を検証できるようにしました。

Highlights

• プロジェクト構造の整理: AWS_Handson_2025ディレクトリ配下のファイルをAWSディレクトリに移動し、プロジェクトのファイルパスを整理しました。
• Mermaid図のGitHub互換性向上: DOCS/devicesshadow.md内のMermaid図の注釈構文を、GitHubでより適切に表示される形式に更新しました。
• Postmanリクエスト例の追加: Postman/PostmanRequest.mdファイルが新規追加され、IoT Coreとの連携に使用できるPostmanリクエストのJSONペイロード例が提供されました。

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

このプルリクエストは、主にファイルパスのリファクタリングとドキュメントの改善を行うものと見受けられます。Mermaid図の変更はGitHubでの表示互換性を高める良い修正です。また、PostmanRequest.mdの追加も開発者にとって有用ですが、フォーマットを少し改善することで、さらに使いやすくなるかと思います。ドキュメントの可読性と再利用性を向上させるための提案をいくつかさせていただきました。

[gemini-code-assist]

Mermaidのノートの可読性向上のための提案です。
現在、shadow_note のテキストが一行に長く連なっており、少し読みにくくなっています。
Mermaidのラベル内では <br> タグを使って改行を挿入できます。これを利用して、以前の note 構文のように複数行で表示させると、より可読性が高まるかと思います。

Suggested change

	shadow -.-> shadow_note["差分を管理 desired: Power: ON reported: Power: OFF delta: Power: ON"]
	shadow -.-> shadow_note["差分を管理<br>desired: Power: ON<br>reported: Power: OFF<br>delta: Power: ON"]

[gemini-code-assist]

Postmanのリクエスト例の記述方法について提案です。
現在、すべてのリクエスト例が単一のコードブロック内で // を使ってコメントアウトされています。これでは、利用者がコピー＆ペーストして使う際に、手動でコメントを外す手間がかかってしまいます。

各リクエスト例を個別の json コードブロックとして記述し、Markdownの見出しで説明を加える形式にすると、可読性と再利用性が大幅に向上します。

例えば、以下のような形式が考えられます。

### Echoリクエスト
```json
{
  "deviceId": "xiao-22fi041",
  "type": "echo",
  "payload": {
    "message": "Hello from B3!"
  }
}
```

### LED点灯リクエスト
```json
{
  "deviceId": "xiao-22fi041",
  "type": "led",
  "payload": {
    "pattern": "on"
  }
}
```

### Echoリクエスト

```json
{
  "deviceId": "xiao-22fi041",
  "type": "echo",
  "payload": {
    "message": "Hello from B3!"
  }
}

LED点灯リクエスト

{
  "deviceId": "xiao-22fi041",
  "type": "led",
  "payload": {
    "pattern": "on"
  }
}

LED点滅リクエスト

{
  "deviceId": "xiao-22fi041",
  "type": "led",
  "payload": {
    "pattern": "blink"
  }
}

サーボモーター制御リクエスト

{
  "deviceId": "xiao-22fi041",
  "type": "servo",
  "payload": {
    "direction": "left",
    "degree": 90
  }
}