MarioJames 全局项目知识图谱
线上入口固定为：
viking://user/resources/projects/RELATIONS.md
viking://user/resources/projects/MEMORY.md
viking://user/resources/projects/repos/<project-id>/
通过运行时已注册的 OpenViking find / search / read / glob / grep / edit / write 工具工作。不要调用本地 ov CLI、直连 HTTP 或重建数据库客户端；viking://user/... 是当前用户别名，不硬编码实际 user id。
定位当前项目
- 在当前 Git 根目录读取
remote.origin.url，优先用完整 remote 在RELATIONS.md精确匹配稳定<project-id>。同一 remote 的多个本地路径属于同一项目。 - remote 缺失时，再用当前绝对路径或明确仓库名在
RELATIONS.md匹配。路径只是按 peer 记录的位置，不是项目身份；不要从父目录名称推断归属。 - 同名仓库必须用 remote、项目 ID 或精确路径消歧。仍有多个合理结果时说明歧义并询问，不合并事实。
- 定位后把查询限定到
viking://user/resources/projects/repos/<project-id>/。不要查找或依赖工作空间根的AGENTS.md、CLAUDE.md、MEMORY.md或.workspace。
查询
- 本技能处理项目知识时，事实源白名单只有
viking://user/resources/projects/（服务端展开实际 user id 后的同一路径也等价）。不要补读memories/、旧resources/workspaces/或其他 OpenViking 目录；运行时自动注入的召回摘要只用于判断是否触发本技能，不引用其中事实，也不展开其 URI。 - 仓库结构、常用操作和项目技能读
graph.md；业务域读domains.md；共享机制和技术边界读knowledge.md；存在entities.md时用于稳定实体定义。 - 项目身份、本机路径和跨项目依赖只查
RELATIONS.md。用项目 ID、完整 remote、路径或 relation ID 做grep，语义不确定时再用限定到projects/的find。 - 续接、纠正、确认取舍或用户外部操作查
MEMORY.md，用项目 ID 和任务关键词缩小结果。 - 仓库内部问题先在该项目 URI 下
find；不足时用search(mode="list", target_uri=项目 URI)。search(mode="context")不支持target_uri，只在确需跨项目上下文时使用。 projects/内的召回结果只用于筛选。选择 1–3 个最相关的规范文件 URI，用read核对原文后再行动；忽略.abstract.md、.overview.md等派生索引。
权威与边界
- 权威顺序：当前用户指令与当前代码、配置、Git/PR/CI、外部实时状态 >
repos/<project-id>/与RELATIONS.md的稳定事实 >MEMORY.md的历史上下文。 - 仓库自身的
AGENTS.md和项目技能仍是执行规范，线上项目知识不覆盖它们。 RELATIONS.md独占项目 ID、remote、路径、别名和跨项目关系；单仓文件不得复制这些内容。repos/<project-id>/只保存该仓库自身的图谱、实体、领域和共享知识；跨仓边只写RELATIONS.md。MEMORY.md只保存会影响后续工作的跨项目决策、路径迁移、用户外部操作和接续，不复制稳定实现事实。- 项目历史只以这里的
MEMORY.md为入口；即使通用记忆中存在同名项目实体或旧迁移记录，也不并入答案，避免新旧模型混用。 - 查询依赖召回与 grep，不为渐进式披露预建深层目录；只有权威边界、文件过大或实际并发编辑冲突才拆文件。
- 只读问答、审查或定位不写线上资源。不把凭证、token、账号、个人隐私、
.env、原始会话日志、临时 ID 或未提炼流水账写入项目知识。
维护
先 read 当前规范文件，再用 edit 做唯一匹配的最小修改并设置 wait=true；新增文件用 write(mode="create", wait=true)。只有核对完整旧内容或执行明确迁移时才用 write(mode="replace")。
更新后至少完成：
read精确 URI 验证正文；- 在
projects/或具体项目 URI 下用find/grep验证新事实可召回； - 检查同一关系、路径或仓库事实没有在全局文件与单仓文件重复；
- 说明写入的 URI，以及仍需以当前代码复核的易漂移信息。
线上文件职责见 references/online-layout.md。
故障与陷阱
- OpenViking 工具未注册或不可用时，明确说明线上项目上下文不可达；不要改用本地 CLI、HTTP、旧本地快照或自动记忆摘要冒充规范资源。
- 新写入的语义索引可能异步刷新；需要当场验收时使用
wait=true，超时后先read精确 URI 判断是否已写入，不要盲目重复创建。 - 工具返回的规范 URI 可能展开为
viking://user/<id>/...；后续调用继续使用当前用户别名，不把实际 user id 写进技能或配置。 - 目录级
.abstract.md/.overview.md是派生索引，不是事实源；派生内容异常时先读规范文件，不能用错误摘要覆盖正文。