manage-agent 的用途是让 agent 通过 amctl 命令行工具驱动 agent-manager 的完整生命周期，把 CLI 中不直观的调用模式固定为可预期流程，避免调用静默失败或返回不完整结果。
使用方式：开始前先给用户简短计划，成功用 ✓、失败用 ✗ 标记；失败时先诊断可能原因并给出修复建议再换方案。如果 command -v amctl 没有返回路径，先询问用户自行安装还是由你安装；若由你安装，运行 bash <absolute-path-to-skill>/scripts/install-amctl.sh，完成后提示用户打开新终端使 PATH 生效，再执行 amctl login --url <instance-url>。登录是交互式浏览器跳转流程，必须由用户在自己的终端完成，不要从当前会话尝试登录。用户确认后，用 amctl project list --json 验证登录，不要用 amctl context show（它对未认证状态无法区分）。
主要能力与铁律：所有调用都传 --json（agent build logs 是纯文本例外）；本会话未调用过的命令以及 create/update 之前先运行 amctl <verb> --help；项目级命令显式传 --project <name>，不要自行 link/unlink；运行时命令（logs、metrics、traces、trace、traces export）需要 --env，本地开发用 default；构建以 buildName 标识而非 buildId，构建命令把 agent 名作为位置参数；amctl agent get 不显示部署健康，需用 logs 或 metrics 验证；校验错误会批量化返回在 error.additionalData.details，要一次性全部修复。
参考文件：references/troubleshooting.md 提供症状→原因→修复表；references/triage.md 提供“构建完成但 agent 未真正运行”的诊断流程。
典型流程：先 amctl agent create --help 确认当前必需 flag 组合（依 --subtype、--build-type、--provisioning 而异），再创建 agent（自动构建并部署到最低环境）；用 amctl agent build list 取最新 buildName，轮询 amctl agent build get 直到 Completed 或 Failed；用 agent logs 或 agent metrics 确认存活；有流量后用 amctl agent traces 查看链路，并用 amctl agent trace 深入单个 traceId。限制：本技能不定义各命令的 flag，flag 以本地安装版本的 --help 为准；技能内容可能无法与 CLI 版本保持同步。