Agent Skills: Service Analysis Skill

Service Analysis Skill

概述

服务理解与分析技能，用于快速理解和加载服务上下文，包括服务概览、业务逻辑、架构分析和运维协议。

核心能力

1. 服务概览 (service-overview)

分析内容:
  - 服务名称和定位
  - 核心功能列表
  - 技术栈信息
  - 依赖服务清单
  - 团队负责人

输出: 服务概览卡片

2. 业务逻辑 (service-business)

分析内容:
  - 业务流程图
  - 核心用例
  - 数据模型
  - 业务规则
  - 边界条件

输出: 业务理解文档

3. 架构分析 (service-architecture)

分析内容:
  - 系统架构图
  - 模块划分
  - 接口定义
  - 数据流向
  - 关键路径

输出: 架构分析报告

4. 运维协议 (service-ops)

分析内容:
  - 部署流程
  - 配置管理
  - 监控告警
  - 故障处理
  - SLA 要求

输出: 运维手册摘要

服务上下文结构

.service-context/
├── index.md                 # 服务索引
├── {service-name}/
│   ├── overview.md          # 服务概览
│   ├── business.md          # 业务逻辑
│   ├── architecture.md      # 架构文档
│   ├── api.md               # API 文档
│   ├── data-model.md        # 数据模型
│   └── ops.md               # 运维协议
└── shared/
    ├── glossary.md          # 术语表
    └── conventions.md       # 约定俗成

服务概览卡片格式

# 服务: {service-name}

## 基本信息
| 属性 | 值 |
|:---|:---|
| 名称 | user-service |
| 定位 | 用户管理核心服务 |
| 负责人 | @team-user |
| 技术栈 | Node.js + PostgreSQL |

## 核心功能
- 用户注册/登录
- 用户信息管理
- 权限控制

## 依赖服务
- auth-service: 认证服务
- notification-service: 通知服务

## 关键指标
- QPS: 10000
- 延迟 P99: <100ms
- 可用性: 99.9%

使用场景

1. 开发新功能前

流程:
  1. /vibe-service load user-service
  2. 自动加载:
     - overview.md (了解服务定位)
     - business.md (理解业务逻辑)
     - architecture.md (了解现有架构)
  3. 输出服务上下文摘要

好处:
  - 避免重复询问服务背景
  - 快速进入开发状态
  - 减少理解偏差

2. 跨服务开发

流程:
  1. /vibe-service load service-a service-b
  2. 加载两个服务的上下文
  3. 分析服务间交互
  4. 识别接口边界

输出:
  - 两个服务的概览
  - 交互接口列表
  - 数据流向图

3. 问题排查

流程:
  1. /vibe-service analyze user-service
  2. 加载:
     - architecture.md (架构)
     - ops.md (运维协议)
  3. 提供排查建议

输出:
  - 相关组件列表
  - 常见问题及解决方案
  - 监控和日志位置

自动分析能力

从代码推断服务信息

若无服务文档:
  1. 分析 package.json / pom.xml
  2. 扫描目录结构
  3. 识别主要模块
  4. 提取 API 路由
  5. 生成服务概览

分析点:
  - 依赖包 → 技术栈
  - src/ 结构 → 模块划分
  - routes/ → API 端点
  - models/ → 数据模型

生成服务文档建议

若服务文档不完整:
  1. 识别缺失部分
  2. 从代码推断内容
  3. 生成文档草稿
  4. 建议用户完善

MCP 集成

// 搜索服务相关代码
sou_search({
  query: "user-service 的认证逻辑",
  scope: "src/",
  limit: 10
})

// 深度分析架构
sequential_thinking({
  problem: "分析 user-service 的架构",
  steps: [
    "识别主要模块",
    "分析依赖关系",
    "绘制架构图",
    "识别关键路径"
  ]
})

// 缓存服务上下文
memory_store({
  category: "service_context",
  title: "user-service 概览",
  content: "...",
  tags: ["service", "user"]
})

指令

/vibe-service load

# 加载单个服务
/vibe-service load user-service

# 加载多个服务
/vibe-service load user-service auth-service

# 加载并分析
/vibe-service load user-service --analyze

/vibe-service analyze

# 分析服务架构
/vibe-service analyze user-service

# 分析服务交互
/vibe-service analyze user-service --with auth-service

/vibe-service init

# 初始化服务文档
/vibe-service init user-service

# 从代码生成文档
/vibe-service init user-service --from-code

配置

# orchestrator.yaml
service_analysis:
  skill_path: skills/service-analysis/SKILL.md
  context_path: .service-context/
  auto_load: true
  cache_to_memory: true
  analyze_from_code: true

与其他 Skill 的关系

knowledge-base:
  - 服务文档可作为知识库的一部分
  - 服务规范继承自知识库

experience:
  - 服务相关经验可关联到具体服务
  - 服务变更历史记录为经验

riper:
  - Research 阶段自动加载相关服务上下文
  - Execute 阶段参考服务架构约束