adui-skills：实践指南

实际评估adui-skills时，我先确认它解决的具体问题：ADui Skills Pack 是一套面向 AI Coding / Agent 开发的可维护 Skills 集合。实际做软件开发时，经常会碰到依赖、接口和异常处理往往比主路径更影响采用，所以功能列表并不能代替验证。与其反复读介绍，不如在隔离分支完成一个可回滚的小任务，再依据安装步骤、接口契约、测试结果和错误信息做取舍。它对需要可检查开发流程而非单次演示的工程师更有价值，但正式采用前仍要复查许可证、近期提交和问题区回应。

ADui Skills Pack

简体中文 | English | Wiki

当前版本：v0.2.0 Public Preview。 v0.2.x 面向公开试用，Registry/Profile Schema 与安装体验在 v1.0.0 前仍可能继续演进。

ADui Skills Pack 是一套面向 AI Coding / Agent 开发的可维护 Skills 体系，覆盖全栈开发、跨端开发、数据库、Git 交付和 Web 3D/GPU。GitHub 是唯一事实源，CNB 为国内只读同步镜像。

ADui Skills Pack

GitHub 主仓库：

https://github.com/adui-studio/adui-skills

CNB 国内镜像：

https://cnb.cool/adui-studio/adui-skills

skills.sh Pack：

https://www.skills.sh/p/DCh7RQegkqCXcXn8

一键安装 Pack：

npx skills add https://skills.sh/p/DCh7RQegkqCXcXn8

核心能力

第三方 Skill                ADui 自研 Skill
    │                            │
    ├─ Registry                 ├─ adui-stack-router
    ├─ Folder Hash Lock         ├─ adui-feature-dev
    └─ Daily Update            ├─ adui-viteplus
             │                  ├─ adui-nestjs-prisma
             │                  ├─ adui-3d-architecture
             │                  ├─ adui-webgl2
             │                  └─ adui-tauri-v2
             │
             └──────── Profiles ─────────┐
                                         ↓
                              按项目技术栈按需组合

当前数据：

• Registry：84 条记录
• 启用并参与跟踪：82 个第三方 Skill
• Profiles：29 个
• ADui 自研核心 Skills：7 个

快速开始

校验仓库：

npm run validate
npm test

检测项目技术栈：

npm run detect:stack -- .

Profile 一键安装：

npm run profile:list
npm run profile:plan -- vue unocss git --agent codex
npm run profile:install -- vue unocss git --agent codex --pm pnpm

根据目标项目自动识别技术栈和 npm / pnpm / yarn / bun：

npm run profile:auto-install -- D:\Projects\my-app --agent codex --dry-run

每日 skills.sh 分类排行与 Pack 精选

仓库会每日从 skills.sh 按分类搜索候选，并结合安装量、GitHub Stars 与可用的安全审计结果做筛选：

skills.sh 分类搜索
      ↓
按 installs 排序
      ↓
GitHub Stars / Audit 门禁
      ↓
排除 Pack 已有 Skill
      ↓
排除历史已选 Skill
      ↓
每分类选择一个最优新候选
      ↓
append-only 候选历史
      ↓
自动生成 PR，人工 Review

候选历史采用 append-only：不会删除、替换或覆盖之前已经选择的 Skill。

skills.sh 今日分类排行榜

每日自动更新。最近一次排行：2026-10-04 · 查看完整 Top 10 排行 · ADui Skills Pack

排行展示与 Pack 候选选择是两件事：排行榜每日刷新；候选仍遵循 append-only，不删除、不替换已有 Skill。

本地预览：

npm run pack:ranking

写入候选状态：

npm run pack:ranking:apply

skills.sh 当前公开文档没有提供稳定的 Pack 成员写入 API，因此自动化负责发现、排行、质量门禁、去重、选择与 PR；最终把新候选加入现有 Pack 仍需要在 skills.sh Pack 管理页确认。不会使用未公开内部接口、浏览器 Cookie 或长期登录会话绕过这一限制。

详细说明见 skills.sh 每日分类排行。

第三方 Skill 更新

第三方 Skill 不复制源码，只在 Registry 中记录来源，并使用 Skill 目录 Git tree SHA (skillFolderHash) 做审核锁定。

npm run updates:check
npm run updates:apply

第三方 Registry 更新与 Pack 候选变更仍然只通过 PR Review，永远不会自动合并；排行榜展示页则由每日 Workflow 自动刷新。

文档

详细文档统一从 GitHub Wiki 阅读：

• Wiki 首页
• 使用方法
• Profile 一键安装器
• skills.sh 每日分类排行
• skills.sh 最新完整榜单
• 功能开发规范
• 总体架构
• Vite+ 工程规范
• NestJS + Prisma 集成规范
• 3D / GPU 架构
• WebGL2 工程规范
• Tauri v2 工程规范
• 维护与每日更新
• 安全规范
• 发布流程

仓库内 docs/*.md 仍是 Wiki 的唯一事实源；Wiki 由 GitHub Actions 自动同步。英文文档使用对应 -EN Wiki 页面作为兜底。