# skills

**Repository Path**: ecitlm/skills

## Basic Information

- **Project Name**: skills
- **Description**: AI skill集合
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-26
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Skills 技能集仓库

## 项目简介

本仓库是一套面向企业级软件开发全生命周期的技能集（Skills），涵盖银行文档、GitLab、Confluence、JIRA、Java 开发等多个技术栈。每项技能均提供详细的操作指南、最佳实践、模板文件和故障排查文档，帮助开发团队提升协作效率与工程质量。

## 技能清单

### 银行文档技能包（banking-doc-skills）

面向银行金融系统全生命周期的文档技能包，包含 11 项核心技能：

| 技能名称 | 主要功能 |
|---------|---------|
| 项目立项（project-initiation） | 可行性研究报告、项目章程编写 |
| 需求分析（requirement-analysis） | BRD/PRD/SRS/RTM 文档编写 |
| 架构设计（architecture-design） | 总体架构设计、应用/数据/技术架构 |
| 详细设计（detailed-design） | 数据库/接口/报文/批量设计 |
| 安全合规（security-compliance） | 等保 2.0、数据安全、审计设计 |
| 测试文档（test-docs） | 测试计划、用例、SIT/UAT 报告 |
| 上线方案（release-operation） | 切换方案、回退预案、应急流程 |
| 变更管理（change-management） | 变更申请、影响分析、版本治理 |
| 运维手册（operation-maintenance） | 系统操作、运维手册、应急预案 |
| 遗留系统（legacy-recovery） | 系统盘点、逆向文档补建 |
| 文档评审（doc-review） | 质量检查、评审会议、问题跟踪 |

### GitLab 技能包（gitlab-skills）

GitLab 工作流技能集，支持代码审查、流水线监控、MR 管理等场景：

| 技能名称 | 主要功能 |
|---------|---------|
| glab | GitLab CLI 通用操作（MR、Issue、Epics） |
| mr-review | MR 代码审查与评论 |
| mr-guided-review | 引导式代码审查流程 |
| mr-adversarial-review | 对抗性审查（深度质疑） |
| gitlab-babysit-mr | 流水线状态监控与故障诊断 |
| gitlab-pipeline-watch | MR 流水线监听 |
| glab-glql | GraphQL 查询技能 |
| commit-messages | 规范提交信息编写 |
| stack-changes | Git 栈式变更管理 |
| handoff | 工作交接文档生成 |

### JIRA 技能包（jira-assistant）

JIRA 全流程管理技能，涵盖 Issue 管理、敏捷开发、运维操作等：

| 技能名称 | 主要功能 |
|---------|---------|
| jira-assistant | 技能路由中心，智能分发请求 |
| jira-issue | Issue 创建、查询、更新、删除 |
| jira-search | JQL 搜索、保存过滤器、数据导出 |
| jira-lifecycle | 工作流转换、版本/组件管理 |
| jira-agile | 冲刺管理、史诗管理、故事点估算 |
| jira-collaborate | 评论管理、附件操作、关注者管理 |
| jira-relationships | Issue 关联、阻塞分析、依赖图谱 |
| jira-time | 工时记录、时间估算、报表生成 |
| jira-bulk | 批量操作（转换、分配、克隆、删除） |
| jira-dev | 开发工作流集成（分支、提交、PR） |
| jira-fields | 自定义字段管理、Agile 字段配置 |
| jira-ops | JIRA 缓存管理、批量请求、性能优化 |
| jira-admin | 项目管理、权限方案、通知方案 |
| jira-jsm | 服务台管理、请求类型、SLA 监控 |

### Java 开发技能包（new-java-skill）

企业级 Java 开发全流水线技能，覆盖 P0 至 P8 各阶段：

| 阶段 | 技能名称 | 主要功能 |
|-----|---------|---------|
| P0 需求分析 | requirements-analysis | 需求澄清、PRD 编写、业务建模 |
| P1 系统设计 | java-system-design | 架构设计、数据库设计、模块划分 |
| P2 编码实现 | java-project-foundation | 工程规范、目录结构、POM 管理 |
| | spring-boot-development | Spring Boot 开发、REST API |
| | java-code-style-patterns | 编码规范、现代语法模式 |
| | java-concurrency | 并发编程、线程池、异步处理 |
| | api-interface-design | API 设计、REST 模式、幂等性 |
| | mq-messaging | 消息队列、RocketMQ 开发 |
| | mybatis-plus-persistence | 持久层开发、批量操作 |
| | oracle-database | Oracle 开发、分页、SQL 优化 |
| P3 测试 | java-testing | 单元测试、集成测试、Mock |
| P4 安全 | java-security | 认证授权、JWT、OWASP 防护 |
| P5 构建交付 | spring-cloud-microservices | 微服务架构、Gateway、Feign |
| | nacos-service-center | 服务注册配置、灰度发布 |
| P6 性能运维 | （预留） | - |
| P7 评审重构 | java-code-review-refactoring | 代码评审、重构手法 |
| P8 旧项目维护 | legacy-codebase-maintenance | 遗留系统摸底、文档补建 |

### Confluence 技能包（confluence-server）

Confluence Server 文档管理与知识库操作技能：

- 页面内容获取（按 ID、标题、空间）
- 全文搜索（CQL 查询）
- 空间与页面管理
- 附件操作
- 标签管理
- 页面创建与更新

### 文档排版技能包（outline-tietu）

将文章、脚本、论述转换为 3:4 竖版 HTML 贴图，适用于公众号、小红书等平台：

- 12 套单文件模板
- 12 种页面配方（封面、数据、步骤、时间线等）
- 跨平台 PNG 导出脚本
- 内容溢出自检机制

## 快速开始

### 环境要求

- Python 3.8+
- Git
- 对应平台的 CLI 工具（glab、JIRA CLI 等）

### 安装方式

#### 方式一：全局安装（推荐）

```bash
# 克隆仓库
git clone https://gitee.com/ecitlm/skills.git

# 设置环境变量
export SKILLS_ROOT=$(pwd)/skills

# 添加到 PATH（可选）
export PATH=$SKILLS_ROOT/scripts:$PATH
```

#### 方式二：按需安装

仅复制所需技能目录到项目或全局技能目录：

```bash
# 示例：仅安装 JIRA 相关技能
cp -r jira-assistant /path/to/global/skills/
```

### 验证安装

```bash
# 查看技能列表
ls -la */SKILL.md

# 查看技能帮助
cat banking-doc-skills/README.md
```

## 使用说明

### 调用方式

各技能通过对应的 CLI 脚本调用，基本用法如下：

```bash
# JIRA 技能示例
jira-assistant/jira-issue/create_issue.py --summary "测试问题" --type Bug

# GitLab 技能示例
gitlab-skills/glab/scripts/mr-review.sh --mr 123

# Java 技能示例
new-java-skill/core/java-project-foundation/scripts/init-project.sh
```

### 配置管理

支持多环境配置文件（JSON 格式）：

```json
{
  "jira": {
    "url": "https://jira.example.com",
    "username": "admin",
    "token": "your-api-token"
  },
  "gitlab": {
    "url": "https://gitlab.example.com",
    "token": "your-access-token"
  }
}
```

详细配置说明请参考各技能目录下的 `README.md` 文件。

## 文档结构

每个技能目录遵循统一结构：

```
skill-name/
├── SKILL.md           # 技能主文档（必选）
├── README.md          # 技能说明文档
├── docs/              # 详细指南与最佳实践
│   ├── BEST_PRACTICES.md
│   ├── QUICK_START.md
│   └── TROUBLESHOOTING.md
├── references/        # 参考文档与模板
│   ├── TEMPLATE.md
│   └── API_REFERENCE.md
├── examples/          # 使用示例
├── scripts/           # CLI 脚本
└── assets/            # 静态资源
```

## 最佳实践

### 技能选用建议

| 场景 | 推荐技能 |
|-----|---------|
| 银行项目文档编写 | banking-doc-skills/* |
| GitLab MR 审查 | gitlab-skills/mr-review |
| JIRA 敏捷开发 | jira-assistant/jira-agile |
| Java 后端开发 | new-java-skill/core/* |
| 遗留系统改造 | new-java-skill/legacy/* |
| 知识库管理 | confluence-server/* |
| 技术文档排版 | outline-tietu/* |

### 常见工作流

#### GitLab 代码审查流程

1. **提交审查**：使用 `mr-review` 获取 MR 差异
2. **引导审查**：`mr-guided-review` 分步骤分析
3. **深度质疑**：`mr-adversarial-review` 发现隐藏问题
4. **流水线监控**：`gitlab-babysit-mr` 跟踪 CI/CD

#### JIRA 敏捷开发流程

1. **创建史诗**：`jira-agile` 创建 Epic
2. **管理冲刺**：`jira-agile` 创建/启动 Sprint
3. **时间追踪**：`jira-time` 记录工时
4. **批量操作**：`jira-bulk` 冲刺收尾

#### Java 项目开发流程

1. **需求分析**：`requirements-analysis` 编写 PRD
2. **系统设计**：`java-system-design` 架构设计
3. **编码实现**：按需使用各核心技能
4. **代码评审**：`java-code-review-refactoring`
5. **测试覆盖**：`java-testing`

## 贡献指南

### 技能开发规范

1. **命名规范**：技能目录名使用小写字母和连字符
2. **必需文件**：每个技能必须包含 `SKILL.md` 和 `README.md`
3. **文档语言**：默认使用中文，特殊场景可提供英文版本
4. **模板统一**：遵循项目提供的模板格式

### 提交规则

- 使用规范化的 commit message
- 提交前运行自检脚本
- 提交信息关联对应的技能变更

## 许可证

本仓库中的技能文档遵循 MIT License 开源协议。

## 致谢

感谢所有贡献者的努力，使得这套技能集能够持续完善并服务于企业级软件开发团队。