ai-runtime-toolkit

name	ai-runtime-toolkit
description	AI Runtime工具装备系统，支持8个内部专业工具和10+个外部CLI工具的整合管理，提供工具发现、执行和配置功能，遵循整合优于创造的设计理念
license	MIT
version	2.0.0

AI Runtime 工具装备系统

概述

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

核心能力

双重工具体系

• 内部工具: AI Runtime自主创建的专业工具（8个）
• 外部工具: 深度整合的成熟CLI工具（10+个）

智能发现系统

• 自动工具检测和注册
• 元数据驱动的管理机制
• 命令行和编程接口双重支持

快速开始

查看所有工具

# 进入工具装备目录
cd toolkit

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

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

使用工具

# 查看工具详情
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 设计，按需加载详细信息：

核心理念

• 工具哲学 - 设计理念、分类体系和发展策略

使用指南

• 快速开始 - 10分钟上手工具装备系统

详细参考

• 内部工具详解 - 8个自主创建工具的详细说明
• 外部工具集成 - 10+个CLI工具的整合指南

开发指南

• 创建新工具 - 工具开发流程和最佳实践
• 外部工具整合 - 整合第三方CLI工具

设计理念

整合优于创造

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

元数据驱动

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

使用场景

代码分析

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

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

系统监控

# 检查服务健康
python3 discover-toolkit.py run service-check http://localhost:3000

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

数据处理

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

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

相关系统

• 宪法文档 - 治理原则和约束
• 记忆系统 - 分层记忆管理
• 认知记录 - 分析洞察和探索报告
• 命令系统 - 运行时命令和交互

版本信息

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

---

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