agent-interface-design

エージェント向けインターフェース設計

AIエージェントが使い方を理解できるツール、スクリプト、CLIの設計を支援するスキル。

AIスキル大辞典による日本語要約
品質評価100/100評価確度:十分
人気度(GitHub Star) 86発掘スコア 74
01

このSkillでできること

  • エージェントが呼び出すツール、スクリプト、CLIの設計を支援する
  • 既存ツールの誤用を調査し、インターフェース上の原因を特定する
  • 列挙型や意図を表す名前など、意味をパラメータへ反映する
  • ツールを常時コンテキストに置くか、必要時に発見できる形にするか判断する
02

使い方

01
STEP 1

既存の呼び出し元やログ、会話記録、利用者の指摘を確認し、誤用の実態を把握する

02
STEP 2

自由記述より列挙型を使い、実装ではなく意図を表すパラメータ名にする

03
STEP 3

振る舞いに関する説明はツール自身の説明へ置き、全体の前置きとの重複を避ける

04
STEP 4

設計後も許容される誤りを特定し、必要なら明示的な制約や確認を追加する

03

Skillのインストール

このGitHubリポジトリにあるSkillを確認し、現在の環境に適した方法でインストールしてください。
インストール後、正常に利用できることを確認し、基本的な使い方も簡潔に説明してください。

Repository:
https://github.com/Neeeophytee/finding-unknowns-skills
手動でインストールする

README / SKILL.mdから機械抽出できたコマンドのみ表示しています。推測したコマンドではありません。

git clone https://github.com/Neeeophytee/finding-unknowns-skills
cp -r finding-unknowns-skills/skills/* ~/.agents/skills/        # all projects
git clone https://github.com/Neeeophytee/finding-unknowns-skills
cp -r finding-unknowns-skills/skills/* ~/.kimi/skills/           # all projects
04

このSkillを使うプロンプト例

Skill名を明示すると、意図したSkillを使わせやすくなります。自動発動型では必須とは限りません。

既存のエージェント向けツールが誤用されています。呼び出しログを前提に、誤用の原因をパラメータ名・型・ツール説明の観点で整理し、例を増やす前にインターフェースの改善案を提示してください。
出力例を見る
誤用の原因:状態パラメータが自由記述で、許可された状態が分からない。
改善案:状態を列挙型にし、ツール説明には呼び出し時の振る舞いだけを記載する。
残るリスク:高リスク操作の確認要否を別途判断する。
05

安全性チェック

自動解析による参考情報です。Skillの安全性を保証するものではありません。

外部API通信検出あり
Shellコマンド実行明確な記述なし
ファイル読み取り明確な記述なし
ファイル書き込み明確な記述なし
ネットワークアクセス検出あり
認証情報明確な記述なし
検出根拠を見る
  • network: ran long. # Finding-Unknowns Skills [![GitHub stars](https://img.shields.io/github/stars/Neeeophytee/finding-unknowns-skills?style=flat)](https://githu
  • network: stars/Neeeophytee/finding-unknowns-skills?style=flat)](https://github.com/Neeeophytee/finding-unknowns-skills/stargazers) [![skills.sh installs](https://
06

関連Skill