開発ノート記録スキル

Log Dev Note

概要

このスキルは、ユーザーのメッセージにリテラルな呼び出し $log-dev-note が明示的に含まれている場合にのみ使用します。

このスキルは、現在のCodexセッションコンテキストを簡潔なエンジニアリングログに変換し、手動でコピーしやすい清潔で貼り付け可能な形式で返します。

トリガー契約

• リテラルコマンド $log-dev-note でのみトリガーします。
• セマンティックマッチング、言い換え、または一般的なメモ作成要求ではトリガーしません。
• $log-dev-note の後の同じ行にある空でないテキストは、オプションのタイトルオーバーライドとして扱います。
• コマンドがない場合は、このスキルを完全に無視します。

例：

• $log-dev-note
• $log-dev-note Built OneNote Logging Skill v1

入力

すべての呼び出しで以下の入力を使用します：

• このセッションの現在の完全なCodex会話コンテキスト
• アクティブな環境からの現在のシステムタイムスタンプ
• $log-dev-note の後に存在する場合、ユーザーが指定したオプションのタイトルオーバーライド

主要なトピックを特定する際は最近のセッションコンテキストを優先しますが、重要な以前の決定や制約を捉えるために完全な会話を使用します。

出力

デフォルトの出力先は会話の応答のみです。

実行ルール：

1. 呼び出しごとに新しいノートを生成します。
2. 最終的なタイトルとノート本文を、清潔で貼り付け可能な形式で返します。
3. ブラウザの自動化、APIへの書き込み、クリップボード統合を試みてはいけません。
4. 外部の副作用をでっち上げてはいけません。スキルはノートテキストを生成するだけです。

タイトルルール

ノートのタイトルは以下の形式を正確に使用する必要があります：

[YYYY-MM-DD] – <タイトル>

タイトル構築ルール：

• YYYY-MM-DD には現在のシステム日付を使用します。
• ユーザーがタイトルオーバーライドを指定した場合は、ダッシュの後にそのまま使用します。
• それ以外の場合は、セッションの主要なトピックやマイルストーンに基づいて、具体的で説明的なタイトルを生成します。
• プロジェクトで作業した のような曖昧なタイトルよりも、Built OneNote Logging Skill v1 のような具体的なマイルストーンを優先します。
• コンテキストからプロジェクト名が明らかで、特異性が向上する場合はそれを含めます。

ノート構造

ノート本文を以下のマークダウンスタイルの見出しを使用して正確にフォーマットします：

Summary

Progress Made

Key Decisions

Current State

Open Questions / Issues

Next Steps

Relevant Context

セクションルール：

• Summary：セッションの意味のある成果を要約した2〜4文。
• Progress Made：実装された機能、重要な変更、実行された決定、解決された問題に関する箇条書き。
• Key Decisions：決定と簡単な理由を記載した箇条書き。
• Current State：セッションの終了時点で真であることを説明する箇条書き。
• Open Questions / Issues：未解決の問題、リスク、ブロッカー、あいまいさに関する箇条書き。
• Next Steps：即時のフォローアップアクションと短期的な優先事項に関する箇条書き。
• Relevant Context：後で重要になる制約、前提、アーキテクチャノート、ツールの制限、環境の詳細に関する箇条書き。

コンテンツルール

• 合計で約150〜400語を目指します。
• ノートは簡潔で具体的、かつドキュメントに焦点を当てたものにします。
• Summary 以外では可能な限り箇条書きを使用します。
• インテリジェントに要約します。会話をそのまま繰り返してはいけません。
• 些細な議論ではなく、進捗、決定、ブロッカー、現在の状態を優先します。
• 小さな会話や無関係なやり取りは無視します。
• ほとんど進捗がなかった場合は、何を試みたか、なぜ停滞したかを記録します。
• 複数のトピックが議論された場合は、主要な目的に焦点を当て、二次的な項目は実質的に重要である場合にのみグループ化します。
• コンテキストがあいまいな場合は、最も最近のシグナルの強いメッセージから最も可能性の高い主要な焦点を推測します。

コンテキストによって明確にサポートされる場合のオプションの拡張：

• AI、Backend、Frontend、Codex Skill、プロジェクト名などの簡潔なキーワードタグを追加します。
• タイムスタンプが利用可能な場合はセッション期間を含めます。
• 将来の可読性を実質的に向上させる場合は、リポジトリ、サービス、または機能名に言及します。

生成ワークフロー

1. 呼び出しがリテラルな $log-dev-note コマンドであることを確認します。
2. 末尾のテキストをオプションのタイトルオーバーライドとして解析します。
3. 現在のセッションコンテキストを確認し、主要なプロジェクト目標、意味のある進捗、決定、ブロッカー、次のステップを特定します。
4. 必要な日付形式を使用してノートのタイトルを生成します。
5. 正確なセクション見出しと簡潔な箇条書き中心の構造を使用してノートを作成します。
6. 手動でコピーできるように、応答でノートを直接返します。

エッジケース

• セッションに有用な情報がほとんどない場合は、限られた進捗を明示的に示す最小限のノートを作成します。
• ノートが空になる場合は、少なくとも試みた目的、現在の状態、次のステップを含めます。

応答形式

ノートを生成した後、以下のように簡潔に応答します：

• 最終的なノートタイトル
• 生成されたノートの内容