Agent Package 规范 V0.2
最后更新：2026-06-22
概述
Agent Package V0.2 定义了 AI Agent 的标准化打包格式。基于 agent.yaml 清单驱动的声明式规范，确保 Agent 在目录中具有统一的结构、可校验的元数据和安全边界。详见 docs/AGENT_PACKAGE_V0_2.md。
包结构
- agent.yaml (必填) — 机器可读清单
- README.md (必填) — 人类可读说明
- system_prompt.md (必填) — 核心行为定义
- risk_card.md (必填) — 风险评估卡
- workflow.md — 标准工作流
- install.md — 安装说明
- license.md — 许可证
- examples/ — 输入/输出样例
- evals/ — 评估用例
- knowledge/ — 领域知识
agent.yaml 必填字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | Agent 唯一标识符，格式：@agenthr/agent-name |
| version | string | 是 | 语义化版本号，遵循 semver 规范 |
| description | string | 是 | 简短描述，一句话说明 Agent 用途 |
| author | string | 是 | 作者或组织名称 |
| role | string | 是 | 岗位分类 slug，对应目录中的角色 |
| industry | string | 是 | 行业分类 slug，对应目录中的行业 |
| riskLevel | string | 是 | 风险等级 R0-R4，决定权限和行为约束 |
| tools | string[] | 否 | 依赖的工具平台列表 |
SKILL.md 规范
SKILL.md 是 Agent 的核心行为定义文件，采用 Markdown 格式，包含以下章节：
- 角色定义 — Agent 的身份和角色说明
- 核心能力 — 列举 Agent 具备的核心能力，每条能力包含触发条件和执行逻辑
- 约束条件 — Agent 的行为限制和边界说明
- 工具调用 — 可调用的工具及其参数说明（针对 R1-R4 Agent）
- 输出格式 — Agent 响应的结构和格式要求
版本管理
Agent 包使用语义化版本控制（semver）：
- MAJOR — 不兼容的 API/行为变更
- MINOR — 向后兼容的功能新增
- PATCH — 向后兼容的缺陷修复
AgentHR 目录将自动识别并展示最新版本，历史版本保留在发布记录中。
发布流程
Agent 包的发布流程包括以下步骤：
- 按照规范创建 Agent 包目录结构
- 填写 package.json 元数据
- 编写 SKILL.md 行为定义
- 编写 README.md 文档
- 添加示例和测试
- 提交至 AgentHR 目录仓库
- 系统自动验证包结构
- 审核通过后上架目录