Agent Skills: Knowledge Base Skill

Knowledge Base Skill

概述

外部知识库读取技能，用于加载项目文档、开发规范、公司要求等外部知识，在开发流程中按需调取。

知识库类型

1. 项目文档

路径: .knowledge/project/
内容:
  - 项目背景介绍
  - 业务领域说明
  - 系统架构文档
  - API 文档
  - 数据字典

2. 开发规范

路径: .knowledge/standards/
内容:
  - 代码规范 (命名、格式、注释)
  - Git 提交规范
  - 代码审查标准
  - 测试规范
  - 文档规范

3. 公司要求

路径: .knowledge/company/
内容:
  - 安全合规要求
  - 隐私保护规范
  - 性能标准
  - 可访问性要求
  - 国际化要求

4. 技术栈文档

路径: .knowledge/tech/
内容:
  - 框架使用指南
  - 第三方库文档
  - 内部工具使用
  - 环境配置说明

知识库结构

.knowledge/
├── index.md                 # 知识库索引 (必需)
├── project/
│   ├── overview.md          # 项目概览
│   ├── architecture.md      # 系统架构
│   ├── api/                 # API 文档
│   └── data-dict.md         # 数据字典
├── standards/
│   ├── code-style.md        # 代码规范
│   ├── git-convention.md    # Git 规范
│   ├── review-checklist.md  # 审查清单
│   └── testing.md           # 测试规范
├── company/
│   ├── security.md          # 安全要求
│   ├── privacy.md           # 隐私规范
│   └── compliance.md        # 合规要求
└── tech/
    ├── framework.md         # 框架指南
    └── tools.md             # 工具使用

索引文件格式 (index.md)

# 知识库索引

## 项目文档
| 文件 | 描述 | 关键词 |
|:---|:---|:---|
| project/overview.md | 项目概览 | 背景, 目标, 范围 |
| project/architecture.md | 系统架构 | 架构, 模块, 组件 |

## 开发规范
| 文件 | 描述 | 关键词 |
|:---|:---|:---|
| standards/code-style.md | 代码规范 | 命名, 格式, 风格 |
| standards/git-convention.md | Git规范 | 提交, 分支, 合并 |

## 公司要求
| 文件 | 描述 | 关键词 |
|:---|:---|:---|
| company/security.md | 安全要求 | 安全, 加密, 认证 |

## 技术栈
| 文件 | 描述 | 关键词 |
|:---|:---|:---|
| tech/framework.md | 框架指南 | React, Node, 框架 |

调用时机

自动调用

需求分析阶段:
  - 加载 project/overview.md (理解项目背景)
  - 加载相关业务文档

方案设计阶段:
  - 加载 project/architecture.md (理解现有架构)
  - 加载 tech/*.md (技术栈约束)

开发实施阶段:
  - 加载 standards/code-style.md (代码规范)
  - 加载 company/security.md (安全要求)

代码审查阶段:
  - 加载 standards/review-checklist.md (审查清单)

手动调用

# 加载特定知识
/vibe-kb load project/architecture.md

# 搜索知识库
/vibe-kb search "认证相关"

# 列出所有知识
/vibe-kb list

MCP 集成

// 使用 sou 搜索知识库
sou_search({
  query: "用户认证相关规范",
  scope: ".knowledge/",
  limit: 5
})

// 使用 memory 缓存常用知识
memory_store({
  category: "knowledge_cache",
  title: "代码规范摘要",
  content: "...",
  tags: ["standards", "code-style"]
})

使用示例

需求分析时

1. 读取 .knowledge/index.md
2. 根据需求关键词匹配相关文档
3. 加载匹配的文档到上下文
4. 结合知识库理解需求

示例输出:
  "根据项目架构文档，该功能应在 auth 模块实现..."
  "根据安全规范，密码必须使用 bcrypt 加密..."

代码编写时

1. 自动加载代码规范
2. 检查公司安全要求
3. 参考技术栈文档

约束示例:
  - 命名使用 camelCase
  - 函数不超过 50 行
  - 必须有错误处理
  - 敏感数据必须加密

知识库维护

更新知识

# 添加新知识文档
创建文件 → 更新 index.md → 添加关键词

# 更新现有知识
修改文件 → 更新 index.md 中的描述/关键词

最佳实践

结构清晰:
  - 按类型分目录
  - 文件名有意义
  - 必须有 index.md

内容规范:
  - 使用 Markdown 格式
  - 包含实际示例
  - 保持更新

关键词准确:
  - 便于检索匹配
  - 覆盖主要概念

降级策略

若 .knowledge/ 不存在:
  1. 使用 references/ 目录作为备选
  2. 使用 memory MCP 查询历史知识
  3. 提示用户创建知识库

若特定文档不存在:
  1. 记录缺失
  2. 继续使用通用规范
  3. 建议补充文档

配置

# orchestrator.yaml
knowledge_base:
  enabled: true
  path: .knowledge/
  index: index.md
  auto_load:
    - standards/code-style.md
    - company/security.md
  search_engine: sou  # 或 grep