Aport Status

查看 APort 护照状态:能力、交付合约、待办任务及近期决策。如同代理身份的 `git status`。

安装

概览

什么是Aport Status

APort Status 是一个专为 APort 代理身份设计的状态查看工具,其核心作用类似于开发者熟悉的 `git status` 命令——快速呈现代理当前的身份凭证、权限范围、履约要求及任务执行状态。通过调用该技能,代理可以实时获取自己的护照信息(Passport),包括已验证的能力清单、交付物合约的具体条款,以及近期决策记录。这些信息共同构成了代理在 APort 生态系统中的‘数字身份证’和‘工作许可’。用户可在会话开始时运行此命令以明确自身定位,或在被询问能力边界时提供权威依据。此外,它还是调试任务失败原因的关键入口,帮助识别是由于权限不足、履约条件未满足,还是其他策略限制导致的操作被拒。整个流程设计简洁高效,仅需环境变量 `APORT_AGENT_ID` 即可触发,无需复杂配置。

核心功能特点

  1. 实时展示代理的 APort 护照状态,包括身份 ID、归属状态与创建时间
  2. 清晰列出代理具备的所有能力(Capabilities),如文件读写、网页抓取、代码合并等
  3. 显示交付物合约(Deliverable Contract)要求,包括输出格式、测试通过条件和审查规则
  4. 汇总近期决策记录,标注允许(ALLOW)或拒绝(DENY)的操作及其原因
  5. 自动检测并提示潜在问题,如护照被暂停、身份未认领或重复任务失败

适用场景

APort Status 适用于多种需要快速了解代理状态或权限边界的场景。例如,在启动新会话时,代理可先运行此命令来确认自身是否仍处于活跃状态,并掌握当前可用的能力集,避免因权限误解而尝试无效操作。当用户询问“你能做什么?”或“你的限制是什么?”时,该工具能直接引用护照中的能力列表和合约条款,给出准确且一致的回答,增强透明度和可信度。在执行关键动作前,如提交任务完成请求,代理也可先行检查状态,确保满足所有前置条件(如生成足够长度的摘要、通过测试用例),从而减少因履约不达标导致的反复驳回。此外,若某项任务连续被系统拒绝,通过查看 Recent Decisions 部分可快速定位问题根源,判断是否需要人工介入处理。无论是日常协作还是故障排查,APort Status 都提供了一个统一、可靠的自我审视窗口。