# ai-shared-skills

**Repository Path**: ai-dev-ops/ai-shared-skills

## Basic Information

- **Project Name**: ai-shared-skills
- **Description**: 一个共享AI技能和知识的开源项目，旨在为开发者提供丰富的AI工具和资源，促进技术交流与创新。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-22
- **Last Updated**: 2026-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 共享技能库

## 项目简介

AI 共享技能库是一个集中管理和提供各种AI技能的仓库，旨在为开发者提供标准化、可复用的AI能力，帮助解决开发过程中的常见问题。

## 技能列表

### 1. 阿里巴巴Java开发手册(黄山版) - AI代码审查

**技能名称**：`alibaba-java-coding-standards`

**功能描述**：基于阿里巴巴Java开发手册(黄山版)的代码审查能力，对Java代码进行规范化检查，识别违反编码规约的问题并提供修复建议。

**适用场景**：
- 请求对Java代码进行代码审查
- 要求检查代码是否符合阿里巴巴Java开发手册
- 要求检查代码规范/代码风格
- 要求进行代码评审
- 要求对指定包路径下的Java类进行批量审查
- 要求指定某个具体规约进行代码审查
- 要求根据代码审查报告调整/修复代码
- 要求自动修复代码规范问题

**核心能力**：
- 全面的编码规约检查（命名风格、常量定义、代码格式、OOP规约等）
- 详细的问题报告和修复建议
- 支持批量审查和自动代码调整
- 标准化的输出格式

### 2. 大话重构 - 代码重构七步曲

**技能名称**：`dahua-chonggou`

**功能描述**：基于范钢老师的《大话重构》一书，提供专业的代码重构指导服务。遵循"重构七步曲"流程，帮助开发者在不改变软件外部行为的前提下优化代码结构，提升可读性、可维护性和可扩展性。

**适用场景**：
- 代码重构指导
- 代码坏味道识别
- 重构方法建议
- 大规模重构规划
- 重构与设计模式结合
- 单元测试建议
- DDD领域驱动设计指导
- "如何重构XXX"、"XXX代码怎么优化"、"重构XXX需要注意什么"

**核心能力**：
- 重构七步曲指导（分解大函数、拆分大对象、提高代码复用率等）
- 重构工具箱（方法重构、对象重构、对象间重构等）
- 质量评估体系
- 遗留系统处理策略
- 需求变更应对方法

### 3. 乐观锁实现

**技能名称**：`implementing-optimistic-lock`

**功能描述**：为数据表添加乐观锁机制，确保在并发操作时数据的一致性和正确性。乐观锁通过版本号机制，在更新数据时检查数据是否被其他线程修改，从而避免并发冲突。

**适用场景**：
- 为一个或多个数据表添加乐观锁机制
- 确保并发更新时的数据一致性
- 实现基于版本号的冲突检测
- 处理乐观锁更新失败的情况

**核心能力**：
- 为数据表添加版本号字段
- 修改DO类添加version属性和@Version注解
- 更新XML映射文件
- 修改Service类的更新方法支持乐观锁
- 添加乐观锁更新失败的错误码

## 项目结构

```
.ai-shared-skills/
├── .trae/
│   └── rules/
│       └── git-commit-message.md
├── alibaba-java-coding-standards/
│   └── SKILL.md
├── dahua-chonggou/
│   └── SKILL.md
└── implementing-optimistic-lock/
    └── SKILL.md
```

## 使用方法

### 触发方式

1. **阿里巴巴Java开发手册代码审查**
   - 关键词触发："Java代码审查"、"代码规范检查"、"阿里巴巴Java开发手册"等
   - 示例："请对以下Java代码进行代码审查，检查是否符合阿里巴巴Java开发手册规范"

2. **大话重构指导**
   - 关键词触发："代码重构"、"遗留系统优化"、"代码质量提升"、"重构流程"等
   - 示例："如何重构这个过长的方法？按照《大话重构》的方法"

3. **乐观锁实现**
   - 关键词触发："实现乐观锁"、"添加乐观锁"等
   - 示例："请为以下数据表实现乐观锁机制：表名列表：[grid_facility_tower]，DO类包路径：[com.lianchuang.platform.module.dao.dataobject]"

### 输入格式

1. **阿里巴巴Java开发手册代码审查**
   - 提供Java代码或指定包路径
   - 可指定具体规约进行审查

2. **大话重构指导**
   - 描述重构需求或提供代码示例
   - 可指定重构类型（如过长方法拆分、重复代码处理等）

3. **乐观锁实现**
   - 提供表名列表
   - 提供DO类包路径
   - 提供错误码枚举类路径

### 输出格式

1. **阿里巴巴Java开发手册代码审查**
   - 代码审查报告（严重问题、重要问题、建议改进）
   - 代码调整报告（已调整文件、调整详情、调整后代码）

2. **大话重构指导**
   - 坏味道分析
   - 重构方案
   - 代码示例（重构前后对比）
   - 风险评估
   - 测试建议

3. **乐观锁实现**
   - 操作结果（成功/失败）
   - 修改的文件列表
   - 详细的实现步骤和代码示例

## 技术特点

1. **标准化流程**：每个技能都有明确的执行流程和标准输出格式
2. **可扩展性**：易于添加新的技能和扩展现有技能的功能
3. **专业性**：基于权威资料和最佳实践（如阿里巴巴Java开发手册、《大话重构》）
4. **实用性**：提供具体的代码示例和操作指南
5. **全面性**：覆盖代码审查、重构指导、并发控制等多个开发场景

## 应用价值

1. **提高代码质量**：通过规范化审查和重构指导，提升代码的可读性、可维护性和可扩展性
2. **减少开发错误**：提前发现和修复代码中的问题，减少生产环境的bug
3. **优化开发流程**：提供标准化的解决方案，减少重复工作，提高开发效率
4. **提升团队能力**：通过学习和应用最佳实践，提升团队整体开发水平
5. **确保数据一致性**：通过乐观锁机制，解决并发操作中的数据一致性问题

## 如何贡献

1. **添加新技能**：在项目根目录创建新的技能目录，包含SKILL.md文件和相关资源
2. **改进现有技能**：更新SKILL.md文件，添加新的功能和示例
3. **提交建议**：通过issues提出改进建议和新功能需求

## 版本信息

- **阿里巴巴Java开发手册代码审查**：v1.0.0
- **大话重构指导**：v1.0.0
- **乐观锁实现**：v1.2.0

## 许可证

本项目采用MIT许可证。