Communitygithub.com

Agents365-ai/agent-native-design

エージェントネイティブなCLIの設計・レビュースキル — 人間、AIエージェント、オーケストレーションシステムを同時に支援するCLIを設計します。

agent-native-design とは?

このスキルは、AIエージェントやオーケストレーションシステムと人間の両方を考慮した「エージェントネイティブ」なCLI設計を支援します。従来の人間向けCLIに加え、AIエージェントが解析しやすい構造化出力(JSONやYAMLなど)や、エラー時の機械可読なレスポンス、標準的なフラグ規約に従った設計を推奨します。主にClaude CodeやCursor、CodexなどのAIコードエージェントと連携し、既存のCLIツールのレビューや新規設計のガイドライン提供を行います。スキルのドキュメントには、設計原則、チェックリスト、ベストプラクティスが含まれており、開発者はこれを参照してエージェントフレンドリーなインターフェースを構築できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add Agents365-ai/agent-native-design

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

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

ドキュメント

agent-native-design は何をしますか?

エージェントネイティブなCLI設計・レビュースキル — 人間、AIエージェント、オーケストレーションシステムを同時に支援するCLIを設計します。

概要

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)との親和性が高いCLIツールの設計を支援します。従来の人間中心のCLI設計に加え、機械可読な出力、一貫したインターフェース、標準的なフラグ規約を重視します。

設計原則

  • 構造化出力: JSONまたはYAML形式の出力をデフォルトまたはフラグ(--json, --yaml)で提供する。
  • 終了コード: エラー時に適切な非ゼロ終了コードを返す。
  • ヘルプテキスト: 機械可読なヘルプ(--help)を提供し、AIエージェントが解析可能にする。
  • 進行状況: パイプやリダイレクト時には進行状況表示を抑制する(--quietフラグなど)。
  • エラーメッセージ: 標準化されたエラーフォーマット(例: {"error": "message"})を提供する。

チェックリスト

  • すべてのコマンドに--helpフラグがある
  • 構造化出力フラグ(--json, --yaml)がある
  • エラー時に非ゼロ終了コードを返す
  • 進行状況表示は--quietで抑制可能
  • エラーメッセージは機械可読形式である

使い方

  1. 設計中のCLIツールのREADMEや仕様書を読み込む
  2. 上記の設計原則とチェックリストに従ってレビューする
  3. 必要に応じて修正提案を自動生成する

対応プラットフォーム

  • Claude Code
  • Cursor
  • Codex
  • その他のAIコードエージェント

関連スキル