用途：为 A2A（Agent-to-Agent）协议提供可复用的 Agent Card JSON 模板，遵循官方规范，用于创建智能体卡片、实现智能体发现端点、配置认证方案、定义能力与技能、设置服务端点及校验卡片结构。
主要能力：提供四类模板——基础卡片（仅必填字段、简单 API Key 认证、单技能）、多能力卡片（多技能、输入输出 schema、能力标志）、认证卡片（API Key、Bearer、OAuth2、Basic、OpenID Connect 等多种方案与组合）、流式卡片（streaming、pushNotifications、WebHook、SSE）。附带 schema.json 校验用 JSON Schema、examples/ 真实示例，以及 validate-agent-card.sh、generate-agent-card.sh、test-agent-card.sh 三个脚本。
卡片结构：必填含 id、name、protocolVersion、serviceEndpoint、provider、securitySchemes、security、capabilities；可选含 description、logo、version、skills、extensions、metadata。技能定义含 name、description、inputSchema、outputSchema、inputModes、outputModes、tags、examples。
使用方式：先 ls templates/ 选择模板，用 ./scripts/generate-agent-card.sh [--template basic|multi|authenticated|streaming] 交互生成，再用 ./scripts/validate-agent-card.sh agent-card.json 与 ./scripts/test-agent-card.sh agent-card.json 校验，最后托管于 https://<base_url>/.well-known/agent.json 或 /.well-known/agent-card.json。
限制与安全：支持 A2A 协议 0.3+，模板版本 1.0.0。禁止硬编码真实密钥，须用占位符（如 your_service_key_here），提供 .env.example 并将 .env* 加入 .gitignore，代码从环境变量读取。常见问题包括卡片无法被发现、认证失败、schema 校验错误、技能未被识别，可分别检查端点可访问性、securitySchemes 与实现一致性、运行校验脚本、确认 schema 为合法 JSON Schema。具体收费与平台信息暂未提供。