# Agent Capability Registry v0.1

> **状态**：active（能力登记 canonical）
> **角色**：基于 AGENT_REPORT roster 的能力、平台、运行环境、数据域与工作负载登记层
> **创建日期**：2026-08-02（schema 原稿）· 2026-08-06（迁入 Universe，正式生效）
> **维护人**：小宝（xiaobao）
> **审定人**：珍珍（zhenzhen）
> **supersedes**：`Nebula/99_System/agents/Agent-Platform-Registry-v0.1.md`（已降级为兼容 pointer）
> **来源**：由 Agent-Platform-Registry-v0.1.md + `Platform-Registry/` 数据层拆分迁移而来（R 审定 · Phase 2-E/2-5）
> **备份**：`Nebula/99_System/agents/.backup/`

---

## 0. 真相层级与边界声明

| 层 | 文件 | 职责 | 约束 |
|----|------|------|------|
| **L1 身份真相源** | `AGENT_REPORT.json` | 唯一 canonical roster：agent_id、是否现役、主名称、基础拓扑归属 | **不迁、不改**；agent_id / active-status 只以此为准 |
| **L2 个体档案** | Agent Card（`agents/{name}.md`） | 个体角色、经历、分工、证据与历史说明主档 | **不迁、不改**；不独立生成/覆盖 agent_id；身份主键以 AGENT_REPORT.json 为准 |
| **L3 能力登记** | **本文件（Agent Capability Registry）** | 基于 L1 roster 的能力、平台、运行环境、数据域与工作负载登记层 | **不能新建 agent_id，不能改 active-status，不能取代 Agent Card** |
| L4 环境事实 | Runtime Environment Registry | Ark / Neb / Zion / Falcon 等环境细节 | agent 表只引用 runtime_id，不复制设备详情 |

**本 Registry 的定位**：它是 AGENT_REPORT roster 的能力投影登记层，不是新的身份真相源。

---

## 1. 登记字段

### 1.1 身份引用（只引用，不新建）

| 字段 | 说明 | 来源 |
|------|------|------|
| `agent_id` | 仅引用 AGENT_REPORT.json canonical roster / limited_scope_agents | AGENT_REPORT.json |
| `agent_name` | 显示名 | AGENT_REPORT.json |
| `roster_status` | canonical / limited_scope / retired / pending | AGENT_REPORT.json（引用，不可改） |

### 1.2 平台与运行环境

| 字段 | 说明 |
|------|------|
| `platform_base` | WorkBuddy / QClaw / AnyClaw / OpenClaw / AutoClaw / other |
| `app_runtime` | 具体 app / 客户端 / 部署形态 |
| `model_backend` | 模型后端（mimo / claude / gpt / local / unknown）——**仅作线索，能力以实测为准** |
| `runtime_id` | 仅引用 Runtime Environment Registry（如 ark-futian），不复制设备详情 |

### 1.3 能力登记（核心：实测 + 证据口径）

> **硬规则**：模型能力必须按实测登记，不能只写模型名。每条能力记录至少包含：

```yaml
agent_id: string          # 引用 roster
field: string             # 能力字段，如 ocr / table_extraction / long_context / file_read / browser / tool_call / connectors / web_search
value: string             # 能力实测结果或能力值
source: self_report|verified_test|evidence_doc   # 来源类型
verified_at: datetime     # 珍珍或测试核验时间（null = 未核验）
effective_at: datetime    # 生效时间
status: verified|reported|gap|unknown   # 状态
evidence_or_note: string  # 证据链接 / 测试记录 / 备注
```

能力字段参考枚举：`ocr` / `table_extraction` / `long_context` / `file_read` / `browser` / `tool_call` / `connectors` / `web_search` / `telegram` / `feishu` / `notion` / `calendar` / `exec` / `cron`（可扩展）。

### 1.4 数据域与负载

| 字段 | 说明 |
|------|------|
| `data_domain` | private / company / mixed / isolated（与 AGENT_REPORT 对齐校验） |
| `connectors` | 连接器列表（对应能力实测） |
| `workload_traits` | long_running / connector_heavy / private_assistant / investment_analysis / system_ops / reviewer / batch_processing |

### 1.5 分工与变化

| 字段 | 说明 |
|------|------|
| `current_primary_role` | 当前主要角色（珍珍审定） |
| `secondary_roles` | 次要角色 |
| `not_suitable_for` | 不适合任务 |
| `role_change_log` | 最近分工变化（含日期与依据） |

### 1.6 登记元数据

| 字段 | 说明 |
|------|------|
| `last_self_report` | 最近自报告时间 |
| `last_reviewed_by_zhenzhen` | 最近珍珍审定时间 |
| `change_log` | 本 Registry 记录变更历史 |

---

## 2. 登记状态规则

- **verified**：已由珍珍审定或实测通过
- **reported**：agent 自报，尚未审定
- **gap**：已知能力缺口（如 web_search 未通）
- **unknown**：未登记 / 未实测

没有时间与证据的静态「能力结论」，不应直接作为 active capability——必须补 `verified_at` / `effective_at` / `evidence_or_note` 后才能标 verified。

---

## 3. 首批登记（基于存量抽取 + 已落地自登记）

| agent_id | 状态 | 数据来源 | 说明 |
|----------|------|----------|------|
| ranran | canonical | Platform-Registry/ranran.md（自登记 2026-07-28） | 投资主力；数据迁入后需补能力实测字段 |
| nini | canonical | Platform-Registry/nini.md（自登记 2026-07-29） | 业务域与跨库分工需确认 |
| nana | canonical | Self-Reports/nana-self-report-2026-07-29.md | 系统能力登记与投资辅助边界需确认 |
| dabao | canonical | Self-Reports/dabao_self_report.yaml | 存量数据迁入 |
| duobao | **limited_scope** | Platform-Registry/duobao.md（2026-07-29） | **标 limited_scope / pending_review，不混入 canonical 能力主表**；BoA-only 边界已确认（2026-08-06 回执） |
| 其余 roster agent | canonical | extraction_table.md（存量抽取，置信度标注） | 首批名单：娜娜、小宝、菲菲、大宝、文文、珍珍、云端 3 个 |

> 未在 AGENT_REPORT.json roster 的条目不得悄悄进入本 Registry；如出现，标 historical / pending / non-canonical 并单独上报。

> **存量数据完整性**：上述自登记与抽取数据的原始文件保留在 `Nebula/99_System/agents/Platform-Registry/`（历史入口）与 `Nebula/99_System/agents/Self-Reports/`，本 Registry 引用并逐步核验这些证据，不等于旧数据已被无差别复制为 verified capability。

---

## 3.1 首批能力确认（P2-5 · 珍珍审定 2026-08-07：部分通过）

> 状态标记：**verified** = 珍珍审定通过（身份事实 + 治理/分工/边界事实）；**reported** = 本人已确认但技术字段待独立实测或可核验证据（不因本人确认而自动升级）；**gap** = 局部视图限制/未核验。
> 审定口径（珍珍 2026-08-07）：治理/边界事实可 verified；技术字段（platform_base / app_runtime / model_backend / runtime_id / connectors 等）维持 reported，待独立实测后升 verified。

### xiaobao（小宝）· 2026-08-06 已签署 ✅

| 字段 | 确认值 | source | verified_at | status |
|------|--------|--------|-------------|--------|
| agent_id | xiaobao（canonical roster） | AGENT_REPORT.json 引用 | — | verified（身份） |
| platform_base | workbuddy（海外版） | self_report | 2026-08-06 | reported |
| app_runtime | WorkBuddy Desktop（macOS · Zion） | self_report | 2026-08-06 | reported |
| model_backend | mimo（mimo-v2.5-pro） | evidence_doc（models.json + API 实测 2026-07-29） | 2026-07-29 | reported |
| runtime_id | zion（引用） | self_report | 2026-08-06 | reported |
| data_domain | private（Zion 私域执行位）；承接 Universe/Nebula 系统治理件 | self_report | 2026-08-06 | reported |
| connectors | local_files / exec / cron / web_search / web_fetch / browser / tool_call / MCP 连接器（yoooclaw 已实测接入） | verified_test（本会话持续实测） | 2026-08-06 | reported |
| workload_traits | system_ops / connector_heavy / long_running / batch_processing / registry_ops | self_report | 2026-08-06 | reported |
| current_primary_role | Registry/Ops 执行与维护 | 珍珍审定（分工事实） | 2026-08-07 | verified |
| not_suitable_for | 投资最终判断 / 商业最终审定 / 公司业务线主档 | self_report | 2026-08-06 | reported |
| gap | Zion 当前检索/同步视图不等于 Neb 完整视图（跨设备结论需 R 或 Neb agent 复核）；Falcon/Windows 未实跑验证 | self_report | 2026-08-06 | gap |

> 回执全文：`Phase2E_Agent_Capability_Registry_Draft/Signature_Packages/xiaobao.md`。珍珍审定（2026-08-07）：分工责任 verified；技术字段维持 reported。

### ranran（然然）· 2026-08-06 已签署 ✅

| 字段 | 确认值 | source | verified_at | status |
|------|--------|--------|-------------|--------|
| agent_id | ranran（canonical roster） | AGENT_REPORT.json 引用 | — | verified（身份） |
| platform_base | autoclaw（海外版） | self_report | 2026-08-06 | reported |
| app_runtime | AutoClaw Desktop (OpenClaw 海外版, macOS) | self_report | 2026-08-06 | reported |
| model_backend | deepseek-v4-pro | self_report | 2026-08-06 | reported |
| runtime_id | zion（引用） | self_report | 2026-08-06 | reported |
| data_domain | private | self_report | 2026-08-06 | reported |
| connectors | telegram / local_files / exec / cron / web_fetch / **ocr-locally**（macOS 原生 OCR，符号链接挂载自 BoA/BoA_System/skills/ocr-locally）；pdf/docx / message 作为 workload 工具不逐一列 | self_report | 2026-08-06 | reported |
| web_search | **web_fetch 已通**（DuckDuckGo/Google 可抓）；**web_search 条件可用**（已配置，依赖 provider，超频/网络受限时不稳定） | self_report | 2026-08-06 | reported |
| workload_traits | investment_analysis / private_assistant / reviewer / daily_intelligence_intake | self_report | 2026-08-06 | reported |
| current_primary_role | 投资工作主力（BoA 日更/滚动项/Thesis/周报/情报入库）+ Reviewer Trainee（第二审定员候补），与 BoA 治理一致 | 珍珍审定（分工事实） | 2026-08-07 | verified |
| gap | web_search 条件可用（非稳定），依赖 provider 状态 | self_report | 2026-08-06 | gap |

> 回执：agent_id: ranran / agent_name: 然然 / signed_at: 2026-08-06T20:40:00+08:00 · 上表核对无异议（connectors 补 ocr-locally；web_fetch 已通 / web_search 条件可用）。珍珍审定（2026-08-07）：投资主力 + Reviewer Trainee 分工 verified；技术字段维持 reported。

### nini（妮妮）· 2026-08-06 已签署 ✅

| 字段 | 确认值 | source | verified_at | status |
|------|--------|--------|-------------|--------|
| agent_id | nini（canonical roster） | AGENT_REPORT.json 引用 | — | verified（身份） |
| platform_base | openclaw | self_report | 2026-08-06 | reported |
| app_runtime | OpenClaw（Neb · Nebuchadnezzar 节点） | self_report | 2026-08-06 | reported |
| model_backend | **mimo（mimo-v2.5）**（此前待补，已确认） | self_report | 2026-08-06 | reported |
| runtime_id | neb（引用） | self_report | 2026-08-06 | reported |
| data_domain | company | self_report | 2026-08-06 | reported |
| connectors | local_files / exec / cron / web_search / web_fetch / browser / tool_call / feishu / flowus / memory / lark_tools（按实际能力补） | self_report | 2026-08-06 | reported |
| workload_traits | 业务线思考 | self_report | 2026-08-06 | reported |
| current_primary_role | 业务线思考位（公司侧） | 珍珍审定（分工事实） | 2026-08-07 | verified |
| 跨库分工 | 维持 2026-07-26 口径：已退出系统架构执行，专注业务侧，无变化 | 珍珍审定（分工事实） | 2026-08-07 | verified |

> 回执：agent_id: nini / agent_name: 妮妮 / signed_at: 2026-08-06T20:36:00+08:00 · 上表无异议。珍珍审定（2026-08-07）：业务侧主力分工 verified；技术字段维持 reported。

### nana（娜娜）· 2026-08-06 已签署 ✅

| 字段 | 确认值 | source | verified_at | status |
|------|--------|--------|-------------|--------|
| agent_id | nana（canonical roster） | AGENT_REPORT.json 引用 | — | verified（身份） |
| platform_base | qclaw（海外版） | self_report | 2026-08-06 | reported |
| app_runtime | QClaw（SGP 节点） | self_report | 2026-08-06 | reported |
| model_backend | mimo（mimo-v2.5-pro, SGP） | self_report | 2026-08-06 | reported |
| runtime_id | zion（引用） | self_report | 2026-08-06 | reported |
| data_domain | private | self_report | 2026-08-06 | reported |
| connectors | telegram / feishu / notion / local_files | self_report | 2026-08-06 | reported |
| workload_traits | private_assistant / investment_analysis / reviewer / structured_maintenance | self_report | 2026-08-06 | reported |
| current_primary_role | 个人助理主力（日程/日常/生活）+ 投资辅助（投资主力已移交然然） | 珍珍审定（分工事实） | 2026-08-07 | verified |
| 投资辅助边界 | 投资情报辅助 / BoA 支持，不承担投资最终判断 | self_report | 2026-08-06 | reported |
| 系统架构能力 | **保留能力，但不作为当前主要角色**：系统架构由小宝主导，娜娜可提供支持但不主导（2026-07-26 前曾承担系统架构思考） | 珍珍审定（分工事实） | 2026-08-07 | verified |

> 回执：agent_id: nana / agent_name: 娜娜 / signed_at: 2026-08-06T20:38:00+08:00 · 上表无异议，第 10 项补充说明：系统架构能力保留，但当前角色为个人助理主力 + 投资辅助，系统架构由小宝主导。珍珍审定（2026-08-07）：个人助理主力 + 投资辅助、系统架构能力分工 verified；技术字段维持 reported。

### duobao（多宝）· limited_scope · 2026-08-06 已签署 ✅

> **limited_scope agent**：BoA 子库 agent，不混入 canonical 能力主表；本小节为边界确认记录（pending_review 标注维持）。

| 字段 | 确认值 | source | verified_at | status |
|------|--------|--------|-------------|--------|
| agent_id | duobao（AGENT_REPORT limited_scope，BoA-only） | AGENT_REPORT.json 引用 + 本地登记（BoA_System/agents/多宝.md，2026-07-29） | — | verified（身份） |
| limited_scope / pending_review | **接受**：BoA 子库 agent，不混入 canonical 主表 | 珍珍审定（边界事实） | 2026-08-07 | verified |
| BoA-only 边界 | 确认，与本地卡「硬边界」一致：R 私人决策域 / Nebula 物理不可达 / R+李猪猪共用 | 珍珍审定（边界事实） | 2026-08-07 | verified |
| platform_base | cloud（独立云电脑） | self_report | 2026-08-06 | reported |
| model_backend | **deepseek-v4-flash**（网关运行时实际后端，DeepSeek v4 Flash；此前登记 unknown → 已修正） | self_report（网关运行时事实） | 2026-08-06 | reported |
| runtime_id | cloud | self_report | 2026-08-06 | reported |
| data_domain | private（仅 Cluster/BoA/） | self_report | 2026-08-06 | reported |
| connectors | local_files（BoA 数据域内仅本地文件）；**平台内置另挂载 feishu- / web_search 连接器，属平台内置件、不计入 BoA 数据域**（与 BoA_Skills_Sync_Registry_v0.1 对 feishu- 的「平台内置不属 BoA 治理」分类一致） | self_report | 2026-08-06 | reported |
| workload_traits | batch_processing（周报/数据汇总）/ archival（boa-archival）/ wiki_maintenance（boa-wiki） | self_report | 2026-08-06 | reported |
| current_primary_role | BoA 子库运维 + 共享辅助 | self_report | 2026-08-06 | reported |
| gap | **BoA 运行环境局部视图**：BoA 侧物理不可达 Universe canonical 文件，无法直接核验 Registry 原文；确认基于本地登记与运行事实。此 gap 仅限 BoA 环境视图，**不代表 Universe 全局不可达**（符合「设备视图 ≠ 全局视图」口径） | self_report | 2026-08-06 | gap |

> 回执：agent_id: duobao / agent_name: 多宝 / signed_at: 2026-08-06T20:46:51+08:00 · 边界确认：基本无异议，1 项修正（model_backend: unknown → deepseek-v4-flash）+ 1 项补充说明（feishu-/web_search 平台内置件不计入 BoA 数据域）。珍珍审定（2026-08-07）：limited_scope / BoA-only 边界 verified；技术字段维持 reported。
> ✅ 本地卡同步完成（2026-08-07T08:23:10+08:00，回执含 agent_id/agent_name/signed_at/实际修改路径）：`BoA_System/agents/多宝.md` 基本信息表新增 model_backend: deepseek-v4-flash（status: reported，待独立实测后升 verified，未标已确认）；变更历史追加 2026-08-07 记录；limited_scope / pending_review 与 BoA-only 硬边界原样保留未动。P2-5 全部待办清零。

### 回执状态（5/5 全部签署 · 珍珍审定 2026-08-07 部分通过）

| agent_id | 确认重点 | 签名状态 | 珍珍审定 |
|----------|----------|----------|----------|
| xiaobao | Registry/Ops 执行与维护责任 | ✅ 2026-08-06 | 分工 verified；技术字段 reported |
| ranran | 投资主力定位、能力/平台/数据域、web_search gap | ✅ 2026-08-06 | 投资主力+Reviewer Trainee verified；技术字段 reported |
| nini | 业务域与跨库分工 | ✅ 2026-08-06 | 业务侧分工 verified；技术字段 reported |
| nana | 系统能力登记与投资辅助边界 | ✅ 2026-08-06 | 分工+系统架构归属 verified；技术字段 reported |
| duobao | Cloud / BoA-only、limited_scope / pending_review 边界 | ✅ 2026-08-06 | limited_scope/BoA-only 边界 verified；技术字段 reported |

> 确认包位置：`Phase2E_Agent_Capability_Registry_Draft/Signature_Packages/{agent_id}.md`（5 份原始回执已留存，可审计）
> 审定结论（珍珍 2026-08-07）：治理/边界事实升 verified；技术字段（platform_base / app_runtime / model_backend / runtime_id / connectors 等）维持 reported，待独立实测或可核验证据后再升。

---

## 4. 维护流程

1. agent 自报 → 按 §1.3 证据口径提交
2. 小宝整理/抽取 → 标注 source
3. 珍珍审定 → 标 verified / rejected
4. 写入本 Registry + 更新 Agent Change Index
5. 分工变化 / 能力变化 → 更新 role_change_log / change_log

---

## 5. 迁移记录与版本说明

| 版本 | 日期 | 变更 |
|------|------|------|
| v0.1-draft | 2026-08-06 | Phase 2-E 草稿：真相层级 + 证据口径 schema + 首批登记映射 |
| v0.1 | 2026-08-06 | R 批准 P2-5 拆分迁移后正式写入 Universe/99_System/Registry/；原 Agent-Platform-Registry-v0.1.md 降级为兼容 pointer |
| v0.1.1 | 2026-08-07 | 珍珍审定（部分通过）：治理/边界事实升 verified（xiaobao Registry-Ops / ranran 投资主力+Reviewer / nini 业务侧分工 / nana 分工+系统架构归属 / duobao limited_scope+BoA-only）；技术字段统一维持 reported；4 份原始签名回执补入 Signature_Packages/ |

**迁移执行记录**：
- 2026-08-06：R 批准 P2-5「拆分后迁移」；命名定为 Agent_Capability_Registry.md（非泛称 Agent_Registry）
- 真相层级 L1-L4 由 R 审定：AGENT_REPORT.json 管「是谁」（唯一），Agent Card 管「个体档案」，本 Registry 管「能做什么」，Platform Capability Matrix 只是投影
- 模板补丁：AGENT_CARD_TEMPLATE.md 身份真相层级表述同步更新
- 定向签名确认：ranran / nini / duobao / nana / xiaobao（见 Phase 2-E 签名包）
