dotfiles

Category: 数据与AI | Uploader: ikuwow | Downloads: 0 | Version: v1.0（Latest）

Use when the user wants to reflect on AI communication quality and get improvement suggestions for rule files or the project itself. TRIGGER when user invokes /retrospective or asks to review the session.

Changelog: Source: GitHub https://github.com/ikuwow/dotfiles

Directory Structure

Current level: claude/skills/retrospective/

📄 SKILL.md 3.1 KB

SKILL.md

---
description: Use when the user wants to reflect on AI communication quality and get improvement suggestions for rule files or the project itself. TRIGGER when user invokes /retrospective or asks to review the session.
---

# AIとのコミュニケーション振り返り

今回のセッションを振り返り、AIとのコミュニケーション改善のための提案を行ってください。

タスクの内容や進捗ではなく、AIとユーザーの「やり取りの質」に焦点を当てて分析してください。

## 分析してほしい観点

1. コミュニケーションの課題
   - AIが誤解した指示や、再度説明が必要だった部分はあったか
   - 期待と異なる動作をした箇所はあったか
   - 無駄な作業や非効率だったやり取りはあったか

2. 改善できる点
   - より効率的に進められた可能性がある部分
   - 指示の出し方で改善できる点
   - AIの応答で改善すべき点

3. ルールファイルへの追記提案
   - 今回の課題を踏まえて、追加すべきルールがあれば具体的に提案
   - グローバルルール（AIRULES.md）とプロジェクトルール（プロジェクトの CLAUDE.md 等）のどちらに追加すべきかを明示する
     - グローバルルール：すべてのプロジェクトに適用する汎用的な AI 指示
     - プロジェクトルール：このプロジェクト固有の制約・慣習
   - 提案は具体的なルール文として記載
   - なぜそのルールが必要かの理由も説明

4. プロジェクト改善の提案
   - 今回の作業を通じて気づいた、プロジェクト自体の改善点を提案する
   - ドキュメント：以下のようなドキュメントが不足・不明確だった場合に提案する
     - README への追記（セットアップ手順、動作確認方法、アーキテクチャ概要）
     - 開発者向けドキュメント（デバッグ手順、ローカル環境構築、よくあるエラーと対処法）
     - 設計ドキュメント（モジュール構成、データフロー、主要コンポーネントの役割）
   - コードの可読性：コードを読んだ際に意図が不明確だった箇所
     - コメントの追加（特に「なぜそうなっているか」の背景）
     - 関連 PR・issue・ADR へのリンクコメント
     - 型定義・インターフェース仕様の補完
   - 構造・設計：今回の作業で感じた構造上の改善余地
     - ディレクトリ構成・ファイル配置の見直し
     - 命名規則の統一や分割・統合の提案
   - 提案には「どのファイル・ディレクトリに何を追加・変更するか」を具体的に示す

## 重要な注意点

- タスクの内容そのものではなく、AIとのやり取りのプロセスと、そこから見えたプロジェクトの改善点に注目すること
- 具体的で実行可能な改善提案を心がけること
- すべての提案はあくまで提案であり、実際の変更はユーザーの確認を得てから行うこと

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

dotfiles

Directory Structure

SKILL.md

Report

Notice