79 lines
2.1 KiB
Markdown
79 lines
2.1 KiB
Markdown
---
|
||
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`
|