Initial commit

skills/toolkit/docs/concepts/toolkit-philosophy.md

@@ -0,0 +1,78 @@
+---
+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`