0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【エンジニア向け】雑メモから自然な日本語報告文に変換するAIプロンプト完全ガイド

Posted at

【エンジニア向け】雑メモから自然な日本語報告文に変換するAIプロンプト完全ガイド

はじめに

「今日やったこと、雑にメモしてたら報告文書くの面倒...」そんな経験ありませんか?

この記事では、箇条書きメモや断片的な作業記録を、自然で読みやすいSlack報告文に変換するAIプロンプトテクニックを解説します。

この記事で得られること

  • 雑メモを構造化された報告文に変換する具体的プロンプト
  • 完了/未完了/実施中が一目でわかる表現方法
  • 過度な装飾を避けた自然な日本語表現
  • コピペですぐ使えるテンプレート集

基本プロンプトテンプレート

パターン1: 日次報告(最もシンプル)

以下のメモを、Slackでの日次報告として整形してください。

【条件】
- 完了/未完了/実施中のステータスを明確にする
- ●や■などのマーカーは使用OK、絵文字は使わない
- です・ます調の自然な日本語
- 過度な装飾や強調を避ける
- 簡潔で読みやすい文章構造

【メモ】
ログイン機能のバグ修正した
API統合テスト途中
ドキュメント更新まだ
明日はデプロイ予定

出力例:

本日の作業報告です。

■ 完了
● ログイン機能のバグ修正を完了しました

■ 実施中
● API統合テストを進めています(進捗60%程度)

■ 未着手
● ドキュメントの更新

■ 明日の予定
● 修正内容のデプロイを予定しています

以上、よろしくお願いします。

パターン2: 詳細報告(背景・課題含む)

以下のメモを、背景や課題を含む報告文として整形してください。

【条件】
- 作業の背景や目的を簡潔に説明
- 遭遇した課題や解決方法も記載
- ステータスを明確に
- 自然な日本語、装飾は最小限

【メモ】
パフォーマンス問題調査
原因はN+1クエリっぽい
eager loading追加で解決
テストは明日
前のチケット#123関連

出力例:

チケット#123関連のパフォーマンス問題について報告します。

■ 背景
前回報告した応答速度の問題について調査を進めました。

■ 完了した作業
● 原因の特定
  - N+1クエリが発生していることを確認しました
● 修正の実施
  - eager loadingを追加することで解決しました

■ 実施予定
● 修正内容のテストを明日実施予定です

以上です。

パターン3: 週次報告(進捗サマリー)

以下の1週間のメモを週次報告として整形してください。

【条件】
- 1週間の作業を要約
- 達成事項と進行中の作業を分ける
- 来週の予定も記載
- シンプルで簡潔に

【メモ】
月: ログイン機能バグ修正
火: API統合テスト開始
水: テスト続き、ドキュメント着手
木: レビュー対応
金: デプロイ準備、まだ終わってない
来週: デプロイとモニタリング

出力例:

今週の作業報告です。

■ 完了した作業
● ログイン機能のバグ修正
● API統合テストの実施
● ドキュメントの初稿作成
● レビュー指摘事項への対応

■ 継続中の作業
● デプロイ準備(90%程度完了)

■ 来週の予定
● 本番環境へのデプロイ
● デプロイ後のモニタリング

以上、よろしくお願いします。

パターン4: 技術的な詳細報告

以下の技術的なメモを、チームメンバーに共有する報告文として整形してください。

【条件】
- 技術的な内容も正確に伝える
- 専門用語はそのまま使用
- 実装の詳細は箇条書きでOK
- 自然な日本語の文章として構造化

【メモ】
Splunkダッシュボード実装
インデックス: security、容量設計した
SPL書いた、timechartで可視化
アラート設定、メール通知
パフォーマンステストまだ
ドキュメントは半分

出力例:

Splunkダッシュボードの実装状況を報告します。

■ 完了した作業
● インデックス設計
  - securityインデックスの容量設計を完了
  - 90日間のデータ保持で設定

● ダッシュボード実装
  - SPLクエリを作成し、timechartで時系列可視化を実装
  - 主要メトリクスを表示するパネルを配置

● アラート設定
  - 閾値超過時のメール通知を設定

■ 実施中
● パフォーマンステスト
  - 負荷テストを実施予定

● ドキュメント作成
  - 運用手順書を作成中(進捗50%)

以上です。

パターン5: 問題報告(トラブル・ブロッカー)

以下の問題状況を報告文として整形してください。

【条件】
- 問題の内容を明確に
- 影響範囲を記載
- 現在の対応状況を説明
- 支援が必要な場合は明記
- 落ち着いたトーンで

【メモ】
本番でエラー出てる
ログイン失敗500エラー
ユーザー影響あり
原因調査中
DBコネクション枯渇っぽい
設定変更で一旦対処
根本対応は別途必要

出力例:

本番環境で問題が発生しています。

■ 問題内容
ログイン処理で500エラーが発生しています。

■ 影響範囲
一部のユーザーがログインできない状態です。

■ 現在の状況
● 原因調査を実施中
  - DBコネクションプールの枯渇が原因と推測
● 暫定対応を実施
  - コネクション数の設定を変更し、一旦エラーは収束

■ 今後の対応
根本的な解決策として、コネクション管理の見直しが必要です。
別途対応を検討します。

以上、ご確認お願いします。

パターン6: 複数タスクの進捗報告

以下の複数タスクの進捗を整理して報告してください。

【条件】
- タスクごとに進捗を明確に
- 優先度や依存関係があれば記載
- 全体の進捗感がわかるように
- シンプルな構造

【メモ】
タスクA: ログイン機能 80%完了
タスクB: API開発 完了
タスクC: UI改善 未着手、タスクA待ち
タスクD: テスト 50%
タスクE: ドキュメント 30%

出力例:

各タスクの進捗状況です。

■ 完了
● タスクB: API開発

■ 実施中
● タスクA: ログイン機能(進捗80%)
● タスクD: テスト(進捗50%)
● タスクE: ドキュメント作成(進捗30%)

■ 未着手
● タスクC: UI改善
  - タスクAの完了待ちです

■ 全体の進捗
5タスク中1タスク完了、3タスク実施中です。

以上です。

実践的な応用プロンプト

応用1: メモの粒度がバラバラな場合

以下のメモを整理して報告文にしてください。
メモの詳細度がバラバラですが、適切に補完して自然な文章にしてください。

【条件】
- 不足している情報は推測で補わない
- 確実な情報のみ記載
- 曖昧な部分は「確認中」等で表現

【メモ】
ログイン修正済み
API
DBスロー
テストやった

出力例:

本日の作業報告です。

■ 完了
● ログイン機能の修正

■ 実施した作業
● APIの作業(詳細は別途報告予定)
● テストの実施

■ 確認中
● DBのパフォーマンスについて調査中

以上です。

応用2: 英語メモから日本語報告

以下の英語メモを日本語の報告文にしてください。

【条件】
- 自然な日本語に翻訳
- 技術用語は適宜英語のまま
- 報告文として構造化

【メモ】
Fixed login bug
API integration in progress
Docs TODO
Deploy tomorrow

出力例:

本日の作業報告です。

■ 完了
● ログインのバグ修正

■ 実施中
● API統合作業

■ 未着手
● ドキュメント更新

■ 明日の予定
● デプロイを予定しています

以上です。

応用3: コードスニペット含むメモ

以下の技術的なメモを報告文にしてください。

【条件】
- コードは適切にフォーマット
- 実装の意図を説明
- 自然な文章構造

【メモ】
パフォーマンス改善
before: SELECT * FROM users WHERE...
after: SELECT id, name FROM users WHERE... LIMIT 100
クエリ最適化した
レスポンス3秒→0.5秒

出力例:

パフォーマンス改善の報告です。

■ 実施内容
クエリの最適化を行いました。

修正前:
```sql
SELECT * FROM users WHERE...

修正後:

SELECT id, name FROM users WHERE... LIMIT 100

必要なカラムのみ取得し、件数制限を追加しました。

■ 効果
レスポンスタイムが3秒から0.5秒に改善しました。

以上です。


---

## チートシート: よく使う表現パターン

### ステータス表現

| 状態 | 表現例 |
|-----|-------|
| 完了 | ● 〜を完了しました<br>● 〜が完了しています<br>● 〜を実施しました |
| 実施中 | ● 〜を進めています<br>● 〜を実施中です<br>● 〜に取り組んでいます(進捗XX%) |
| 未着手 | ● 〜が未着手です<br>● 〜はこれからです<br>● 〜は〇〇の完了待ちです |
| 予定 | ● 〜を予定しています<br>● 〜を実施予定です<br>● 明日〜を行います |

### 進捗度の表現

● 〜(進捗80%程度)
● 〜(ほぼ完了)
● 〜(初期段階)
● 〜(調査中)
● 〜(検討中)


### 問題・課題の表現

● 〜の問題が発生しています
● 〜について課題があります
● 〜で遅延が生じています
● 〜の解決策を検討中です


### 依存関係の表現

● 〜の完了待ちです
● 〜に依存しているため、着手できていません
● 〜の結果を踏まえて進めます


---

## プロンプトカスタマイズのコツ

### 1. トーン調整

**フォーマル寄り:**

【条件に追加】

  • 丁寧な表現を使用
  • 「致します」「申し上げます」など

**カジュアル寄り:**

【条件に追加】

  • 自然な口語に近い表現
  • 「〜しました」「〜です」程度の丁寧さ

### 2. 分量調整

**簡潔版:**

【条件に追加】

  • 各項目1-2行程度
  • 要点のみ記載

**詳細版:**

【条件に追加】

  • 背景や理由も含めて説明
  • 具体的な数値や事例を記載

### 3. 対象者別調整

**マネージャー向け:**

【条件に追加】

  • ビジネスインパクトを明記
  • リスクや懸念事項を強調
  • 判断が必要な事項を明確に

**チームメンバー向け:**

【条件に追加】

  • 技術的な詳細を含める
  • 実装の意図や背景を説明
  • 協力が必要な点を明記

---

## 実戦テクニック

### テクニック1: テンプレート保存

よく使うプロンプトは、Notion、Obsidian、テキストファイル等に保存しておく。

```markdown
# 日次報告用プロンプト

以下のメモを日次報告として整形してください。

【条件】
- 完了/未完了/実施中を明確に
- ●のマーカー使用OK、絵文字不要
- です・ます調
- 簡潔に

【メモ】
[ここにメモを貼り付け]

テクニック2: 段階的改善

一度生成した文章が気に入らない場合:

上記の報告文を、以下の点を改善して再生成してください:
- もっと簡潔に
- 技術的な詳細を追加
- 問題点をより明確に

テクニック3: バッチ処理

1週間分のメモをまとめて処理:

以下の日別メモを週次報告として統合してください。

【月曜】
〜

【火曜】
〜

【水曜】
〜

よくある失敗と対処法

失敗1: 装飾過多な出力

問題:

🎉 本日の作業報告です!🚀

✅ 完了した作業
💪 頑張って実装しました!

対処:

【条件に明記】
- 絵文字は一切使用しない
- ●や■のマーカーのみ使用
- 過度な強調表現を避ける

失敗2: 情報の捏造

問題:
AIが勝手に詳細を追加してしまう

対処:

【条件に追加】
- メモに記載されていない情報は推測しない
- 不明な点は「詳細確認中」等で表現
- 事実のみを記載

失敗3: 冗長な表現

問題:

本日実施した作業につきましてご報告申し上げます。
誠に恐縮ではございますが...

対処:

【条件に追加】
- 過度に丁寧な表現は不要
- 「です・ます」程度の丁寧さ
- 簡潔で直接的な表現

まとめ

良い報告文の3原則

  1. 明確なステータス表示

    • 完了/実施中/未着手が一目でわかる
  2. 自然な日本語

    • 過度な装飾を避ける
    • 人が書いた感じの文章
  3. 適切な粒度

    • 必要な情報を過不足なく
    • 読み手の立場を考慮

プロンプト作成のポイント

  • 条件は具体的に指定
  • 出力例を示すと精度向上
  • 段階的に調整していく

このテンプレートを使えば、雑なメモも5秒で報告文に変換できます。
ぜひ自分のスタイルに合わせてカスタマイズしてみてくださいー

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?