flowmind 1.0.0

package/skills/resource-bind/SKILL.md

@@ -0,0 +1,222 @@
+---
+name: resource-bind
+description: Resource binding and connection management skill for FlowMind. Manage database, Redis, API, and other external resource connections.
+metadata:
+  version: "1.0.0"
+  author: flowmind
+  category: infrastructure
+---
+
+# Resource Bind Skill
+
+Manage database, Redis, API, and other external resource connections.
+
+## Features
+
+### 🗄️ Database Management
+- MySQL/PostgreSQL connections
+- Connection pooling
+- Query execution
+- Schema inspection
+
+### 📦 Redis Management
+- Redis connections
+- Key operations
+- Cache management
+
+### 🔌 API Integration
+- REST API connections
+- Authentication management
+- Request/response handling
+
+## Trigger Patterns
+
+```
+"数据库", "database", "DB", "SQL"
+"redis", "缓存", "cache"
+"API", "接口", "连接"
+"资源", "resource"
+"连接配置", "connection"
+```
+
+## Resource Types
+
+### Database
+
+```json
+{
+  "type": "mysql",
+  "host": "localhost",
+  "port": 3306,
+  "database": "mydb",
+  "username": "user",
+  "password": "pass"
+}
+```
+
+### Redis
+
+```json
+{
+  "type": "redis",
+  "host": "localhost",
+  "port": 6379,
+  "password": "",
+  "db": 0
+}
+```
+
+### API
+
+```json
+{
+  "type": "rest",
+  "baseUrl": "https://api.example.com",
+  "auth": {
+    "type": "bearer",
+    "token": "xxx"
+  }
+}
+```
+
+## Output Format
+
+```
+┌─────────────────────────────────────────────────────┐
+│ Resource Connection                                 │
+├─────────────────────────────────────────────────────┤
+│ Type: {resource_type}                               │
+│ Status: Connected ✓                                 │
+│ Host: {host}:{port}                                 │
+├─────────────────────────────────────────────────────┤
+│ Available:                                          │
+│ • {database1}                                       │
+│ • {database2}                                       │
+└─────────────────────────────────────────────────────┘
+```
+
+## Learning Integration
+
+This skill supports FlowMind learning:
+
+- **Connection Method**: Learns preferred connection method
+- **Default Database**: Learns frequently used databases
+- **Query Style**: Learns query formatting preferences
+
+```
+User: "用 source_id 连接"
+FlowMind: ✓ Learned: Use source_id for connections
+
+User: [Next connection]
+FlowMind: [Uses source_id automatically]
+```
+
+## Examples
+
+### Example 1: Database Connection
+
+```
+User: 连接数据库查询用户表
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ Database Connection                                 │
+├─────────────────────────────────────────────────────┤
+│ Type: MySQL                                         │
+│ Host: localhost:3306                                │
+│ Database: mydb                                      │
+│ Status: Connected ✓                                 │
+├─────────────────────────────────────────────────────┤
+│ Tables:                                             │
+│ • users (1000 rows)                                 │
+│ • orders (5000 rows)                                │
+│ • products (200 rows)                               │
+└─────────────────────────────────────────────────────┘
+```
+
+### Example 2: Redis Operations
+
+```
+User: 查看 Redis 缓存状态
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ Redis Status                                        │
+├─────────────────────────────────────────────────────┤
+│ Host: localhost:6379                                │
+│ Status: Connected ✓                                 │
+│ Keys: 1,234                                         │
+│ Memory: 45.2 MB                                     │
+├─────────────────────────────────────────────────────┤
+│ Recent Keys:                                        │
+│ • user:123 (TTL: 3600s)                             │
+│ • session:abc (TTL: 1800s)                          │
+│ • cache:products (TTL: 300s)                        │
+└─────────────────────────────────────────────────────┘
+```
+
+## Configuration
+
+```json
+{
+  "resources": {
+    "database": {
+      "enabled": true,
+      "type": "mysql",
+      "connection": {
+        "host": "localhost",
+        "port": 3306,
+        "database": "mydb"
+      }
+    },
+    "redis": {
+      "enabled": true,
+      "connection": {
+        "host": "localhost",
+        "port": 6379
+      }
+    },
+    "api": {
+      "enabled": true,
+      "baseUrl": "https://api.example.com"
+    }
+  }
+}
+```
+
+## Connection Methods
+
+### Direct Connection
+
+```json
+{
+  "method": "direct",
+  "host": "localhost",
+  "port": 3306
+}
+```
+
+### Source ID Connection
+
+```json
+{
+  "method": "source_id",
+  "sourceId": "your-source-id"
+}
+```
+
+### Connection String
+
+```json
+{
+  "method": "connection_string",
+  "url": "mysql://user:pass@host:3306/db"
+}
+```
+
+## Security
+
+- Passwords are encrypted at rest
+- Connections use TLS when available
+- Credentials are never logged
+- Connection pooling prevents exhaustion

package/skills/sls-log-audit/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: sls-log-audit
+description: SLS log audit skill for FlowMind. Query cloud log service (SLS, ELK, etc.), trace ID chain analysis, Feign call chain extraction, response time analysis, and error log investigation.
+metadata:
+  version: "1.1.0"
+  author: flowmind
+  category: monitoring
+componentDependencies:
+  - logService
+---
+
+# SLS Log Audit Skill
+
+Query and analyze Alibaba Cloud SLS (Simple Log Service) logs for troubleshooting, performance analysis, and chain tracing.
+
+## Features
+
+### Log Query
+- Time-range based log search
+- Service-level filtering
+- Log level filtering (ERROR, WARN, INFO, DEBUG)
+- Keyword and pattern search
+
+### TraceID Chain Analysis
+- Full call chain extraction by TraceID
+- Request/Response data capture
+- Timing analysis per span
+- Error location pinpointing
+
+### Feign Call Chain
+- Remote call chain extraction
+- Upstream/downstream service mapping
+- Call latency analysis
+- Failure point identification
+
+### Performance Analysis
+- Response time analysis
+- Slow endpoint detection
+- Timeout investigation
+- Bottleneck identification
+
+## Trigger Patterns
+
+```
+"SLS日志", "sls", "日志审查", "日志排查"
+"线上日志", "错误日志", "异常日志", "告警日志"
+"traceId", "链路追踪", "调用链", "链路分析"
+"Feign链路", "feign调用", "远程调用", "RPC链路"
+"响应耗时", "接口耗时", "耗时分析", "慢接口"
+"性能分析", "超时排查", "RT分析", "响应时间"
+"线上问题", "排查问题", "定位问题", "问题分析"
+```
+
+## Output Format
+
+### TraceID Chain Output
+
+```
+┌─────────────────────────────────────────────────────┐
+│ TraceID Chain Analysis                              │
+├─────────────────────────────────────────────────────┤
+│ TraceID: {traceId}                                  │
+│ Total Duration: {ms}ms                              │
+│ Spans: {count}                                      │
+├─────────────────────────────────────────────────────┤
+│ 1. {service} - {method}                             │
+│    URL: {url}                                       │
+│    Duration: {ms}ms                                 │
+│    Status: {status}                                 │
+│    Request: {params}                                │
+│    Response: {result}                               │
+│                                                    │
+│    2. {sub-service} - {method}                      │
+│       Duration: {ms}ms                              │
+│       Status: {status}                              │
+├─────────────────────────────────────────────────────┤
+│ Errors: {error_count}                               │
+│ • {error_message} at {service}:{line}               │
+└─────────────────────────────────────────────────────┘
+```
+
+### Log Query Output
+
+```
+┌─────────────────────────────────────────────────────┐
+│ SLS Log Query Results                               │
+├─────────────────────────────────────────────────────┤
+│ Query: {query}                                      │
+│ Time Range: {start} ~ {end}                         │
+│ Results: {count} logs                               │
+├─────────────────────────────────────────────────────┤
+│ [{timestamp}] [{level}] {service} - {message}       │
+│ [{timestamp}] [{level}] {service} - {message}       │
+└─────────────────────────────────────────────────────┘
+```
+
+## Component Integration
+
+This skill uses the **logService** component. The actual log service provider is determined by configuration.
+
+| Provider | MCP Server | Description |
+|----------|------------|-------------|
+| aliyun-sls | friday-sls-logs | Alibaba Cloud SLS |
+| baidu-sls | baidu-sls-logs | Baidu Cloud Log Service |
+| elk | (direct) | Elasticsearch |
+
+Configuration is managed in `flowmind.config.json` under `components.logService`.
+
+**Default endpoints** (aliyun-sls provider):
+
+| Environment | Endpoint | Region |
+|-------------|----------|--------|
+| test/uat | cn-shenzhen.log.aliyuncs.com | 深圳 |
+| gray/prod | cn-hongkong.log.aliyuncs.com | 香港 |
+
+## Learning Integration
+
+This skill supports FlowMind learning:
+
+- **Query Patterns**: Learns common query patterns
+- **Output Format**: Learns preferred display format (sequential list, tree, etc.)
+- **Service Mapping**: Learns service-to-project mappings
+
+## Examples
+
+### Example 1: TraceID Analysis
+
+```
+User: 查询 traceId abc123 的日志
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ TraceID Chain Analysis                              │
+├─────────────────────────────────────────────────────┤
+│ TraceID: abc123                                     │
+│ Total Duration: 256ms                               │
+│ Spans: 5                                            │
+├─────────────────────────────────────────────────────┤
+│ 1. order-service - createOrder                      │
+│    URL: /api/orders                                 │
+│    Duration: 256ms                                  │
+│    Status: 200                                      │
+│                                                    │
+│    2. user-service - getUserInfo                    │
+│       Duration: 45ms                                │
+│       Status: 200                                   │
+│                                                    │
+│    3. inventory-service - checkStock                │
+│       Duration: 120ms                               │
+│       Status: 200                                   │
+│                                                    │
+│    4. payment-service - createPayment               │
+│       Duration: 89ms                                │
+│       Status: 200                                   │
+└─────────────────────────────────────────────────────┘
+```
+
+### Example 2: Error Investigation
+
+```
+User: 排查线上错误日志
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ Error Log Investigation                             │
+├─────────────────────────────────────────────────────┤
+│ Service: order-service                              │
+│ Time: Last 1 hour                                   │
+│ Errors Found: 3                                     │
+├─────────────────────────────────────────────────────┤
+│ 🔴 NullPointerException at OrderService.java:128    │
+│    TraceID: xyz789                                  │
+│    Context: user_id=12345, order_id=67890           │
+│                                                    │
+│ 🟡 TimeoutException at FeignClient.java:45          │
+│    TraceID: def456                                  │
+│    Service: inventory-service                       │
+│    Duration: 5001ms (timeout: 5000ms)               │
+└─────────────────────────────────────────────────────┘
+```
+
+## Configuration
+
+Skill-specific configuration:
+
+```json
+{
+  "sls-log-audit": {
+    "defaultProject": "your-project",
+    "defaultLogstore": "your-logstore",
+    "queryLimit": 100,
+    "timeRange": {
+      "default": "1h",
+      "max": "24h"
+    }
+  }
+}
+```
+
+Component provider configuration (in `flowmind.config.json`):
+
+```json
+{
+  "components": {
+    "logService": {
+      "default": "aliyun-sls",
+      "providers": {
+        "aliyun-sls": {
+          "adapter": "aliyun-sls-adapter",
+          "enabled": true,
+          "mcpServer": "friday-sls-logs",
+          "config": {
+            "endpoints": {
+              "test": "cn-shenzhen.log.aliyuncs.com",
+              "prod": "cn-hongkong.log.aliyuncs.com"
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```

package/skills/yapi-sync-interface/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: yapi-sync-interface
+description: YApi interface sync skill for FlowMind. Sync Controller interfaces to YApi, import/export Swagger, manage API documentation lifecycle.
+metadata:
+  version: "1.1.0"
+  author: flowmind
+  category: documentation
+componentDependencies:
+  - apiDoc
+---
+
+# YApi Interface Sync Skill
+
+Synchronize API interfaces between code and YApi platform for consistent API documentation management.
+
+## Features
+
+### Interface Sync
+- Extract Controller interfaces from code
+- Sync to YApi project
+- Update existing interfaces
+- Create new interface categories
+
+### Swagger Import/Export
+- Generate Swagger/OpenAPI from code
+- Import Swagger to YApi
+- Export YApi interfaces to Swagger
+
+### Interface Management
+- Search interfaces by keyword
+- Manage interface categories
+- Interface version tracking
+- Test collection management
+
+## Trigger Patterns
+
+```
+"同步接口", "sync interfaces"
+"YApi同步", "yapi sync"
+"接口文档", "API documentation"
+"Swagger导入", "swagger import"
+"接口管理", "interface management"
+"更新YApi", "update yapi"
+```
+
+## Output Format
+
+```
+┌─────────────────────────────────────────────────────┐
+│ YApi Interface Sync Report                          │
+├─────────────────────────────────────────────────────┤
+│ Project: {project_name} (ID: {id})                  │
+│ Category: {category}                                │
+├─────────────────────────────────────────────────────┤
+│ Interfaces Found: {count}                           │
+│ • New: {new_count}                                  │
+│ • Updated: {update_count}                           │
+│ • Unchanged: {unchanged_count}                      │
+├─────────────────────────────────────────────────────┤
+│ Sync Status: ✅ Success / ❌ Failed                  │
+│ YApi URL: {url}                                     │
+└─────────────────────────────────────────────────────┘
+```
+
+## Component Integration
+
+This skill uses the **apiDoc** component. The actual API documentation provider is determined by configuration.
+
+| Provider | MCP Server | Description |
+|----------|------------|-------------|
+| yapi | aomi-yapi-mcp | YApi API documentation platform |
+
+Configuration is managed in `flowmind.config.json` under `components.apiDoc`.
+
+**Available MCP tools** (yapi provider):
+
+| Tool | Description |
+|------|-------------|
+| `yapi_search_apis` | Search interfaces by keyword |
+| `yapi_get_categories` | Get project categories |
+| `yapi_save_api` | Create/update interface |
+| `yapi_import_swagger` | Import Swagger data |
+| `yapi_export_project` | Export project data |
+
+## Learning Integration
+
+This skill supports FlowMind learning:
+
+- **Project Mapping**: Learns which code maps to which YApi project
+- **Category Mapping**: Learns package-to-category mappings
+- **Sync Preferences**: Learns sync preferences (overwrite, merge, etc.)
+
+## Examples
+
+### Example 1: Sync Controller to YApi
+
+```
+User: 同步 OrderController 的接口到 YApi
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ YApi Interface Sync Report                          │
+├─────────────────────────────────────────────────────┤
+│ Project: order-service (ID: 28)                     │
+│ Category: 订单管理                                  │
+├─────────────────────────────────────────────────────┤
+│ Interfaces Found: 5                                 │
+│ • New: 2 (createOrder, cancelOrder)                 │
+│ • Updated: 3 (getOrder, listOrders, updateOrder)    │
+├─────────────────────────────────────────────────────┤
+│ Sync Status: ✅ Success                             │
+│ YApi URL: https://yapi.example.com/project/28       │
+└─────────────────────────────────────────────────────┘
+```
+
+### Example 2: Search Interfaces
+
+```
+User: 搜索 YApi 上的订单相关接口
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ YApi Interface Search                               │
+├─────────────────────────────────────────────────────┤
+│ Keyword: 订单                                       │
+│ Results: 8 interfaces                               │
+├─────────────────────────────────────────────────────┤
+│ 1. 创建订单 - POST /api/orders (project: order-svc) │
+│ 2. 查询订单 - GET /api/orders/{id} (project: order) │
+│ 3. 取消订单 - PUT /api/orders/{id}/cancel           │
+└─────────────────────────────────────────────────────┘
+```
+
+## Configuration
+
+```json
+{
+  "yapi-sync-interface": {
+    "defaultProjectId": "28",
+    "syncMode": "merge",
+    "autoCreateCategory": true,
+    "excludePatterns": ["**/internal/**"]
+  }
+}
+```