---
name: toolkit-philosophy
description: 工具装备系统的核心理念和设计哲学
category: concept
version: 1.0.0
---

# 工具装备系统 - 核心理念

## 类比：外置能力扩展

像人类记得自己有哪些工具、这些工具能做什么一样，我们维护一个**工具装备系统**。

工具是我们的**外置能力扩展**：
- 用锤子钉钉子（无需重新发明锤子）
- 用螺丝刀拧螺丝（无需重新发明螺丝刀）
- 选择正确的工具 → 更高效地解决问题 → 避免重复造轮子

```
工具装备系统 = 工具仓库 + 使用记忆 + 分类索引 + 创建流程
```

## 关键原则

### 1. 整合 > 创造

**核心理念**：不要重复造轮子

**原因**：
1. **成熟稳定**: 如 `fzf`, `eza`, `fd` 等工具经过数千小时打磨
2. **社区支持**: 庞大的用户群和完善的文档
3. **专注专业**: 每个工具只做一件事，做到极致
4. **认知卸载**: 直接使用，无需维护

**类比**：就像人类不会自己打造锤子，而是从五金店购买。

### 2. 工具分类体系

工具按**语言**分类：
- `bash/` - Shell脚本工具
- `python/` - Python工具
- `node/` - Node.js工具

工具按**用途**分类：
- `CODE` - 代码相关
- `DATA` - 数据分析
- `TEST` - 测试
- `BUILD` - 构建
- `MONITOR` - 监控
- `DOC` - 文档

工具按**复杂度**分类：
- `level-1` - 1-5行，简单命令
- `level-2` - 6-20行，简单脚本
- `level-3` - 21-50行，中等复杂度
- `level-4` - 50+行或系统级工具

### 3. 自我完善

工具装备系统**持续演进**：
- 识别重复任务 → 自动化
- 识别模式 → 提取通用工具
- 使用反馈 → 改进工具
- 社区工具 → 整合而非重复

## 设计目标

✅ **可发现性** - 快速找到合适的工具
✅ **可维护性** - 独立文件，清晰分类
✅ **可扩展性** - 轻松添加新工具
✅ **一致性** - 统一元数据格式（.meta.yml）
✅ **可靠性** - 工具检测和验证

## 相关文档

- **快速开始**: `@docs/guides/quickstart.md`
- **工具分类**: `@docs/references/tool-categories.md`
- **创建工具**: `@docs/guides/creating-tools.md`