comprono/dont-x-smart-be-smart-skill

dont-x-smart-be-smart-skill は何をしますか？

Codexのスキルで、プロジェクトの意図を保持し、コンテキスト圧縮に耐え、繰り返しの失敗を防ぎ、実際の成果を検証します。

概要

このスキルは、Codexエージェントの長期的な信頼性と一貫性を向上させるために設計されたツールです。以下の主要な問題に対処します：

• 意図の喪失：エージェントが長時間作業すると、プロジェクトの本来の目的を忘れがちです。
• コンテキスト圧縮：限られたコンテキストウィンドウにより、重要な情報が失われます。
• 繰り返しの失敗：同じ問題に対して同じ間違ったアプローチを繰り返します。
• 偽りの成功：エージェントは完了したと主張するが、実際には正しく動作しません。

機能

1. 意図の永続化：プロジェクトの核心的な目標と制約を、.intent ファイルに構造化された形式で保存します。このファイルはコンテキスト圧縮後も読み込まれ、エージェントが軌道を維持するのに役立ちます。

2. 失敗パターンの学習：以前の試行の失敗を分析し、同じ間違いを避けるためのヒューリスティックなルールを生成します。これらのルールは、.failures ファイルに保存されます。

3. 成果の検証：エージェントは、テストの実行や成果物の存在と正確性の確認など、実際の検証手順を実行するよう求められます。虚偽の完了を防ぎます。

4. 状態管理：セッション間で進捗状況、現在のタスク、決定履歴を追跡します。これにより、中断しても再開が容易になります。

使用方法

このスキルをアクティブにしてCodexセッションを開始します。スキルは自動的に：

• セッション開始時に既存の状態ファイル（.intent、.failures、.progress）を確認します。
• 以前のコンテキストからプロジェクトの意図と学習したルールを復元します。
• 新しいアクションのたびに状態ファイルを更新します。
• 定期的に進捗を検証し、失敗を分析します。

手動で操作する場合：

• intent：現在のプロジェクトの意図を表示します。
• failures：学習した失敗パターンを表示します。
• progress：現在の進捗状況を表示します。
• verify：現在の成果の検証を実行します。

ファイル構造

• .intent：プロジェクトの目標、制約、成功基準を含むYAMLファイル。
• .failures：失敗パターンとそれに対応する回避ルールを含むYAMLファイル。
• .progress：現在のタスク、完了したステップ、保留中のアクションを含むYAMLファイル。

例

# .intent
project: "ウェブスクレイパーの構築"
goal: "特定のサイトから製品データを抽出する堅牢なスクレイパーを作成する"
constraints:
  - "rate limitを尊重すること"
  - "出力をJSONファイルに保存すること"
success_criteria:
  - "少なくとも100件の製品をエラーなく抽出できること"
  - "すべてのフィールドが正しくマッピングされていること"

注意事項

• このスキルはコードを変更したり、自動的に新しいファイルを作成したりしません。マークダウンで記述されたガイドラインとプロンプトのみを提供します。
• 効果を発揮するには、Codexエージェントがファイルを読み書きする権限を持っている必要があります。
• プロジェクトのルートディレクトリに状態ファイルを保存するため、バージョン管理から除外してください。

貢献

改善の提案やバグ報告は、GitHubリポジトリまでお寄せください。