init-knowledge-base AGENTS.md

AGENTS.md — init-knowledge-base

本文件供 AI Coding Agent 阅读。项目语言为简体中文。

---

项目概述

init-knowledge-base 是一个 Kimi Code CLI Project Skill，用于一键初始化标准化的 Obsidian 知识库（Vault）项目骨架。

• 灵感来源：Andrej Karpathy 的 LLM Wiki 规范
• 核心理念：将碎片化信息编译成结构化、高度相互链接的知识网络
• 使用场景：用户在 Kimi Code CLI 中输入 /init-vault <名称> 或自然语言"新建知识库"时，Skill 将 _templates/ 下的所有模板文件复制到目标目录，生成完整的 Obsidian Vault 结构

注意：本项目本身不是传统软件项目，没有 package.json、pyproject.toml、Cargo.toml 等构建配置文件，也没有编译或打包步骤。它是一个纯模板与配置仓库，依赖 Markdown、CSS、JSON 和 Kimi Code CLI 的 Skill 系统运行。

---

技术栈与运行时架构

层级	技术	说明
AI 运行时	Kimi Code CLI	Skill 的加载与执行环境
知识库客户端	Obsidian（桌面端）	用户主要的阅读与编辑界面
数据查询	Dataview（Obsidian 社区插件）	wiki/index.md 动态仪表盘依赖此插件
模板引擎	Templater（Obsidian 社区插件）	templates/ 目录下的 4 个模板由其解析
样式	CSS Snippets	.obsidian/snippets/ 下的 3 个 CSS 文件
版本控制	Git	仅追踪配置与内容，排除插件二进制文件

运行时架构

用户通过 Kimi Code CLI 触发 /init-vault
        ↓
CLI 读取本项目的 SKILL.md
        ↓
按 SKILL.md 定义的"生成流水线"，将 _templates/ 复制到用户指定目录
        ↓
生成的 Vault 包含：Obsidian 配置 + CSS 样式 + 模板 + 5 个 Agent Skills
        ↓
用户在 Obsidian 中打开 Vault，使用 /ingest、/query、/lint、/canvas 命令与 AI 交互

---

目录结构与模块划分

项目根目录/
├── SKILL.md                          # Skill 定义与生成流水线（Kimi Code CLI 入口）
├── README.md                         # 面向人类用户的项目说明
├── LICENSE                           # MIT 许可证
├── AGENTS.md                         # 本文件
└── _templates/                       # 所有模板文件，初始化时复制到目标项目
    ├── README.md                     # 生成的 Vault 的 README（含 {vault_name} 占位符）
    ├── CLAUDE.md                     # Agent 行为契约与规范（原样复制）
    ├── OBSIDIAN_SETUP.md             # Obsidian 配置指南（原样复制）
    ├── .gitignore                    # 忽略规则（原样复制）
    ├── .obsidian/                    # Obsidian 统一配置
    │   ├── app.json                  # 编辑器设置（新文件位置、附件路径、显示选项等）
    │   ├── appearance.json           # 外观 + 启用的 CSS 片段清单
    │   ├── core-plugins.json         # 核心插件开关列表
    │   ├── community-plugins.json    # 推荐社区插件列表（dataview, templater 等）
    │   └── snippets/                 # CSS 样式片段
    │       ├── wiki-reading.css      # 阅读排版优化
    │       ├── wiki-callouts.css     # Callout 语义化颜色 + 左侧边条
    │       └── wiki-components.css   # 双链、外部链接、标签、图片、代码块增强
    ├── templates/                    # Templater 模板文件夹
    │   ├── entity.md                 # 实体模板（人物、公司、工具、产品）
    │   ├── concept.md                # 概念模板（框架、方法论）
    │   ├── source.md                 # 来源摘要模板
    │   └── synthesis.md              # 综合分析模板
    ├── wiki/                         # 知识编译输出层骨架
    │   ├── index.md                  # Dataview 动态仪表盘（全局内容字典）
    │   ├── log.md                    # 操作日志（Append-only）
    │   └── mocs/                     # 主题地图（Map of Contents）
    │       ├── README.md             # MOC 创建指南与 Dataview 查询模板
    │       ├── MOC-技术.md           # 技术领域 MOC
    │       ├── MOC-商业.md           # 商业领域 MOC
    │       ├── MOC-人物.md           # 人物与机构 MOC
    │       └── MOC-待整理.md         # 草稿与待分类 MOC
    └── .claude/                      # Agent Skills
        └── skills/
            ├── ingest/SKILL.md       # 将 raw/ 资料编译到 wiki/
            ├── query/SKILL.md        # 在知识库中搜索与回答
            ├── lint/SKILL.md         # 检查死链、孤儿页面、逻辑冲突
            ├── obsidian-markdown/SKILL.md  # Obsidian Markdown 语法规范
            └── json-canvas/SKILL.md  # Canvas 可视化与知识图谱