Agent Skills
› modu-ai/moai-adk
modu-ai/moai-adk
GitHubLSEL本地自我进化循环的聚类与过滤引擎，处理工具失败日志。通过脚本和AI筛选噪音、聚类事件并评分，为后续提案和应用提供候选数据，当前版本仅执行排水和聚类阶段。
Install All Skills
npx skills add modu-ai/moai-adk --all -g -y
Skills in Collection (58)
Showing top 50 of 58 by quality score. Use the install list command or open individual skills for the rest.
LSEL本地自我进化循环的聚类与过滤引擎，处理工具失败日志。通过脚本和AI筛选噪音、聚类事件并评分，为后续提案和应用提供候选数据，当前版本仅执行排水和聚类阶段。
需要清理和分类 .moai/lessons-inbox.jsonl 中的工具失败记录
需要生成基于事件聚类的改进建议候选集
npx skills add modu-ai/moai-adk --skill hns-lsel-curator -g -y
提供moai-adk-go本地开发参考，涵盖版本管理、发布流程、Shell Hook开发及构建命令。用于特定任务时加载以节省上下文。
执行版本管理与发布流程
开发或调试Shell脚本Hook
执行项目构建与测试命令
npx skills add modu-ai/moai-adk --skill hns-moaiadk-dev-reference -g -y
定义 oss-docs 多语言文档编辑的硬性规则，涵盖韩英日中四语同步、Mermaid 图表限制、图标替代 Emoji、URL 黑名单及 Vercel 重定向配置等规范。
用户请求修改或检查多语言文档内容
用户询问 i18n 相关的排版与发布规范
用户进行 README 或 docs-site 的本地化工作
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules -g -y
规范多语言README文件的同步流程，以韩文为源文件，衍生英日中版本。包含切换器头部契约、章节顺序一致性检查清单及手动验证步骤，确保文档内容准确且格式统一。
需要同步更新多语言README文件时
进行文档本地化或翻译工作
npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync -g -y
提供 docs-site Hugo 站点的完整结构映射，涵盖配置、多语言内容、侧边栏菜单及图标耦合规则。用于指导导航与配置编辑，确保 i18n 一致性和部署正确性。
需要理解或修改文档站点目录结构
编辑 Hugo 配置文件或多语言元数据
更新侧边栏菜单项或关联 SVG 图标
处理页面重定向配置
npx skills add modu-ai/moai-adk --skill hns-oss-docs-structure-map -g -y
文档构建验证技能，执行Hugo构建、Sitemap检查、URL黑名单扫描、Mermaid方向校验及多语言章节一致性比对，作为发布前的强制退出门禁。
需要验证文档站点构建是否通过
检查多语言内容一致性
执行发布前质量门禁
npx skills add modu-ai/moai-adk --skill hns-oss-docs-verify -g -y
自动化 CI 监控与修复技能，轮询 GitHub PR 检查，分类失败原因并尝试自动修补，处理超时和语义错误升级。
/moai sync Phase 4 创建 PR 后
需要监控现有 PR 的 CI 状态时
npx skills add modu-ai/moai-adk --skill hns-workflow-ci-loop -g -y
后端开发专家技能，涵盖API设计、数据库集成、微服务架构及安全模式。适用于后端逻辑实现、认证授权及性能优化等场景。
后端API设计与实现
数据库集成与优化
微服务架构搭建
后端安全策略实施
npx skills add modu-ai/moai-adk --skill moai-domain-backend -g -y
数据库领域专家技能，覆盖PostgreSQL、MongoDB、Redis等。用于模式设计、查询优化、索引策略及云数据库选型。
设计数据库模式和数据结构
优化SQL或NoSQL查询性能
制定缓存或分片策略
选择云数据库平台
npx skills add modu-ai/moai-adk --skill moai-domain-database -g -y
前端开发专家技能，涵盖 React 19、Next.js 16 和 Vue 3.5 等现代框架。用于构建 Web UI、实现组件架构、优化前端性能及集成状态管理。
构建现代 Web 应用界面
创建或维护组件库
优化前端加载与渲染性能
实现复杂的状态管理逻辑
npx skills add modu-ai/moai-adk --skill moai-domain-frontend -g -y
AI文本人性化与润色专家，检测并去除AI痕迹，保留原意、事实和数据。支持中日英韩多语言，涵盖散文与营销文案场景，提供严格的质量分级和防过度编辑保护机制。
需要去除AI生成文本的机械感或特定模式
对已有内容进行自然化润色以符合人类写作风格
检查文本是否包含明显的AI特征标记
npx skills add modu-ai/moai-adk --skill moai-domain-humanize -g -y
用于生成可编辑的SVG技术信息图，通过数值计算布局并渲染为PNG。提供路由规则以区分Mermaid与SVG的使用场景，确保单一来源维护。
需要像素级控制的位置、间距或分层要求
自由形式的架构或概念信息图
需要精确CJK文本换行的场景
面向幻灯片、邮件或离线阅读的静态图像交付
npx skills add modu-ai/moai-adk --skill moai-domain-svg-infographic -g -y
提供 Claude Code 扩展开发参考，涵盖 Skills、插件、命令、钩子及高级 Agent 模式等核心功能与配置指南。
创建或管理 Claude Code 扩展
配置 Claude Code 高级功能
开发自定义插件或子代理
npx skills add modu-ai/moai-adk --skill moai-foundation-cc -g -y
提供MoAI-ADK开发的核心原则与架构模式，包括TRUST 5质量框架、SPEC-First DDD工作流、代理委派模式及Token预算优化。用于指导新Agent创建、技能开发、复杂工作流编排和质量门禁配置。
需要遵循TRUST 5质量规范
使用SPEC-First DDD方法进行领域驱动设计
规划Token预算和上下文窗口优化
创建新Agent或Skill时的结构指导
复杂工作流的编排与协调
npx skills add modu-ai/moai-adk --skill moai-foundation-core -g -y
提供MoAI质量模型背景，涵盖TRUST 5原则及通过Agent、Harness和命令实现的代码审查、质量门禁检查与合规性评估机制。
代码审查
质量门禁检查
覆盖率目标设定
TRUST 5合规性评估
npx skills add modu-ai/moai-adk --skill moai-foundation-quality -g -y
结构化思维工具包，整合批判性评估、发散收敛和深度提问三大框架，用于创意构思、战略分析、架构决策及复杂问题的深度推理。
需要评估提案或建议的合理性
针对开放式问题进行方案生成
探索陌生领域或澄清模糊需求
进行复杂的架构或战略决策
npx skills add modu-ai/moai-adk --skill moai-foundation-thinking -g -y
协调Harness学习子系统，生成Tier4自动更新提案负载供编排器处理。支持状态检查、应用提案及回滚流程，实现CLI与用户交互间的自动化更新管理。
检查Harness状态和待处理提案
加载并应用下一个待处理的自动更新提案
执行快照回滚操作
禁用或启用学习功能
npx skills add modu-ai/moai-adk --skill moai-harness-learner -g -y
Kanban看板调度器单次迭代，自动监控待办队列，将已选任务分派给隔离工作节点执行并收集结果证据。该技能用于实现无人值守的自动化工作流循环，严格限制并发写入与集成操作，确保任务安全分发与状态追踪。
启动/loop循环进行单次迭代
需要无人值守地分发和跟踪看板任务
npx skills add modu-ai/moai-adk --skill moai-kanban-foreman -g -y
废弃的7阶段元工具重定向至v4构建器。保留旧版作为向后兼容入口，引导用户通过自然语言请求使用新的4阶段动态工作流生成Harness。
调用已弃用的moai-meta-harness命令
需要创建新的Harness但使用了旧路径
npx skills add modu-ai/moai-adk --skill moai-meta-harness -g -y
提供REST/GraphQL API设计模式、错误处理规范及输入验证参考，用于后端开发中的API设计与代码审查。
设计API接口
实现后端端点
审查后端代码
npx skills add modu-ai/moai-adk --skill moai-ref-api-patterns -g -y
用于多模型代码审查收敛，通过audit_multi MCP工具并行调用Codex和GLM后端，结合Claude结果生成综合审计结论。
项目配置为多模型审计模式
需要聚合多个AI模型的代码审查意见
npx skills add modu-ai/moai-adk --skill moai-ref-cross-model-audit -g -y
提供Git工作流、分支策略、提交规范及PR模板参考，辅助Agent执行标准化的版本控制操作。
需要遵循特定Git分支策略
生成符合规范的Commit Message
创建或审查Pull Request
npx skills add modu-ai/moai-adk --skill moai-ref-git-workflow -g -y
提供OWASP Top 10 API安全、认证模式及HTTP头防护的参考清单，用于辅助后端实现与安全审计工作流，确保生产级安全规范。
后端API安全审计
身份验证实现检查
安全配置审查
npx skills add modu-ai/moai-adk --skill moai-ref-owasp-checklist -g -y
提供React/Next.js组件设计模式、状态管理策略及项目结构参考，涵盖复合组件、自定义钩子、容器/展示分离等生产级前端规范。
需要设计React或Next.js组件时
进行前端状态管理选型时
规划前端项目目录结构时
npx skills add modu-ai/moai-adk --skill moai-ref-react-patterns -g -y
提供测试金字塔策略、覆盖率目标及AAA等高质量测试模式参考，辅助开发者进行单元测试、集成测试和E2E测试的创建与质量验证。
制定测试计划或选择测试策略
编写单元测试或集成测试代码
分析测试覆盖率并优化测试用例
npx skills add modu-ai/moai-adk --skill moai-ref-testing-pyramid -g -y
提供前端UI打磨的详细规范，涵盖几何对齐、阴影层级、动效缓动及排版细节。旨在指导Agent在组件实现和代码审查中提升界面精致度，确保视觉一致性与交互流畅性，避免通用感设计。
前端UI组件实现
UI设计审查
界面视觉优化
npx skills add modu-ai/moai-adk --skill moai-ref-ui-polish -g -y
DDD重构工作流，通过ANALYZE-PRESERVE-IMPROVE循环对遗留代码进行行为保留的重构，降低技术债务。适用于现有代码库的结构优化、API迁移及现代化改造，确保重构前后功能与行为完全一致。
重构遗留代码
在不改变行为的前提下改进代码结构
减少生产系统的技术债务
处理API迁移和弃用
npx skills add modu-ai/moai-adk --skill moai-workflow-ddd -g -y
用于审查公共文档（如README、发布说明）中的声明是否由用户提供的证据支持。通过预检、分类和验证，将复合声明拆分为原子项并标记，仅读取不执行命令或生成修复。
需要验证文档声明准确性
检查README或发布说明的证据支持
npx skills add modu-ai/moai-adk --skill moai-workflow-docs-claim-check -g -y
Ralph Engine自动化反馈循环，集成LSP诊断、AST-grep扫描与测试验证，实现代码质量持续改进、自动修复及错误驱动开发工作流。
需要自动化代码质量检查
实施错误驱动的持续修复流程
配置CI/CD中的代码扫描环节
npx skills add modu-ai/moai-adk --skill moai-workflow-loop -g -y
集成项目管理技能，涵盖文档生成、多语言初始化及模板优化。支持自动检测项目类型、SPEC驱动文档更新及性能调优，为Claude Code提供统一的项目生命周期管理入口。
需要生成或更新项目文档
初始化多语言配置
优化项目模板性能
npx skills add modu-ai/moai-adk --skill moai-workflow-project -g -y
管理MoAI-ADK开发的SPEC工作流，支持GEARS/EARS格式需求定义、验收标准制定及Plan-Run-Sync集成。
创建SPEC文档
定义验收标准
需求澄清与分析
npx skills add modu-ai/moai-adk --skill moai-workflow-spec -g -y
基于 RED-GREEN-REFACTOR 循环的测试驱动开发工作流，指导先写失败测试再实现代码，适用于从零开始的新功能开发。
需要从零开始开发新功能
行为规范驱动实现过程
构建无依赖的隔离模块
定义新 API 端点或 UI 组件
npx skills add modu-ai/moai-adk --skill moai-workflow-tdd -g -y
提供开发工作流专家技能，涵盖DDD测试、AI调试、性能优化、自动化代码审查及CI/CD质量门禁。支持遗留系统行为快照与绿field规范测试，结合TRUST 5框架进行多维度质量评估，确保重构时的行为保留与代码质量。
编写单元测试或集成测试
测量代码覆盖率
运行性能分析或基准测试
执行PR代码审查
进行遗留代码重构前的行为验证
npx skills add modu-ai/moai-adk --skill moai-workflow-testing -g -y
管理 Git worktree 以支持并行 SPEC 开发，提供隔离工作区、自动分支注册及与 MoAI-ADK 的无缝集成，适用于多任务并行和代码审查场景。
需要并行开发多个功能模块
设置隔离的代码审查环境
创建实验性特性分支
npx skills add modu-ai/moai-adk --skill moai-workflow-worktree -g -y
MoAI 统一编排器，用于自主开发。通过路由自然语言或子命令（如 plan, run, fix 等）至专用智能体，协调复杂的开发工作流与多阶段任务执行。
需要自动规划或执行开发任务
请求代码修复、审查或端到端测试
启动多智能体协作的开发流程
npx skills add modu-ai/moai-adk --skill moai -g -y
Electron 33+桌面应用开发专家，涵盖主渲染进程架构、IPC通信、自动更新及打包。适用于跨平台桌面应用构建与配置。
检测到electron.vite.config.ts或electron-builder.yml文件
用户请求开发桌面应用程序
需要实现IPC通信模式
npx skills add modu-ai/moai-adk --skill moai-framework-electron -g -y
专注 Auth0、Clerk 和 Firebase Auth 三大平台的认证与授权专家，提供 MFA、SSO、WebAuthn 等安全功能的实现指导。
需要实现用户认证或授权功能
选择身份验证平台（Auth0/Clerk/Firebase）
配置多因素认证、单点登录或社交登录
涉及 WebAuthn 或 Passkeys 集成
npx skills add modu-ai/moai-adk --skill moai-platform-auth -g -y
Chrome扩展Manifest V3开发专家，涵盖服务worker、内容脚本、消息传递及API使用。用于构建浏览器扩展，支持从开发到Web Store发布的完整流程。
检测到manifest.json且版本为3
需要构建或维护Chrome浏览器扩展
npx skills add modu-ai/moai-adk --skill moai-platform-chrome-extension -g -y
提供Vercel、Railway和Convex三大部署平台的选型指南与配置方案，涵盖应用类型匹配、基础设施需求分析及常见部署模式，辅助完成应用的持续集成与服务器端部署。
选择部署平台
配置CI/CD流水线
设置边缘函数
管理无服务器基础设施
npx skills add modu-ai/moai-adk --skill moai-platform-deployment -g -y
基于意图优先的设计专家技能，涵盖设计方向制定、代码与设计规范审计及构建后批评。用于确立设计意图或审查代码是否符合设计原则。
建立设计意图
根据设计原则审计代码
npx skills add modu-ai/moai-adk --skill moai-design-craft -g -y
设计工具集成专家，涵盖Figma MCP获取设计上下文、Pencil渲染及代码导出。提供shadcn/ui Nova默认风格配置与快速选型指南，支持从设计到React/Tailwind代码的完整工作流。
需要获取Figma设计上下文或组件映射
需要将设计稿渲染为视觉原型
需要将设计导出为React和Tailwind代码
npx skills add modu-ai/moai-adk --skill moai-design-tools -g -y
提供基于 Sphinx、MkDocs、TypeDoc 等工具的技术文档生成模式，支持从代码注释自动生成 API 文档、构建文档站点及自动化更新流程。
从代码注解生成 API 文档
搭建带有搜索导航的文档网站
创建用户指南或技术规格书
在 CI/CD 中自动化文档更新
npx skills add modu-ai/moai-adk --skill moai-docs-generation -g -y
专注UI/UX设计系统专家，涵盖无障碍(WCAG)、图标、主题及设计令牌。用于构建现代组件库、实现企业级可访问界面、设置多平台设计令牌架构及集成图标系统。
构建基于设计系统的UI组件库
实现符合WCAG标准的无障碍用户界面
配置多平台设计令牌架构
集成图标系统
创建支持暗模式的定制主题系统
npx skills add modu-ai/moai-adk --skill moai-domain-uiux -g -y
管理多智能体工作流的上下文窗口优化、会话状态持久化及200K Token预算分配。支持会话切换、渐进式文件加载及MCP集成，解决长流程中的上下文限制与状态保持问题。
多智能体协作与上下文交接
Token预算接近150K或180K阈值
长运行工作流的状态保存与恢复
npx skills add modu-ai/moai-adk --skill moai-foundation-context -g -y
整合第一性原理、设计思维与系统工程的结构化战略思考框架，用于架构决策、根因分析及复杂问题解决，强调深度分析与假设审计。
架构决策
技术选型
根因分析
重大长期影响决策
npx skills add modu-ai/moai-adk --skill moai-foundation-philosopher -g -y
云数据库平台专家技能，涵盖 Neon、Supabase 和 Firebase Firestore。提供技术选型指南、功能对比及用例匹配建议，辅助开发者根据需求选择合适的云服务。
选择或配置云数据库
比较不同数据库平台特性
确定 SQL 与 NoSQL 适用场景
npx skills add modu-ai/moai-adk --skill moai-platform-database-cloud -g -y
SVG创建、优化与变换专家，提供矢量图形生成、SVGO压缩、图标系统构建及动画实现等全流程开发模式。
创建矢量图形
优化SVG文件
实现图标系统
构建数据可视化
添加SVG动画
npx skills add modu-ai/moai-adk --skill moai-tool-svg -g -y
基于用户意图和项目上下文，按需发现、加载并缓存相关文档的即时系统。通过搜索本地和在线资源提供技术实现指导。
用户询问具体技术问题
对话中检测到技术关键词
需要领域专业知识完成任务
需要实施指导
npx skills add modu-ai/moai-adk --skill moai-workflow-jit-docs -g -y
企业级模板管理系统，提供代码脚手架、反馈模板及项目优化工作流。支持多框架快速启动、标准化结构生成、版本管理及备份恢复，旨在提升开发效率与一致性。
创建新项目或功能模块
生成代码脚手架文件
管理模板版本和自定义配置
优化项目结构
npx skills add modu-ai/moai-adk --skill moai-workflow-templates -g -y
通过 MCP 工具实现分步推理，用于复杂问题分析、架构决策及技术选型。
显式使用 --deepthink 标志
需要分解复杂问题或进行多步骤规划
npx skills add modu-ai/moai-adk --skill moai-workflow-thinking -g -y
