agent-ready-cli-spec
Agent-Ready CLI Spec 是一个用于把 CLI 工作流故事、需求或 OpenAPI 规范转化为精确、可供智能体使用的命令契约的技能。它帮助设计命令树、语法、标志、配置优先级、认证、JSON 输出模式、错误码、退出码和测试计划,使构建者能实现、审计者能测试。该技能强调智能体执行循环:发现→认证→检查→计划/试运行→执行→验证→恢复/总结。它支持从 OpenAPI 文件推导契约,包括路径到资源、操作到动词、安全方案到认证模型、服务器到基础 URL 配置的映射,并处理占位符 URL 和只读 API 等场景。输出为 Markdown 格式的规范文件,包含范围、假设、命令树、工作流契约、JSON 模式、配置与认证、安全模型、错误与退出码表、测试计划、实时 API 检查及构建交接建议。