know-your-unknowns は何をしますか?
Codex と Claude スキル:エージェントアーティファクトを用いて未知を可視化します。
概要
このスキルは、AIエージェント(Codex および Claude)がタスクの実行中に「未知の領域」を特定し、それをアーティファクトとして明示的に出力するためのプロンプトテンプレートを提供します。エージェントが自信を持って回答する一方で、見過ごしがちな情報不足や仮定を可視化することで、開発者の判断を支援します。
特徴
- 未知の可視化: エージェントが「わからないこと」「不確かなこと」を積極的に出力します。
- アーティファクト対応: 出力はマークダウン形式のアーティファクトとして保存され、後から参照可能です。
- マルチプラットフォーム: Codex(OpenAI)と Claude(Anthropic)の両方で動作します。
使用方法
- プロジェクトのルートに
.cursorrulesまたはCLAUDE.mdを作成します(使用するエージェントに応じて)。 - 以下の内容を追記します。
## know-your-unknowns
タスクを完了する際には、以下のセクションを出力に含めてください。
### 既知の事柄
- 確信を持って回答できる事実や情報を列挙します。
### 未知の事柄
- 現時点で不明だが、タスク完了に必要となる可能性がある情報を列挙します。
### 不確かな仮定
- 確証がないが、現状のタスクを進めるために行った仮定を明記します。
### 追加調査が必要な領域
- さらに深掘りが必要なトピックや、外部ソースの確認が必要な項目を挙げます。
動作例
エージェントがコードレビューを実施した場合、以下のような出力が期待されます。
レビュー結果
既知の事柄
- 関数
calculateTotalは税込み価格を計算するロジックが正しい。未知の事柄
- この関数が想定する税率のソースが不明(環境変数
TAX_RATEが定義されていない)。不確かな仮定
- 税率は常に10%固定であると仮定してレビューを実施。
追加調査が必要な領域
TAX_RATEのデフォルト値や動的取得方法を確認すべき。
対応プラットフォーム
- Codex:
.cursorrulesファイルで設定。 - Claude Code:
CLAUDE.mdファイルで設定。
ライセンス
MIT