# AI个性化技能库

`AI工具` `技能管理` `自动化` `开发工具` `CLI`

# ai-customizations

个人AI基础设施：技能、智能体、钩子和命令，全部版本化在单一仓库中，支持可复现安装，架构与智能体无关。

## 架构

```text
skills/                     # 可通过 npx skills 安装的技能（跨智能体）
agents/                     # 可复用的智能体定义
commands/                   # 可复用的 Markdown 命令
hooks/                      # 可复用的钩子
scripts/                    # 引导/安装脚本
```

## 可用技能

### `interactive-bug` - 交互式调试

**功能：**
- 通过自适应提问进行交互式 Bug 调试
- AI 根据需要向你提问（单选题或开放题）
- 一次性修复，无需来回沟通

**适用场景：**
- 发现了 Bug 但不想写详细报告
- 希望 AI 通过具体问题引导你
- 需要快速修复，无需提前整理上下文

**使用方式：**
```
/bug "问题的简短描述"
```

**示例：**
```
/bug "退出登录按钮不起作用"
```

AI 会询问你：
- 点击时究竟发生了什么？
- 按钮在哪里？
- 之前能用吗？

你回答（选择选项或自由填写），AI 随即调查并修复。

---

### `interactive-task` - 交互式任务

**功能：**
- 通过自适应提问处理交互式任务（功能开发、变更、重构）
- AI 识别任务类型并提出正确问题
- 一次性正确执行

**适用场景：**
- 想要添加/修改/重构某些内容
- 不想写详细规格说明
- 希望 AI 主动询问所需信息

**使用方式：**
```
/task "任务描述"
```

**示例：**
```
/task "添加深色模式"
/task "重构登录组件"
/task "更改表格中的列顺序"
```

AI 会识别任务类型是：新增、变更、重构、配置还是改进，并提出针对性问题。

---

### `prd-creator` - 交互式 PRD 生成器

**功能：**
- 通过交互式对话生成完整的产品需求文档（PRD）
- 根据问题复杂度分类，自适应提问数量（0 到 20 个）
- 输出聚焦于业务问题和需求（非技术性，不涉及具体技术栈）
- 将 PRD 保存至 `docs/prd/YYYY-MM-DD-<名称>.md`

**适用场景：**
- 开始构建前想先记录需求
- 有想法或问题，想要结构化的 PRD
- 需要与团队对齐——要构建什么、为什么构建

**使用方式：**
```
/prd "问题或想法的描述"
```

**示例：**
```
/prd "我需要为应用添加通知系统"
```

AI 会探索项目背景，根据复杂度提出自适应问题，并在 `docs/prd/` 中生成完整 PRD。

---

### `project-starter` - 项目技术定义与引导

**功能：**
- 交互式引导，从零开始完成项目的技术与功能定义
- 从产品愿景到初始结构引导全覆盖
- 分 6 个递进阶段进行自适应提问
- 集成 Context7 MCP，推荐最新的库和工具
- 生成技术决策文档和项目初始结构

**适用场景：**
- 想要有条理地从零启动新项目
- 需要明确技术栈及权衡取舍
- 希望 AI 充当技术架构师，逐步引导
- 需要根据已有决策生成基础项目结构

**使用方式：**
```
/project-starter "项目简短描述"
```

**示例：**
```
/project-starter "面向中小企业的库存管理 SaaS"
/project-starter "酒店预订系统 REST API"
/project-starter "移动端优先的外卖配送应用"
```

**流程：**
1. 项目探索（愿景、用户、复杂度）
2. 高层架构（Monorepo/多仓库、模式、部署）
3. 核心技术栈（框架、DB、ORM、认证、测试）—— 结合 Context7
4. 详细实现（UI、安全、日志、CI/CD）—— 结合 Context7
5. 生成技术决策文档
6. 引导/初始化项目结构

AI 根据分类调整提问深度：MVP（8-12 个问题）、内部产品（12-18 个）、可扩展产品（18-28 个）。

---

### `tauri-react-nest-lan-migration` - Tauri 迁移

**功能：**
- 引导 Web -> 桌面端迁移，适用于 React + NestJS + Postgres 局域网环境的 Tauri 技术栈
- 标准化配置、Sidecar、验证和发布流程
- 减少本地网络、认证和启动中的常见错误

**工作流程：**
1. 规划迁移（`/tauri-migrate-plan`）
2. 实施变更（`/tauri-migrate-implement`）
3. 验证配置/登录/CRUD + 日志（`/tauri-migrate-verify`）
4. 准备交付（`/tauri-migrate-release`）

---

### `agentmd-generator` - 层次化 AGENTS.md 生成器

**功能：**
- 分析仓库结构（单体、Monorepo、多项目）
- 检测技术栈、框架及组件间的自然边界
- 通过自适应提问（带自由选项的多选题）了解需求
- 在提议新技能前先查找并复用现有技能
- 生成根目录及本地 AGENTS.md，最小化上下文消耗

**适用场景：**
- 正在为 AI 辅助开发配置新项目
- AGENTS.md 过于臃肿，需要重新结构化
- Monorepo 需要按组件分离上下文
- 希望每次 AI 会话只加载所需上下文

**使用方式：**
```
/agentmd
```

---

### `sonarqube-quality-gate-playbook` - SonarQube 质量门禁

针对 Node 和 TypeScript 项目（Monorepo 中的 NestJS + React）的迭代式 Playbook，帮助项目达到 SonarQube 质量门禁标准。

---

### `e2e-qa-tester` - E2E/手动 QA 测试

**功能：**
- 使用 Playwright MCP 执行 E2E 和手动 QA 测试
- 验证最新实现的功能
- 自动在 CREDENTIALS.md 中查找凭据
- 执行测试前请求确认

**适用场景：**
- 刚实现了某个功能，想要验证它
- 需要对某个流程进行手动 QA
- 想测试表单、认证或 CRUD

**使用方式：**
```
/qa
```

**流程：**
1. 识别最后完成的任务
2. 在 CREDENTIALS.md 中查找凭据
3. 验证 5173 端口连接
4. 呈现测试计划
5. 执行并报告结果（通过/失败）

---

### `qa` - E2E/QA 别名

`e2e-qa-tester` 的简短别名，执行相同流程，输入更简洁。

**使用方式：**
```
/qa
```

---

### `tauri-migration` - Tauri 迁移别名

`tauri-react-nest-lan-migration` 的简短别名，执行相同的 Web -> 桌面端迁移流程。

**使用方式：**
```
/tauri-migration
```

---

## 安装

### 方式一：安装单个技能

```powershell
# 交互式 Bug 调试
npx skills add AgustinAlbonico/ai-customizations --skill interactive-bug --agent opencode -y

# 交互式任务
npx skills add AgustinAlbonico/ai-customizations --skill interactive-task --agent opencode -y

# Tauri 迁移
npx skills add AgustinAlbonico/ai-customizations --skill tauri-react-nest-lan-migration --agent opencode -y

# E2E QA 测试
npx skills add AgustinAlbonico/ai-customizations --skill e2e-qa-tester --agent opencode -y

# PRD 生成器
npx skills add AgustinAlbonico/ai-customizations --skill prd-creator --agent opencode -y

# AGENTS.md 生成器
npx skills add AgustinAlbonico/ai-customizations --skill agentmd-generator --agent opencode -y

# 项目引导
npx skills add AgustinAlbonico/ai-customizations --skill project-starter --agent opencode -y
```

### 方式二：安装所有技能

```powershell
# 针对特定智能体
npx skills add AgustinAlbonico/ai-customizations --skill '*' --agent opencode -y

# 针对多个智能体
npx skills add AgustinAlbonico/ai-customizations --skill '*' --agent opencode --agent claude-code -y

# 针对所有检测到的智能体
npx skills add AgustinAlbonico/ai-customizations --all
```

### 方式三：列出可用技能

```powershell
npx skills add AgustinAlbonico/ai-customizations --list
```

### 支持的智能体

`opencode`、`codex`、`claude-code`、`cursor`、`antigravity`

## 快速使用

安装后，直接使用以下命令：

```text
/bug "购物车不更新总价"
/task "添加深色模式"
/qa    # 测试最新实现的功能
/prd "我需要一个通知系统"       # 生成交互式 PRD
/agentmd                        # 生成层次化 AGENTS.md
/project-starter "项目描述"     # 引导新项目初始化
```

AI 会根据所需信息，通过多选题或开放题与你进行交互式提问。

## 与智能体无关的安装脚本

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\install-skills.ps1 -Source AgustinAlbonico/ai-customizations -Agents opencode,codex,claude-code
```

以全局模式安装所有智能体的所有技能：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\install-skills.ps1 -Source AgustinAlbonico/ai-customizations -AllAgents -GlobalSkills
```

## 可选的项目引导

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\bootstrap-project.ps1 -ProjectPath "C:\路径\你的项目"
```

## 本地验证

```powershell
npx skills add . --list
```

## 注意事项

- 每个技能必须包含带有有效 YAML frontmatter（`name` + `description`）的 `SKILL.md` 文件
- 本仓库存储 AI 个性化配置，不包含产品代码