SuperAPI AI 工具集

claims

智能体与模型

查看项目

更新于 10-16 08:38

技能介绍

用途:为智能体操作与访问控制提供基于声明(claim)的授权,管理多智能体协作中的安全权限,遵循最小权限原则。

主要能力:授权声明类型包括 read(读取文件)、write(写入文件)、execute(执行命令)、spawn(派生智能体)、memory(访问记忆)、network(网络访问)、admin(管理操作)。支持范围模式:* 表示所有资源,/src/** 表示 src 下全部文件,/config/*.toml 表示 config 中的 TOML 文件,memory:patterns 表示 patterns 命名空间。安全等级:minimal 仅 read;standard 为 read、write、execute;elevated 增加 spawn、memory;admin 拥有全部声明。

使用方式:检查声明:npx claude-flow claims check --agent agent-123 --claim write;授予:npx claude-flow claims grant --agent agent-123 --claim write --scope "/src/**";撤销:npx claude-flow claims revoke --agent agent-123 --claim write;列出:npx claude-flow claims list --agent agent-123。

跨主机工作声明(联邦,v3.40.0+):与上述授权声明不同,工作声明用于协调任务或资源所有权,并可跨主机联邦传播。运行时工具包括 claims_claim(取得所有权,可选 TTL)、claims_release、claims_handoff / claims_accept-handoff、claims_steal / claims_mark-stealable、claims_status / claims_list。联邦方式通过 federation_bbs_publish 发布 ClaimIssued、ClaimReleased、ClaimHandoff、ClaimAck 等消息。规则:每个 resourceId 仅一个所有者;首个有效 ClaimIssued 胜出(同等则最早时间戳、再取最小 from);ClaimReleased 或 TTL 过期释放;ClaimHandoff 仅限当前所有者;协调者发布 ClaimAck 指明权威所有者。共享工作前应先声明、同步,仅在获得确认的所有者身份后继续;如需跨主机可见且运行时强制,应同时发布联邦声明消息并调用 claims_claim。

将声明流限定到频道(ADR-386):可创建私有频道并授权、发布、读取,例如 npx ruflo federation channel --action create --name platform-team --visibility private。注意私有频道隐藏内容但不隐藏元数据(中继仍可见发布者与时间),且频道外的声明无法与之仲裁;若所有权需全群可见,应使用开放流。

最佳实践:遵循最小权限;将声明限定到具体资源;定期审计声明使用;不再需要时撤销声明。限制:资料未提供具体部署环境、版本兼容细节与收费信息。