gh-dwsy-ai-runtime-ai-runtime-toolkit/skills/toolkit/docs/guides/quickstart.md

name, description, category, version

name	description	category	version
quickstart	工具装备系统快速入门指南	guide	1.0.0

工具装备系统 - 快速开始

发现和使用工具

# 进入工具装备目录
cd .ai-runtime/toolkit

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

# 查看所有可用工具（包含外部工具）
python3 discover-toolkit.py list --include-external

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

# 查看特定工具详情
python3 discover-toolkit.py show SERVICE-CHECK-001

# 搜索相关工具（模糊匹配）
python3 discover-toolkit.py search health

# 推荐适合任务的工具
python3 discover-toolkit.py recommend "检查数据库连接"

# 直接运行工具
python3 discover-toolkit.py run dependency-analyzer . -o report.json

# 查看工具使用历史（如果有）
python3 discover-toolkit.py history

可用的工具

内部工具（AI-Runtime创建）

工具名称	ID	语言	用途	描述
服务健康检查器	SERVICE-CHECK-001	bash	MONITOR	检查HTTP服务、数据库、Redis的健康状态
依赖分析器	PY-DEPENDENCY-ANALYZER-001	python	CODE,DATA	分析Python/JavaScript项目的依赖关系
代码统计器	PY-CODE-STATS-004	python	CODE,DATA	分析代码库统计信息
日志分析器	BASH-ANALYZE-LOGS-002	bash	DATA,MONITOR	分析日志文件
磁盘健康检查器	BASH-CHECK-DISK-003	bash	MONITOR	检查磁盘空间和使用情况

服务健康检查器

• 文件: bash/system/check-service.sh
• 用途: 检查HTTP服务、数据库、Redis的健康状态
• 使用: bash check-service.sh <服务名> <类型> [超时]
• 类型: http, db/database, redis
• 示例:

  bash check-service.sh auth-service http
  bash check-service.sh db-service db
  

依赖分析器

• 文件: python/analysis/dependency-analyzer.py
• 用途: 分析Python/JavaScript项目的依赖关系，生成可视化报告
• 使用: python3 dependency-analyzer.py [项目目录] -o report.json
• 支持: requirements.txt, package.json
• 功能: 依赖解析、安全风险检测、报告生成
• 示例:

  python3 dependency-analyzer.py
  python3 dependency-analyzer.py /path/to/project
  python3 dependency-analyzer.py . -o report.json
  

API测试工具

• 文件: node/api/test-api.js
• 用途: 测试RESTful API端点
• 使用: node test-api.js [base-url]
• 示例:

  node test-api.js http://localhost:3000
  

工具使用流程

场景1：探索新项目

# 1. 查看项目结构
python3 discover-toolkit.py list

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

# 3. 检查服务健康（如果适用）
bash bash/system/check-service.sh myapp http

场景2：排查问题

# 1. 搜索相关工具
python3 discover-toolkit.py search log

# 2. 分析日志
bash bash/analysis/analyze-logs.sh /path/to/logs --level ERROR

# 3. 检查磁盘空间
bash bash/system/check-disk.sh /

场景3：常规监控

# 1. 检查所有服务
for service in auth db cache; do
  bash bash/system/check-service.sh $service http
done

# 2. 生成健康报告
python3 discover-toolkit.py recommend "health check"

下一步学习

• 查看完整参考: @docs/references/internal-tools.md
• 了解外部工具: @docs/external-integration.md
• 学习如何创建工具: @docs/guides/creating-tools.md