---
type: template
name: Agent Card 模板
description: Nebula Agent 标准卡片模板。每个agent在 99_System/agents/ 下应有对应的card文件。
status: active
last_updated: '2026-07-04'
version: '1.0'
date: '2026-06-21'
---

> **Universe Skill 命名补丁（2026-07-30）**：本文件中的旧 skill 名称多为当前目录名 / legacy implementation / mount path，不代表 canonical skill 名。治理主口径见 `Universe/99_System/Governance/Rules/Universe_Skill_Naming_Rules_v0.2.md`（canonical）与 `99_System/Skills/Runtime_Skill_Implementations_v0.1.md`：`nebula-filing` → `universe-filing`；`meeting-minutes` / `minutes-orchestrator` / `inbox-compile` → `universe-compile`；`summarize` / `summarize-pro` 仅为前处理，不替代 compile。


# Agent Card 模板

> 每个 Agent 在 `99_System/agents/{agent_name}.md` 持有一张卡片。
>
> **身份真相层级（2026-08-06 更新）**：Agent 身份主键、roster 状态与 active-status 以 `AGENT_REPORT.json` 为准；本卡承接个体角色、经历、分工、证据与历史说明，不独立生成或覆盖 agent_id。AGENT_SKILLS.json 是从卡片生成的索引。

## 卡片结构

```yaml
---
type: person
name: "Agent名称"
alias: ["别名1", "别名2"]
platform: openclaw|anygen|workbuddy|coze|miaoda
status: active|inactive|deprecated
created: "YYYY-MM-DD"
last_governor_run: null|"YYYY-MM-DDTHH:MM:SS"
---

# {Agent名称}

## 基本信息

| 字段 | 值 |
|---|---|
| 名称 | |
| 别名 | |
| 平台 | |
| 状态 | |
| 创建日期 | |

## 职责定义

> 由R定义。描述这个Agent在系统中的角色和职责。

## 期望 Skills

### Nebula Skills（系统级）
- nebula-filing
- nebula-agent-governor
- ...

### Local Skills（平台级）
- calendar
- lark-*
- ...

## 能力矩阵

| 能力类型 | 具体能力 |
|---|---|
| Tools | python3, filesystem, curl, node |
| APIs | feishu, telegram, web_search |
| Permissions | file_read, file_write, exec |

## 配置状态

| 文件 | 大小 | 状态 | 上次瘦身 |
|---|---|---|---|
| AGENTS.md | bytes | OK/Bloated | YYYY-MM-DD |
| TOOLS.md | bytes | OK/Bloated | YYYY-MM-DD |

## 对齐记录

| 日期 | 模式 | 结果 | 备注 |
|---|---|---|---|
| YYYY-MM-DD | full/quick | OK/Warn | |

## 变更历史

| 日期 | 变更内容 |
|---|---|
| YYYY-MM-DD | 初始创建 |
```

## 字段说明

### Frontmatter

| 字段 | 必填 | 说明 |
|---|---|---|
| type | ✅ | 固定 `agent-card` |
| name | ✅ | Agent名称 |
| alias | ❌ | 别名列表（用于匹配） |
| platform | ✅ | 运行平台 |
| status | ✅ | 状态 |
| created | ✅ | 创建日期 |
| last_governor_run | ❌ | 最近一次Governor运行时间 |

### 正文

| 区块 | 必填 | 说明 |
|---|---|---|
| 基本信息 | ✅ | 摘要信息 |
| 职责定义 | ✅ | R定义的职责 |
| 期望 Skills | ✅ | R期望该Agent具备的skills |
| 能力矩阵 | ✅ | 环境能力 |
| 配置状态 | ❌ | Governor运行后自动填充 |
| 对齐记录 | ❌ | Governor运行后自动填充 |
| 变更历史 | ❌ | 重大变更记录 |

## 与 AGENT_SKILLS.json / AGENT_REPORT.json 的关系

```
AGENT_REPORT.json（身份真相源：agent_id / roster / active-status）
  ↓
Agent Card（个体档案：角色、经历、分工、证据与历史说明）
  ↓ agent-align 时自动同步
AGENT_SKILLS.json（索引）
```

- **身份主键以 AGENT_REPORT.json 为准**；Card 不独立生成或覆盖 agent_id
- Card 由 R 定义职责，Agent 确认能力
- JSON 从 Card 自动生成，用于快速查询
- 修改 Card，JSON 自动更新
- 不要直接修改 JSON（会被Card覆盖）
- 能力登记（平台/模型/能力实测/数据域/工作负载）以 `Universe/99_System/Registry/Agent_Capability_Registry.md` 为准，Card 引用其结论