Pebble Spec v1.1

面向 Agent 的 CLI 技能规范 - 让 AI 能够可靠地调用命令行工具

核心特性

• 双模式输出: 人类友好 (默认) + Agent 模式 (JSON Lines)
• 结构化错误: 包含错误码、重试建议、修复提示
• 机器可读清单: --manifest 输出工具元信息
• 统一退出码: 0=成功, 1=输入错误, 2=系统错误, 3=认证错误, 4=超时

快速开始

# 查看工具清单
mytool --manifest

# Agent 模式调用
mytool action --agent

# 输出示例
{"v":1,"type":"result","payload":{...}}

文档

完整规范文档 (Markdown)

参考实现

cf-cli - Cloudflare 基础设施管理工具