AI Context

AI Context Skill — 上下文索引自维护

zzyong24 4734e64 4 files · 28.3 KB Updated

File contents

AI Context Skill — 上下文索引自维护

功能概述

自动更新 vault/ai-context/ 下的索引文件,确保 AI 上下文索引与知识库实际内容保持同步。

工具清单

工具 说明
update_ai_context(section) 更新 AI 上下文索引文件(纯 IO 工具)

设计原则

这是一个纯 IO 工具,不走 Tool → AI → Tool 模式:

  • 扫描文件系统 → 计算统计数据 → 直接写入 Markdown
  • 只更新统计数据和路径信息,不生成需要 AI 理解的内容
  • profile.md 的手写内容(静态区)绝不覆盖

参数说明

section 行为
profile 只更新 profile.md 的 DYNAMIC_START / DYNAMIC_END 之间的内容
vault-map 重新扫描 vault 目录结构,重新生成 vault-map.md
scenes 校验场景文件中引用的路径是否仍然存在,返回失效列表
all 执行以上全部操作

静态/动态分区机制

profile.md 使用 HTML 注释标记分区:

  • <!-- STATIC_START --> ... <!-- STATIC_END -->:手动维护区域,工具不碰
  • <!-- DYNAMIC_START --> ... <!-- DYNAMIC_END -->:工具自动覆盖更新

数据来源

  • 文件统计:遍历 space/flux/ 目录,复用 ItemManager.stats()
  • 平台数据:读取 crafted/tracker/ 最新文件的 Frontmatter
  • 最近关注方向:读取最近反思和文章的标题/topic
  • 目录树:遍历 space/crafted/space/found/ 生成树形结构

输出位置

所有更新写入 vault/ai-context/ 目录。

zzyong24/thirdspace-pub/tree/main/skills/ai-context commit 4734e64726

Frequently asked questions

npx skillmds@latest add zzyong24/ai-context