mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-04-21 13:30:48 +08:00
P0 结构性修复: - update-agent 阶段 5 统一为 HTTP API,移除所有 Git 操作示例 - create-agent 响应格式与实际 API 对齐 - delete-agent 合并"前置检查"与"错误处理" P1 一致性修复: - 统一 frontmatter 字段顺序、tags 英文化 - 提取 AgentFS 背景知识到共享 _agentfs-background.md - 受保护路径统一引用 _protected-paths.yaml P2 缺失补充: - discover-agent 补充"了解更多"API 实现 - update-agent 新增 Persona 修改示例 - create-agent 补充"修改"分支交互流程 - delete-agent 补充停止 Agent 方式 P3 精简优化: - 精简版本回滚、删除范围、匹配算法描述 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
AgentFS 背景知识(共享)
此文件由 create-agent、update-agent 等元技能共享引用。 以下信息仅供 Agent 内部理解,不要向用户展示。
AgentFS v2 仓库结构
每个 Agent 的仓库遵循 AgentFS v2 扁平结构:
<agent_id>/
├── agent.json # 元数据与运行时配置
├── persona.md # 人格定义(L0/L1/L2)
├── principles.md # 行为原则(L0/L1/L2)
├── memory/ # 记忆目录
├── skills/ # 技能目录
├── tools/ # 工具目录
└── heartbeat/ # 心跳配置
关键文件说明
| 文件 | 验证 API | 常见问题 |
|---|---|---|
agent.json |
GET /api/agents/:id 返回完整配置 |
engine 字段缺失导致无法启动 |
persona.md |
GET /api/agents/:id/persona 返回结构化数据 |
L0 为空则 Agent 无身份摘要 |
principles.md |
GET /api/agents/:id/principles 返回结构化数据 |
must_not 为空则无安全红线 |
memory/ |
目录存在即可 | _policy.json 缺失会使用默认策略 |
受保护路径
详见 _protected-paths.yaml。核心规则:
persona.mdL0 section — block(核心身份,不可自动修改)principles.md"绝不做" section — block(安全红线,需人类显式修改)agent.jsonaccess_control / privacy — owner_only(需 owner 确认)tools/permissions / credentials — owner_only / block(敏感操作)