mc-skills/catalog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
catalog/repos/agustinalbonico--ai-customizations.md

8.6 KiB
Raw Permalink Blame History

AI个性化技能库

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

ai-customizations

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

架构

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

安装

方式一：安装单个技能

# 交互式 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

方式二：安装所有技能

# 针对特定智能体
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

方式三：列出可用技能

npx skills add AgustinAlbonico/ai-customizations --list

支持的智能体

opencode、codex、claude-code、cursor、antigravity

快速使用

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

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

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

与智能体无关的安装脚本

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

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

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

可选的项目引导

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

本地验证

npx skills add . --list

注意事项

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