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/ 目录。