2.1 KiB
2.1 KiB
name, description, category, version
| name | description | category | version |
|---|---|---|---|
| toolkit-philosophy | 工具装备系统的核心理念和设计哲学 | concept | 1.0.0 |
工具装备系统 - 核心理念
类比：外置能力扩展
像人类记得自己有哪些工具、这些工具能做什么一样，我们维护一个工具装备系统。
工具是我们的外置能力扩展：
- 用锤子钉钉子（无需重新发明锤子）
- 用螺丝刀拧螺丝（无需重新发明螺丝刀）
- 选择正确的工具 → 更高效地解决问题 → 避免重复造轮子
工具装备系统 = 工具仓库 + 使用记忆 + 分类索引 + 创建流程
关键原则
1. 整合 > 创造
核心理念：不要重复造轮子
原因：
- 成熟稳定: 如
fzf,eza,fd等工具经过数千小时打磨 - 社区支持: 庞大的用户群和完善的文档
- 专注专业: 每个工具只做一件事，做到极致
- 认知卸载: 直接使用，无需维护
类比：就像人类不会自己打造锤子，而是从五金店购买。
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