convex-improve-convex-plugin について
improve-convex-pluginは、コーディングセッションの記録をanteaterのレビューエンドポイントに送り、システムを振り返るスキルです。構造化された所見と成果を返し、共有前に明示的な同意を求めます。
主な機能
- 01セッション記録をレビューに提出
- 02共有前に明示的な同意を取得
- 03構造化されたシステム所見を受領
- 04所見と成果を要約
活用シーン
- 01コーディングセッションの指示の曖昧さを確認
- 02エージェントやツールの障害パターンを特定
- 03運用手順書やスキルの改善案を収集
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ convex/ agent-skills --skill convex-improve-convex-pluginインストール後、Claude Code で/convex-improve-convex-pluginを入力して読み込まれたか確認します。
詳細
improve-convex-plugin
現在のコーディングセッションのトランスクリプトを anteater の POST /review エンドポイントに送信し、AI による事後分析を行います。レビューでは、ランブック、ブートストラップスクリプト、スキル、コンポーネントを対象にした構造化された調査結果(曖昧な指示、エージェントが行き詰まるパターン、ツールの障害、うまくいった点)が返されます。エンドユーザーのデータは対象外です。共有はオプトイン方式です。anteater が提供するヘルパーが一度だけ確認し(Always / Just this once / Never)、選択を記憶します。
ワークフロー
- anteater が提供するヘルパーを実行します:
curl -fsSL "<anteater>/send-transcript" | bash -s -- --idea "<one-line app idea from this session>"。 - CONSENT_REQUIRED が出力された場合(終了コード 4)、ユーザーはまだ選択していません。Always、Just this once、Never のいずれかを選んで共有するようユーザーに確認してから、--consent always|once|never を付けて再実行します。回答を得るまで送信しないでください。
- 出力マーカーを確認します:REVIEW_SOURCE(トランスクリプトが見つかった)、REVIEW_SUBMITTED id=...(受理された)、REVIEW_DONE status=done(調査結果の準備完了)。
- 重要度の高い調査結果を、タイトル → 対象 → suggestedFix の順にユーザーに要約し、その後でうまくいった点を伝えます。要約はシステムに関する内容に限定し、ユーザーのデータには触れないでください。
ルール
- ユーザーが共有を明示的に選択するまで、トランスクリプトを送信しないでください(ヘルパーは、選択されるまで CONSENT_REQUIRED を出力して終了します)。
- REVIEW_NO_TRANSCRIPT は Claude/Codex の .jsonl が見つからなかったことを意味します。ユーザーに伝えてください。
- 生のシークレットを決して貼り付けないでください。スクリプトはアップロード前にキーやトークンをマスキングします。要約はシステムに関する内容に限定してください。
- これはシステム改善のためのループであり、エンドユーザー向け機能へのフィードバックではありません。
コメント
Markdown 対応