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で抑制可能 - エラーメッセージは機械可読形式である
使い方
- 設計中のCLIツールのREADMEや仕様書を読み込む
- 上記の設計原則とチェックリストに従ってレビューする
- 必要に応じて修正提案を自動生成する
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他のAIコードエージェント