SuperAPI AI 工具集

oia-manifest

智能体与模型

查看项目

更新于 10-16 08:37

技能介绍

用途:oia-manifest 是 Codex 技能,用于生成或校验 harness 的 OIA 跨切面清单(ADR-034,iter 121→iter 122),输出 .harness/oia-manifest.json,对 Open Intelligence Architecture(OIA)v0.1 九层参考模型做自我评估。该模型由 Agentics Foundation 发布(https://oia.agentics.org)。OIA v0.1 无运行时、无线上协议,是厂商中立的评估词汇,故采用静态跨切面清单(ADR-034 决策 Option B),位置在宿主适配器契约之上、MCP 策略门之下。

主要能力:声明 9 层对齐(L1 physicalCompute → L9 humanAndBrowserInterface,每层取 full/partial/none/not-applicable);6 个横向跨度(security、observability、identity、governance、policyEnforcement、interoperability,各取 full/partial/none 并附实现引用,如文件路径或 ADR 编号);4 个相邻标准(mcp、a2a、acp、agentProtocol,含当前模式与接线说明);以及 discoveryEndpoint 与 registryUrl(v0.1 均为 null,OIA 尚无注册表)。

使用方式:Codex 中执行 /oia-manifest path=./my-harness;加 check=true 校验,加 dry-run=true 仅输出。等价 CLI:harness oia-manifest ./my-harness(写入清单);--check(校验已有清单);--dry-run(输出到 stdout 不写文件);--json(输出 JSON)。校验判定与退出码:PASS=0(形状正确并回显 oiaVersion);DRIFT=1(形状不匹配,逐字段给出原因);FAIL no manifest=2(.harness/oia-manifest.json 缺失)。

限制与规则:ADR-034 §120 预置组合规则要求,若未来 OIA 身份原语试图放宽 MCP 权限,将在策略门被拒绝;mcp-policy.json 的默认拒绝姿态对外部身份声明不可协商。相关技能:validate-harness、threat-model、diag-harness。相关文档:ADR-034(OIA 集成)、ADR-022(MCP 原语)、ADR-030(Discovery Loop)。