Communityコーディング&開発github.com

rxlqn/know-your-unknowns

Codex と Claude スキル:エージェントアーティファクトを用いて未知を可視化します。

know-your-unknowns とは?

このスキル「know-your-unknowns」は、開発エージェント(Codex、Claude Code など)がタスク遂行中に「自分は何を知らないか」を認識・出力するための仕組みです。エージェントは通常、確信を持って回答する傾向がありますが、本スキルを適用することで、自信のない領域や追加調査が必要なポイントを「アーティファクト」として明示的に出力します。これにより、開発者はエージェントの推論のギャップを把握し、より適切な指示や追加コンテキストを与えることが可能になります。対応プラットフォームは Codex(OpenAI)と Claude(Anthropic)で、いずれもエージェントアーティファクト(成果物)の仕組みを利用して未知の項目を構造化して出力するよう設計されています。使用方法は、スキル定義ファイルをプロジェクトに追加するだけで、エージェントの振る舞いが変更されます。具体的には、タスク完了時に「既知の事柄」「未知の事柄」「不確かな仮定」などをセクションに分けて出力するプロンプトが注入され、出力結果は常にマークダウン形式のアーティファクトとして残ります。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add rxlqn/know-your-unknowns

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

know-your-unknowns は何をしますか?

Codex と Claude スキル:エージェントアーティファクトを用いて未知を可視化します。

概要

このスキルは、AIエージェント(Codex および Claude)がタスクの実行中に「未知の領域」を特定し、それをアーティファクトとして明示的に出力するためのプロンプトテンプレートを提供します。エージェントが自信を持って回答する一方で、見過ごしがちな情報不足や仮定を可視化することで、開発者の判断を支援します。

特徴

  • 未知の可視化: エージェントが「わからないこと」「不確かなこと」を積極的に出力します。
  • アーティファクト対応: 出力はマークダウン形式のアーティファクトとして保存され、後から参照可能です。
  • マルチプラットフォーム: Codex(OpenAI)と Claude(Anthropic)の両方で動作します。

使用方法

  1. プロジェクトのルートに .cursorrules または CLAUDE.md を作成します(使用するエージェントに応じて)。
  2. 以下の内容を追記します。
## know-your-unknowns

タスクを完了する際には、以下のセクションを出力に含めてください。

### 既知の事柄
- 確信を持って回答できる事実や情報を列挙します。

### 未知の事柄
- 現時点で不明だが、タスク完了に必要となる可能性がある情報を列挙します。

### 不確かな仮定
- 確証がないが、現状のタスクを進めるために行った仮定を明記します。

### 追加調査が必要な領域
- さらに深掘りが必要なトピックや、外部ソースの確認が必要な項目を挙げます。

動作例

エージェントがコードレビューを実施した場合、以下のような出力が期待されます。

レビュー結果

既知の事柄

  • 関数 calculateTotal は税込み価格を計算するロジックが正しい。

未知の事柄

  • この関数が想定する税率のソースが不明(環境変数 TAX_RATE が定義されていない)。

不確かな仮定

  • 税率は常に10%固定であると仮定してレビューを実施。

追加調査が必要な領域

  • TAX_RATE のデフォルト値や動的取得方法を確認すべき。

対応プラットフォーム

  • Codex: .cursorrules ファイルで設定。
  • Claude Code: CLAUDE.md ファイルで設定。

ライセンス

MIT

関連スキル