# AI Context

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

- Skill: `zzyong24/ai-context` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add zzyong24/ai-context`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zzyong24/ai-context/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zzyong24 (https://skillmd.com/u/zzyong24)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zzyong24/ai-context

---

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