ai-runtime-toolkit

# AI Runtime 工具装备系统

## 概述

工具装备是AI Runtime的**外置能力扩展系统**，遵循"**整合 > 创造**"的核心理念，通过智能整合成熟的CLI工具和自主创建的专业工具，实现认知能力的有效扩展。

## 核心能力

### 双重工具体系
- **内部工具**: AI Runtime自主创建的专业工具（8个）
- **外部工具**: 深度整合的成熟CLI工具（10+个）

### 智能发现系统
- 自动工具检测和注册
- 元数据驱动的管理机制
- 命令行和编程接口双重支持

## 快速开始

### 查看所有工具
```bash
# 进入工具装备目录
cd toolkit

# 查看所有工具
python3 discover-toolkit.py list

# 查看外部工具
python3 discover-toolkit.py list --external
```

### 使用工具
```bash
# 查看工具详情
python3 discover-toolkit.py show SERVICE-CHECK-001

# 运行工具
python3 discover-toolkit.py run dependency-analyzer . -o deps.json

# 搜索工具
python3 discover-toolkit.py search monitor
```

## 工具分类

### 内部工具（自主创建）
- **Python工具**: 依赖分析器、代码统计器、图形生成器、报告生成器
- **Bash工具**: 服务健康检查器、日志分析器、磁盘健康检查器
- **Node.js工具**: API测试工具

### 外部工具（深度整合）
- **基础必备**: fzf、eza、bat、ripgrep、zoxide、jq
- **搜索增强**: fd、ripgrep
- **数据处理**: jq
- **界面优化**: fzf、eza、bat、starship

## 渐进式披露文档架构

基于 anthropics/skills 设计，按需加载详细信息：

### 核心理念
- **[工具哲学](references/core/toolkit-philosophy.md)** - 设计理念、分类体系和发展策略

### 使用指南
- **[快速开始](references/guides/quickstart.md)** - 10分钟上手工具装备系统

### 详细参考
- **[内部工具详解](../docs/references/internal-tools.md)** - 8个自主创建工具的详细说明
- **[外部工具集成](../docs/references/external-tools.md)** - 10+个CLI工具的整合指南

### 开发指南
- **[创建新工具](../docs/guides/creating-tools.md)** - 工具开发流程和最佳实践
- **[外部工具整合](../docs/guides/external-integration.md)** - 整合第三方CLI工具

## 设计理念

### 整合优于创造
- **成熟工具**: 使用经过社区验证的CLI工具
- **专注专业**: 每个工具只做一件事，做到极致
- **认知卸载**: 直接使用，无需重复开发

### 元数据驱动
- **.meta.yml**: 工具元数据标准格式
- **自动发现**: 基于文件系统结构自动注册
- **类型安全**: 明确的工具分类和版本管理

## 使用场景

### 代码分析
```bash
# 分析项目依赖
python3 discover-toolkit.py run dependency-analyzer . -o deps.json

# 生成代码统计
python3 discover-toolkit.py run code-stats src/ -o stats.json
```

### 系统监控
```bash
# 检查服务健康
python3 discover-toolkit.py run service-check http://localhost:3000

# 分析日志文件
python3 discover-toolkit.py run log-analyzer /var/log/app.log --level ERROR
```

### 数据处理
```bash
# 处理JSON数据
cat data.json | jq '.items[] | select(.status == "active")'

# 搜索代码
rg "TODO|FIXME" src/
```

## 相关系统

- **[宪法文档](../.ai-runtime/constitution.md)** - 治理原则和约束
- **[记忆系统](../memory/)** - 分层记忆管理
- **[认知记录](../cognition/)** - 分析洞察和探索报告
- **[命令系统](../commands/)** - 运行时命令和交互

## 版本信息

- **版本**: 2.0.0
- **内部工具**: 8个
- **外部工具**: 10+个
- **最后更新**: 2025-11-14

---

*基于 anthropics/skills 渐进式披露架构设计*