Skip to content

Commit 7500e68

Browse files
binzi1989binzi1989
committed
docs: rebuild GitHub product homepage
1 parent d10a136 commit 7500e68

6 files changed

Lines changed: 660 additions & 105 deletions

‎AGENT-PACK-OPERATING-GUIDE.md‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# NOVA Agent Pack 操作方案
2+
3+
这套方案把 NOVA 保持为一个稳定的 AgentOS，把行业差异封装为可启停的 Agent Pack。跨境电商是首个样板，但同一机制可以用于制造、外贸销售、客服、法务辅助、内容生产、项目管理等场景。
4+
5+
## 一、用户如何使用
6+
7+
1. 在 NOVA 选择工作区并连接模型。
8+
2. 打开“扩展坞 → Agents”。
9+
3. 查看 Agent Pack 的适用范围、专业角色、执行步骤、交付物和权限声明。
10+
4. 启用一个 Agent Pack，点击“使用此 Agent”。
11+
5. NOVA 按 Agent Pack 的 `onboarding` 标准展示所需资料、选择项、资料用途和示例；用户不需要知道专业提示词。
12+
6. 选择希望先得到的结果，NOVA 自动把当前线索组装为第一轮任务；资料不齐时保留未知项并指导下一步收集。
13+
7. 在输入框旁确认当前专业 Agent；不需要行业能力时切回“通用 NOVA”。
14+
8. NOVA 在右侧显示计划、角色分工和执行证据；涉及发布、账号、广告、购买或桌面操作时仍单独确认。
15+
9. 在交付工作台检查文件、数据来源、未知项和 Proof-of-Done，再决定继续追问、返工或归档。
16+
17+
当前版本遵循“一项任务、一个主 Agent Pack”。Pack 内可以定义多个专业角色并由 Agent Mesh 调度；MCP 和 Skills 作为工具能力补充，不会改变主 Pack 的交付责任。这样可以避免多个行业规则互相污染。
18+
19+
## 二、导入第三方或内部 Agent Pack
20+
21+
1. 准备一个包含 `nova.industry.json` 的 Pack 文件夹。
22+
2. 在 Agent 中心点击“导入 Agent Pack”。
23+
3. 选择文件夹并阅读系统确认说明。
24+
4. NOVA 只复制 JSON、Markdown、YAML、TXT 等声明文件，不执行包内代码，也不自动授予权限。
25+
5. 打开“查看结构”，核对角色、流程、交付模板和外部动作声明。
26+
6. 手动启用；先用一个非敏感工作区完成小规模验收，再进入真实业务。
27+
28+
## 三、新行业落地的标准路径
29+
30+
| 阶段 | 需要回答的问题 | 必须留下的产物 | 通过标准 |
31+
|---|---|---|---|
32+
| 1. 业务聚焦 | 谁付费、最耗时的工作是什么 | 行业任务清单 | 先选 1 个高频、可验收任务 |
33+
| 2. 结果定义 | 用户最终拿什么继续工作 | 交付模板 | 不是泛泛回答，而是文件/表格/决策 |
34+
| 3. 角色拆分 | 哪些判断需要不同专业视角 | Agent roster | 每个角色有输入、输出和边界 |
35+
| 4. 流程固化 | 哪些步骤可并行、依赖什么 | Workflow JSON | 每步有 owner、output、acceptance |
36+
| 5. 证据治理 | 哪些是事实、推断、未知项 | Knowledge 与证据规则 | 易变化事实必须带来源和日期 |
37+
| 6. 权限声明 | 会访问哪些外部系统 | Manifest 权限表 | 默认无权限，外部动作逐类确认 |
38+
| 7. 真实测试 | 什么案例能证明有价值 | Evaluation cases | 至少 5 个真实案例可重复验收 |
39+
| 8. 小范围发布 | 谁先试、如何收集反馈 | 验收报告 | 完成率、耗时、返工率可衡量 |
40+
41+
## 四、建议的产品组合
42+
43+
```text
44+
NOVA AgentOS
45+
├─ 通用 Threadspace、任务、权限、预算、恢复、证据
46+
├─ Agent Pack（行业方法与交付责任）
47+
│ ├─ 跨境电商
48+
│ ├─ 制造业询报价
49+
│ ├─ 外贸客户开发
50+
│ └─ 售后与知识运营
51+
├─ MCP（连接平台、数据和服务）
52+
├─ Skills（可复用操作方法）
53+
└─ Model Providers（DeepSeek / OpenAI / Kimi / Ollama / Custom）
54+
```
55+
56+
Agent Pack 回答“这项业务该怎样完成并验收”；MCP 回答“能连接什么”；Skill 回答“某个动作怎样重复执行”；模型负责推理生成；AgentOS 负责边界、调度、落盘和证据。四层不混在一起，后续扩展才不会重写主程序。
57+
58+
## 五、跨境电商 Agent v0.3 的实际能力
59+
60+
装载 `NOVA 跨境商品决策 Agent` 后，模型会额外获得四个只读、确定性领域工具；切回
61+
通用 NOVA 后这些工具不会出现在模型工具清单中：
62+
63+
1. `commerce_normalize_product_passport`：建立商品身份档案，强制分离事实、假设和未知项。
64+
2. `commerce_calculate_landed_profit`：计算关税、进口税、平台费、支付费、达人佣金、广告、退货后的贡献利润与盈亏平衡 ROAS。
65+
3. `commerce_build_evidence_ledger`：检查来源、日期、置信度、过期证据和冲突值。
66+
4. `commerce_assess_market_demand`：从需求、竞争、差异化、本地适配、内容表现与风险等非财务维度形成证据加权判断，并输出下一步验证建议。
67+
68+
推荐操作顺序：选择工作区 → 装载跨境 Agent → 按启动引导补充商品线索、图片、市场和平台 → 中立识别商品 →
69+
研究需求与竞争 → 形成需求适配判断 → 条件允许时补充利润与履约 → 设计最小市场验证。成果区会先显示建议和关键
70+
指标，完整说明及真实落盘文件在下方展开；外部发布、投放、账号访问与购买仍需单独授权。
71+
72+
## 六、行业包质量回归（开发者）
73+
74+
每个行业 Pack 用 3 组任务做内部回归：资料完整、资料有限、存在冲突。记录首次可用结果耗时、人工补充次数、真实文件数、关键事实有来源的比例、返工次数和最终是否可直接用于下一业务动作。这个过程属于开发质量保障，不作为用户界面的独立模块。任何“完成”都必须能找到对应交付物或明确说明为什么只能得到条件性结果。

‎AGENT-PACK-SDK.md‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# NOVA Agent Pack SDK v1
2+
3+
Agent Pack 是声明式专业能力包，不包含或暴露 NOVA 核心源码。它向 AgentOS 提供行业任务章程、角色、工作流、知识边界、交付模板和评测，不得绕过工作区、权限、预算、恢复和 Proof-of-Done。
4+
5+
## 目录约定
6+
7+
```text
8+
my-agent-pack/
9+
├─ nova.industry.json
10+
├─ agent-card.json
11+
├─ certification.json
12+
├─ INDUSTRY_CHARTER.md
13+
├─ agents/AGENT_ROSTER.md
14+
├─ workflows/entry-workflow.json
15+
├─ delivery-templates/result.md
16+
├─ knowledge/
17+
└─ evaluations/
18+
```
19+
20+
复制 `industry-packs/_template` 后，把 `nova.industry.example.json` 重命名为 `nova.industry.json`。Manifest 可使用 `industry-packs/nova.industry.schema.json` 校验。
21+
22+
也可以在 Electron 客户端进入 **扩展坞 → Agents → 创建 Agent**。Agent 工坊会按照 [NOVA Agent Creation Standard 1.0](NOVA-AGENT-CREATION-STANDARD.md) 生成完整 Pack、五类基础评测和持久化体检报告；新 Agent 默认停用，必须检查后手动启用。
23+
24+
## 运行契约
25+
26+
- `id` 必须稳定、全小写，并采用反向域名风格，例如 `nova.manufacturing-rfq`。
27+
- 一个 Pack 必须有清晰的客户、任务边界和可检查交付物。
28+
- Workflow 的每一步必须声明 `agent`、`outputs` 和 `acceptance`。
29+
- 建议声明 `onboarding` v1。NOVA 会把 `steps` 统一渲染为文本、选择或附件输入，把用户选择代入 `outcomes[].promptTemplate`，形成第一轮任务。
30+
- 启动引导不只列“需要什么”，还必须用 `whyItMatters` 说明资料如何影响判断，并用 `example` 告诉新用户怎样收集。
31+
- `promptTemplate` 使用 `{{step-id}}` 引用输入；附件步骤会替换为已附文件名。必填项未完成时 AgentOS 不允许启动该目标。
32+
- Pack 知识只作为任务指导；价格、政策、库存、平台规则等易变化事实仍需实时验证。
33+
- Pack 可以请求 MCP、Skill 或 A2A 能力，但不能假定它们已经安装或获得授权。
34+
- 建议使用 `capabilityRequirements` v1 声明运行前需要或可选的 MCP/Skill。AgentOS 会检查已启用、已注册但停用、内置可加载和缺失四种状态；缺失 MCP 可进入统一接入器。
35+
- 统一 MCP 接入器接受 HTTPS 地址、`mcpServers` JSON，以及 Codex 风格 TOML。它只预览并净化配置，明文密钥不会被复制，连接导入后默认停用，必须由用户再次启用。
36+
- `matchIds` 应包含官方名称与常见配置名；内置市场能力可额外填写 `catalogId`。第三方网上配置不需要 NOVA 预先收录，用户可粘贴或在授权后扫描本机已有配置。
37+
- 外部发布、投放、账号访问、购买、付款、删除和桌面控制必须在 Manifest 中声明，并由 AgentOS 独立审批。
38+
- v1 只允许声明文件，不执行 Pack 内脚本、二进制、依赖安装或任意代码。
39+
40+
## 能力需求示例
41+
42+
```json
43+
{
44+
"capabilityRequirements": {
45+
"version": "1.0",
46+
"items": [
47+
{
48+
"id": "marketplace-account-data",
49+
"kind": "mcp",
50+
"name": "平台官方 MCP",
51+
"reason": "获得用户授权后读取真实账号数据。",
52+
"required": false,
53+
"matchIds": ["platform-official", "platform-mcp"],
54+
"catalogId": "platform-official"
55+
}
56+
]
57+
}
58+
}
59+
```
60+
61+
不要在 Pack、URL、JSON、TOML、说明文档或示例中提交真实 Token。配置只引用环境变量名；OAuth MCP 由其官方授权流程完成。
62+
63+
## 版本与兼容
64+
65+
- 修改描述或非契约知识：Patch。
66+
- 增加兼容角色、步骤或模板：Minor。
67+
- 更改交付字段、权限或主工作流：Major。
68+
- `novaCompatibility` 声明可运行的 AgentOS 版本范围。
69+
- 已发布 Pack 不在原目录静默覆盖；升级必须保留版本记录并重新验收。
70+
71+
## 发布闸门
72+
73+
发布前必须满足：Manifest 可解析；路径不越界；没有密钥、个人数据或可执行文件；至少一个入口工作流；角色与步骤一一对应；交付模板可直接使用；外部动作已声明；五个真实评测中没有伪造来源、伪造完成或越权动作。

0 commit comments

Comments
 (0)