调用关系

用户: /knowledge scan
   ↓
ys:project-knowledge
   ↓
   ├── ys:domain-explorer (/domain scan)
   │    ├── entities
   │    ├── apis
   │    ├── flows
   │    ├── deps
   │    └── glossary
   │
   └── ys:architecture-explorer (/arch scan)
        ├── overview
        ├── structure
        ├── tech
        └── deploy

各命令实现

/knowledge scan - 扫描全部

执行步骤：

检查项目根目录
执行 domain-explorer 扫描
执行 architecture-explorer 扫描
更新 CLAUDE.md 导航
输出总结

输出目录结构：

.claude/
├── domain/
│   ├── entities.md          # 业务实体
│   ├── apis.md              # API 接口
│   ├── flows.md             # 业务流程
│   ├── dependencies.md      # 服务依赖
│   └── glossary.md          # 术语表
├── architecture/
│   ├── overview.md          # 系统概览
│   ├── structure.md         # 项目结构
│   ├── tech-stack.md        # 技术栈
│   └── deploy.md            # 部署架构
├── rules/
│   └── README.md            # 业务规则
└── CLAUDE.md                # 项目总览（含导航）

/knowledge update - 更新知识库

执行步骤：

检查已存在的知识库文件
对比哪些文件需要更新
重新扫描需要更新的部分
更新文件

/knowledge status - 查看状态

执行步骤：

检查 .claude/ 目录是否存在
列出已生成的文件
显示每个文件的信息（大小、更新时间）

输出格式：

📚 项目知识库状态

✅ 已生成的文件：
  - domain/entities.md   (更新于 2024-01-15 10:30)
  - domain/apis.md      (更新于 2024-01-15 10:30)
  - domain/flows.md     (更新于 2024-01-15 10:31)
  - domain/dependencies.md (更新于 2024-01-15 10:31)
  - domain/glossary.md  (更新于 2024-01-15 10:32)
  - architecture/overview.md (更新于 2024-01-15 10:33)
  - architecture/structure.md (更新于 2024-01-15 10:33)
  - architecture/tech-stack.md (更新于 2024-01-15 10:34)
  - architecture/deploy.md (更新于 2024-01-15 10:34)

📊 统计：
  - 实体: 8 个
  - API: 12 个
  - 流程: 3 个
  - 依赖: 5 个
  - 术语: 10 个

/knowledge clean - 清理并重新生成

执行步骤：

询问用户确认（需要二次确认）
删除 .claude/domain/ 目录
删除 .claude/architecture/ 目录
执行 /knowledge scan 重新生成

CLAUDE.md 整合

生成的 .claude/CLAUDE.md 自动包含知识库导航：

## 📚 项目知识库

- [业务领域](./domain/)
  - [实体](./domain/entities.md)
  - [API](./domain/apis.md)
  - [流程](./domain/flows.md)
  - [依赖](./domain/dependencies.md)
  - [术语](./domain/glossary.md)
- [架构](./architecture/)
  - [概览](./architecture/overview.md)
  - [结构](./architecture/structure.md)
  - [技术栈](./architecture/tech-stack.md)
  - [部署](./architecture/deploy.md)
- [规则](./rules/)

输出示例

/knowledge scan

📦 步骤 1/5: 初始化
✓ 检查项目目录
✓ 创建 .claude/ 目录

📦 步骤 2/5: 扫描业务领域知识
✓ domain-explorer 已调用
✓ 扫描实体 (8 个)
✓ 扫描 API (12 个)
✓ 扫描流程 (3 个)
✓ 扫描依赖 (5 个)
✓ 扫描术语 (10 个)

📦 步骤 3/5: 扫描架构信息
✓ architecture-explorer 已调用
✓ 扫描概览
✓ 扫描结构
✓ 扫描技术栈
✓ 扫描部署

📦 步骤 4/5: 生成规则文档
✓ 生成 .claude/rules/README.md

📦 步骤 5/5: 更新 CLAUDE.md
✓ 更新项目总览导航

✅ 扫描完成！生成文件：
  📁 .claude/domain/
    - entities.md (8 个实体)
    - apis.md (12 个接口)
    - flows.md (3 个流程)
    - dependencies.md (5 个依赖)
    - glossary.md (10 个术语)
  📁 .claude/architecture/
    - overview.md
    - structure.md
    - tech-stack.md
    - deploy.md
  📁 .claude/rules/
    - README.md

⚠️  以下内容需要人工确认（标记为 ?）：
  - entities.md: order.status 的业务含义
  - flows.md: 退款流程的具体步骤

准确性保障

机制	说明
? 标记	AI 不确定的内容标记 ?，需人工确认
来源追溯	每条知识标注来源文件和行号
置信度	显式标注置信度（高/中/低）

用户确认方式：

手动编辑去除 ? 标记
使用 /knowledge update 重新生成

命令	功能
`/knowledge scan`	扫描全部（调用 domain + arch）
`/knowledge update`	更新已生成的文档
`/knowledge status`	查看知识库状态
`/knowledge clean`	清理并重新生成

project-knowledge

项目知识库管理器

执行原则

工作流程

核心功能