# skills

**Repository Path**: magicxie/skills

## Basic Information

- **Project Name**: skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Skills 技能库

一个可复用的自动化技能集合，覆盖 Java 开发、本地诊断和文档查询等工作流。

## 快速开始

```bash
npx skills add https://github.com/lltx/skills --skill <技能名称>
```

## 可用技能

### code-tidy

Java 代码整理工具，自动完成代码规范化工作。

**安装：**

```bash
npx skills add https://github.com/lltx/skills --skill code-tidy
```

**功能：**

- **自动添加 Javadoc 注释** - 为类和 public/protected 方法添加规范的注释
- **更新日期注释** - 自动更新 `@date` 为当前日期，更新 Copyright 年份
- **代码格式化** - 使用 spring-javaformat-maven-plugin 格式化修改过的文件

**触发方式：**

- "整理代码"
- "添加注释"
- "格式化 Java"
- "更新日期注释"

**注释规范：**

- 自动跳过 getter/setter、@Override 方法
- 不重复添加已有完整注释
- 类注释包含：功能描述、@author、@date
- 方法注释包含：功能描述、@param、@return

### java-code-simplifier

Java 代码优化工具，在不改变任何功能的前提下提升代码的清晰度、安全性和可维护性。

**安装：**

```bash
npx skills add https://github.com/lltx/skills --skill java-code-simplifier
```

**功能：**

- **空值安全** - 检查链式调用 NPE 风险，推荐 `Optional` 用法
- **异常处理** - 识别空 catch 块、异常链丢失、过宽捕获
- **集合与 Stream** - 避免迭代时修改集合，合理选择 Stream vs for 循环
- **资源管理** - 确保 `Closeable` 资源使用 try-with-resources
- **并发安全** - 检查共享可变状态、check-then-act 竞态条件
- **Java 惯用法** - equals/hashCode 成对实现，Builder 模式，模式匹配
- **API 设计** - 布尔参数改枚举，返回 `Optional`，公共 API 输入校验
- **性能热点** - 循环内字符串拼接、正则预编译、N+1 查询

**触发方式：**

- "优化这段 Java 代码"
- "简化 / 清理 / 重构 Java 代码"
- "review 一下这个类"
- 完成任何 Java 编码任务后（自动建议）

### network-doctor

本地网络诊断工具，用只读基线先定位网速慢、延迟高、DNS 慢、Wi-Fi 弱、VPN/代理异常、MTU 或后台流量问题，再按“一次只改一个变量”的方式给出可回滚建议。

**安装：**

```bash
npx skills add https://github.com/lltx/skills --skill network-doctor
```

**功能：**

- **只读基线优先** - 先采集吞吐、延迟、丢包、DNS、路由、Wi-Fi、MTU、代理/VPN 和进程信号
- **分层诊断** - 区分 ISP、Wi-Fi/LAN、DNS、VPN/代理、MTU/TCP 和后台流量原因
- **安全变更门禁** - DNS、MTU、代理、VPN、防火墙、网络位置、`sudo` 等修改必须先确认
- **前后对比验证** - 每次只改一个变量，并用同一组指标复测
- **回滚要求** - 所有修改都必须给出旧值、恢复命令或 UI 路径

**触发方式：**

- "网络慢 / 网速慢 / 网速优化"
- "网络延迟高 / packet loss"
- "Wi-Fi 慢 / DNS 慢 / MTU 问题"
- "VPN 或代理影响网速"
- "帮我安全地把网络弄快"

## 贡献

欢迎提交 PR 添加新的技能！每个技能需要在 `skills/` 目录下创建独立文件夹，并包含 `SKILL.md` 定义文件。

## 许可证

MIT