【エンジニア向け】雑メモから自然な日本語報告文に変換する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原則
-
明確なステータス表示
- 完了/実施中/未着手が一目でわかる
-
自然な日本語
- 過度な装飾を避ける
- 人が書いた感じの文章
-
適切な粒度
- 必要な情報を過不足なく
- 読み手の立場を考慮
プロンプト作成のポイント
- 条件は具体的に指定
- 出力例を示すと精度向上
- 段階的に調整していく
このテンプレートを使えば、雑なメモも5秒で報告文に変換できます。
ぜひ自分のスタイルに合わせてカスタマイズしてみてくださいー