🎒 新 Agent 上岗指南

任何新 Agent（Hermes / Claude / Antigravity / 本地 coding agent）上岗前必读。 目标：让新 Agent 最快掌握 Sozo 的知识体系 + 权限 + 沉淀规则，不需要 Sozo 一个个回想该装什么 skill。换电脑 / 换 Agent / 换环境，读完本指南即可 catch up。

🗺️ 0. 知识体系总览（先看这张图）

graph TD
    VAULT["📓 Obsidian Vault（共享知识库）<br/>Google Drive 同步"]
    INDEX["KNOWLEDGE_INDEX.md<br/>📍 总索引（入口）"]
    COMPANY["HS Design/Company_Graph.md<br/>🏢 公司业务总路由"]
    AGENTS["agents/MultiAgent_Graph.md<br/>🤖 多Agent拓扑"]
    CRED["env/Credentials_Graph.md<br/>🔐 凭据去向表"]
    SYNC["system/KnowledgeSync_Graph.md<br/>📚 知识沉淀体系"]
    PROJ["projects/ 项目文档"]
    USER["user/profile.md 用户档案"]

    VAULT --> INDEX
    INDEX --> COMPANY
    INDEX --> AGENTS
    INDEX --> CRED
    INDEX --> SYNC
    INDEX --> PROJ
    INDEX --> USER

📖 1. 必读清单（按顺序）

#	文件	看完获得
1	`KNOWLEDGE_INDEX.md`	vault 全貌、去哪找什么
2	`user/profile.md`	Sozo 是谁、偏好、语言
3	`FOR-PC-AGENTS.md`	vault 访问方式（Drive 链接）
4	`HS Design/Company_Graph.md`	公司业务图谱总路由
5	`agents/MultiAgent_Graph.md`	多 Agent 拓扑（谁在哪）
6	`env/Credentials_Graph.md`	🔐 凭据去哪找（不存值）
7	`system/KnowledgeSync_Graph.md`	知识沉淀体系
8	`convention/*.md`	操作规范

读取与检索方式（双轨最佳实践）：

🚀 【云端 / 新 Agent / 轻量端推荐】Cloudflare D1 vault-rag 极速直连（0.1ms 响应，免装 DriveFS / 免配 Google 凭据）：
- 数据库：vault-rag（UUID: f0c8bc02-c396-4fb8-9781-5a18a8d8a90c）
- 查询示例：wrangler d1 execute vault-rag --remote --command "SELECT content FROM chunks WHERE content LIKE '%...%'"
- 优势：新 Agent 无需安装 Google Drive for Desktop（DriveFS），无 Google OAuth 配置门槛，毫秒级跨 279+ 文档段落语义检索。
💻 【本地主机 / 重度编写推荐】本地物理磁盘挂载（原始 Markdown 母本）：
- 路径：<盘符>:\我的云端硬盘\Jakephone\Obsidian Vault\（或物理 D 盘镜像）
- 优势：拥有秒级最新的原始 Markdown 读写权限，作为全系统单一真相源（Single Source of Truth）。
🌐 【后备/跨机下载】：
- Google Drive API：google_api.py drive get <FILE_ID>
- Vault 根目录：https://drive.google.com/drive/folders/1jR76SbioF1u2H-hqca-TejjJ1_d4KDOI

🛠️ 2. 必备 Skill 清单

🔴 核心（必须装）

Skill	作用	对应能力
google-workspace	Gmail/Sheets/Drive/Docs 全权限	读客户/写报价/查项目
obsidian	共享知识库读写	记知识/查历史/沉淀
hsdesign-quotation-system	报价系统	开报价/查 Item 库
hsdesign-customer-followup	客户跟进	Master DB 主档/跟进
hsdesign-work-schedule	工程排期	甘特表/工序
hsdesign-company-graph	公司图谱	业务导航

🟡 常用（按需）

Skill / MCP	用途	对应能力
cloudflare (全套13项)	Cloudflare 官方 Skills 库 (`D:\ida ceo\.agents\skills\cloudflare`)	Workers, D1, KV, R2, Wrangler, Turnstile, Web-perf 官方标准
cloudflare-docs (MCP)	官方文档实时检索 (`https://docs.mcp.cloudflare.com/mcp`)	实时语法查询，杜绝过时 API 代码
cloudflare-bindings (MCP)	D1 / KV / R2 数据库直联 (`https://bindings.mcp.cloudflare.com/mcp`)	云端数据库实时读写与运维
cloudflare-builds (MCP)	Pages/Workers 构建与监控 (`https://builds.mcp.cloudflare.com/mcp`)	部署状态实时轮询
cloudflare-observability (MCP)	边缘日志与观测 (`https://observability.mcp.cloudflare.com/mcp`)	Edge 实时日志排错与自愈
google-workspace	Gmail/Sheets/Drive/Docs 全权限	读客户/写报价/查项目
bukku-api-access	账务	财务发票与 Maybank 对账
tuya-smartlife-control	智能家居	Tuya IoT 设备控制
sozo-todo-manager	跨 agent 待办	任务交接与待办管理

🟢 专业（有项目再用）

pdf/docx/xlsx/powerpoint（文档）、airtable/notion/linear（工具）、github-（Git 流程）、youtube-（媒体）、dspy/axolotl（ML）等——见 KNOWLEDGE_INDEX 完整列表。

💡 原则：核心 6 个 skill 是任何 agent 的”上岗证”；其余按任务加载。

🔑 3. 权限地图（能访问什么）

资源	访问方式	权限
Obsidian Vault	Drive 挂载/API	✅ 读写（知识库）
Google Sheets（Master/报价/跟进）	google-workspace skill	✅ 读写
Google Drive 04-Projects	google-workspace skill	✅ 读写
Gmail	google-workspace skill	✅ 读/发
Cloudflare（网站/SaaS）	cloudflare-pages-deploy skill	✅ 部署
Tuya 智能家居	tuya skill（IP 白名单）	✅ 控制
IDA PC	winrm skill（密码010157）	✅ 远程
凭据明文	`env/Credentials_Graph.md` 指向	⚠️ 去对应位置

权限扩大：遇到权限不足 → 查 env/Credentials_Graph.md 找凭据位置 → 用对应 skill 配置 → 必要时找 Sozo 授权。

📝 4. 知识沉淀规则（做什么都记下来）

每次完成重要工作，必须沉淀到 vault：

内容	写到哪
新决定/决策	`decisions/decision-log.md`
新工具/环境发现	`env/<topic>.md`
重复工作流	`skills/<skill>.md`
每日亮点	`daily/YYYY-MM-DD.md`
新系统/新资产	建图谱 → 挂进 Company_Graph
新凭据	登记到 Credentials_Graph（不存值）
用户偏好	`user/profile.md`

⚠️ 铁律：

做任何事都要”留痕”（记到 vault），这是多 agent 环境生存基础
不要直接 Edit KNOWLEDGE_INDEX.md / FOR-PC-AGENTS.md（多 agent 冲突）
绝对路径加 [SozoPC] / [IDAPC] / [MSIPC] 标签
写 H 盘（Google Drive）不可靠 → 先写本地 → cp → 验证字节数

⚡ 5. 快速 Catch-up 流程（换 Agent/换电脑）

新 Agent 上岗 30 分钟流程：
1. 读 KNOWLEDGE_INDEX.md（5 min）→ 全貌
2. 读 user/profile.md + FOR-PC-AGENTS.md（5 min）→ 用户 + 访问
3. 读 Company_Graph + MultiAgent_Graph（5 min）→ 业务 + 拓扑
4. 读 Credentials_Graph（5 min）→ 凭据去向
5. 装 6 个核心 skill（5 min）
6. 跑一次 google-workspace 读 Master DB（验证权限）（5 min）
→ 上岗完成，可处理任务

📎 6. 相关

KNOWLEDGE_INDEX — vault 总索引
FOR-PC-AGENTS — 跨机器读取指南
MultiAgent_Graph — 多 Agent 拓扑
Company_Graph — 公司业务图谱
Credentials_Graph — 凭据去向
KnowledgeSync_Graph — 知识沉淀体系
sozo-setup — 原始拓扑（部分过时）

维护：skill 清单/权限变化时更新。新 Agent 上岗前先读本文件。

HS Knowledge Vault

探索

新 Agent 上岗指南（Onboarding Guide）