work-logs-prompt-report
プロンプトフィードバックレポートを出力する。プロンプトレポートや作業フィードバックとも呼ぶ
When & Why to Use This Skill
The Work Logs Prompt Report skill is a specialized tool designed to evaluate and improve the quality of technical instructions. It generates detailed markdown feedback reports that analyze the clarity of prompts, identify ambiguities, and suggest optimized communication strategies. By documenting the gap between initial instructions and final outcomes, it serves as a powerful resource for prompt engineering and mentoring junior developers within a professional workflow.
Use Cases
- Case 1: Instruction Quality Audit - Generate a comprehensive report after a development cycle to pinpoint vague instructions and receive concrete suggestions for more efficient phrasing in future tasks.
- Case 2: Junior Developer Mentorship - Use the structured feedback logs to help junior engineers understand project requirements more deeply and improve their ability to interpret complex technical briefs.
- Case 3: Prompt Engineering Refinement - Analyze the effectiveness of AI-driven workflows by reviewing the 'intent vs. result' analysis, allowing for the creation of more robust and reliable prompt templates.
| name | work-logs-prompt-report |
|---|---|
| description | プロンプトフィードバックレポートを出力する。プロンプトレポートや作業フィードバックとも呼ぶ |
| allowed-tools | Read, Write, Grep, Glob |
作業フィードバックについて
ユーザーの求めに応じて作業指示のフィードバックを $HOME/.claude/prompt-report/ にmarkdownで書き出すこと。
書き出し先は ~/.claude/prompt-report/${repo_name}/${date time prefix}_$description.md とします。
date time prefix は以下のようにしてください。
- date コマンドを利用してログ出力処理時の現在時刻を取得する
- フォーマットは
+%Y-%m-%d_%H-%Mとする
- フォーマットは
- タイムゾーンはAsia/Tokyoとする
フィードバックの内容・目的
- ジュニアエンジニア（CS系卒・半年程度のキャリア）への指示改善が目的
- コードベースへの理解はある程度あるものと想定
- 開発サイクル（ブランチ作成〜完了）単位でフィードバックを実施
- ユーザーが明示的にフィードバックを求めた時に作成
含めるべき内容
- 指示で曖昧だった点の具体的な指摘
- 最終成果物から逆算した、より効率的な指示例
- 意図が正しく伝わったか/伝わらなかった部分の分析
- レポート体裁で、自由フォーマット