Agent Skills
› modu-ai/moai-adk
modu-ai/moai-adk
GitHubLSEL局部进化循环的聚类与过滤引擎，用于清理工具失败日志。通过drain.sh剔除噪声并聚类事件，结合AI评估重要性，为后续提议和应用阶段提供候选数据。
Install All Skills
npx skills add modu-ai/moai-adk --all -g -y
Skills in Collection (59)
Showing top 50 of 59 by quality score. Use the install list command or open individual skills for the rest.
LSEL局部进化循环的聚类与过滤引擎，用于清理工具失败日志。通过drain.sh剔除噪声并聚类事件，结合AI评估重要性，为后续提议和应用阶段提供候选数据。
处理lessons-inbox.jsonl中的工具失败记录
需要清洗和聚类历史错误以生成改进建议时
npx skills add modu-ai/moai-adk --skill hns-lsel-curator -g -y
moai-adk-go本地开发参考，涵盖版本管理、Shell Hook开发与构建命令。提供版本注入、发布流程及Hook配置规范，用于加速特定开发任务。
执行项目版本发布或打标签操作时
开发或调试Shell脚本Hook功能时
需要查询Makefile构建或测试命令时
npx skills add modu-ai/moai-adk --skill hns-moaiadk-dev-reference -g -y
针对oss-docs多语言文档的硬编码规范，涵盖4语种同步更新、Mermaid图表限制、图标与强调符格式及URL黑名单等规则。
编辑多语言README或docs-site内容
执行国际化文档审查
检查本地化一致性
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules -g -y
规范 README 多语言同步流程，以韩语为源文件生成英日中版本，维护统一切换头与章节结构一致性，提供手动校验清单确保内容对齐。
需要更新或创建多语言 README 文档
执行 README 文件的翻译与同步任务
npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync -g -y
提供 Hugo geekdoc 站点结构映射，涵盖配置、多语言内容、侧边栏菜单及图标耦合规则。用于在导航或配置编辑前加载，确保元数据一致性和部署正确性。
编辑 Hugo 站点配置文件
修改多语言内容结构
更新侧边栏菜单或图标
处理页面重定向
npx skills add modu-ai/moai-adk --skill hns-oss-docs-structure-map -g -y
用于验证文档站点构建质量的多语言一致性检查技能，涵盖Hugo构建、URL黑名单、Mermaid方向及四语种文件与章节数量对齐。
需要验证文档站点构建是否成功且无警告
检查多语言内容的一致性和完整性
npx skills add modu-ai/moai-adk --skill hns-oss-docs-verify -g -y
CI自动修复循环技能，监控PR检查并尝试自动修复机械性失败，最多3次迭代后升级语义错误。
/moai sync Phase 4 PR创建完成
需要持续监控现有PR的CI状态
npx skills add modu-ai/moai-adk --skill hns-workflow-ci-loop -g -y
专注于后端开发的专家技能，涵盖API设计、数据库集成、微服务架构及安全性能优化。适用于构建REST/GraphQL接口、管理PostgreSQL/MongoDB数据、实现分布式系统及提升系统可扩展性。
设计或实现后端API
进行数据库设计与集成
构建微服务架构
优化后端性能与缓存
npx skills add modu-ai/moai-adk --skill moai-domain-backend -g -y
数据库领域专家技能，涵盖PostgreSQL、MongoDB、Redis等主流数据库。支持模式设计、查询优化、索引策略、数据建模及云数据库选型，适用于构建可扩展的数据架构和性能调优。
数据库模式设计
SQL查询优化
缓存策略实现
多数据库架构搭建
数据迁移与监控
npx skills add modu-ai/moai-adk --skill moai-domain-database -g -y
前端开发专家技能，覆盖 React 19、Next.js 16、Vue 3.5 及现代 UI/UX 模式。用于构建 Web UI、实现组件、优化前端性能、集成状态管理及遵循 Vercel 最佳实践。
构建现代 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技术信息图及2x PNG。通过数值计算布局，支持CJK字体与确定性代码检查，需Node和Chromium环境渲染。
需要像素级控制的架构图
制作幻灯片或邮件用的静态图片
CJK文本需精确换行的场景
npx skills add modu-ai/moai-adk --skill moai-domain-svg-infographic -g -y
提供 Claude Code 扩展开发的全方位参考，涵盖 Skills、子代理、插件、命令、钩子及沙箱等核心功能的创建与管理指南。
创建或配置 Claude Code 扩展
设计 Agent 高级架构模式
npx skills add modu-ai/moai-adk --skill moai-foundation-cc -g -y
提供MoAI-ADK开发核心原则，包括TRUST 5质量框架、SPEC-First DDD工作流、代理委派模式及Token预算管理等。用于指导新Agent创建、技能开发、复杂工作流编排及代码质量标准配置。
需要遵循MoAI开发规范
配置代码质量门禁
规划Token预算
设计Agent协作流程
npx skills add modu-ai/moai-adk --skill moai-foundation-core -g -y
提供MoAI质量模型背景，涵盖TRUST 5原则、自动化检查机制及3级验证流程。用于指导代码审查、质量门禁检查、覆盖率目标设定及合规性评估，确保代码符合高质量标准。
进行代码审查或评审
执行质量门禁检查
评估代码对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 学习子系统，生成 Tier 4 自动更新提案载荷供编排器处理，并管理应用与回滚流程。
检查学习状态或待处理提案
加载并生成自动更新提案载荷
执行应用或回滚操作
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构建器，提供向后兼容。用于处理旧版工作流调用，引导用户转向基于清单的动态工作流运行器和编排器直接构建的新范式。
用户尝试使用已废弃的7阶段元工作流创建Harness
系统需要为遗留调用路径提供向后兼容的重定向入口
npx skills add modu-ai/moai-adk --skill moai-meta-harness -g -y
提供REST/GraphQL API设计模式、错误处理及输入验证参考，辅助后端开发人员进行API实现与代码审查。
设计RESTful API接口
实现API端点逻辑
审查后端API代码规范
npx skills add modu-ai/moai-adk --skill moai-ref-api-patterns -g -y
该 Skill 用于多模型代码审计收敛，通过调用 audit_multi MCP 工具并行分发至 Codex 和 GLM 后端，并与当前会话的 Claude 审计结果进行比对融合，最终输出综合结论及分歧标记。
项目配置启用 multi 模式的多模型代码审计
需要并行调用多个 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 API安全Top10、认证及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等测试模式参考，辅助开发者进行高质量测试创建与质量验证。
制定测试计划或策略
编写单元测试或集成测试
分析代码覆盖率
优化测试执行效率
npx skills add modu-ai/moai-adk --skill moai-ref-testing-pyramid -g -y
提供UI细节打磨参考，涵盖几何对齐、层级阴影及动效规范，辅助前端Agent提升界面精致度与一致性。
前端组件实现时的视觉细节优化
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、发布说明）中的声明是否有证据支持。通过提取原子声明并标记，验证其真实性，不执行命令或生成修复代码。
需要验证文档准确性
审查发布说明或指南的真实性
npx skills add modu-ai/moai-adk --skill moai-workflow-docs-claim-check -g -y
Ralph Engine 自动化反馈循环，集成 LSP 诊断、AST-grep 扫描和测试验证，实现代码质量持续改进与自动修复。
实现零错误目标的功能开发
自动化代码质量提升
错误驱动的开发模式
npx skills add modu-ai/moai-adk --skill moai-workflow-loop -g -y
集成项目管理技能，涵盖文档生成、多语言初始化和模板优化。支持自动项目检测、多语言文档管理及性能优化，面向Claude Code代理，实现从初始化到维护的全生命周期自动化管理。
需要初始化新项目并配置文档和语言设置
需要基于SPEC生成或更新多语言文档
需要对现有项目模板进行性能分析和优化
npx skills add modu-ai/moai-adk --skill moai-workflow-project -g -y
提供基于GEARS/EARS格式的需求规范定义、模板生成及Plan-Run-Sync工作流集成，支持并行开发与质量门禁。
创建需求规格文档
定义验收标准
编写SPEC文件
npx skills add modu-ai/moai-adk --skill moai-workflow-spec -g -y
TDD工作流技能，指导基于RED-GREEN-REFACTOR循环的测试驱动开发。适用于从零开始构建新功能、新API或UI组件，强调先写失败测试再实现代码，确保行为规范驱动开发。
从零开发新功能
使用测试驱动开发模式
创建新模块或API
npx skills add modu-ai/moai-adk --skill moai-workflow-tdd -g -y
综合开发工作流专家，涵盖DDD测试、AI调试、性能优化、自动化代码审查及CI/CD质量门禁。支持遗留代码行为快照与绿色场规范测试，通过TRUST 5框架评估代码质量，辅助重构与PR审核。
编写单元测试或集成测试
进行代码重构前的行为验证
执行PR代码审查
分析程序错误并定位原因
检测系统性能瓶颈
npx skills add modu-ai/moai-adk --skill moai-workflow-testing -g -y
用于管理Git worktree，为SPEC开发提供隔离工作区、自动注册和同步，支持多任务并行开发与MoAI-ADK集成。
设置并行开发环境
创建隔离的SPEC工作区
管理多个特性分支
npx skills add modu-ai/moai-adk --skill moai-workflow-worktree -g -y
MoAI统一编排器，根据自然语言或子命令路由至专用智能体，支持团队/单人模式及多种工作流。本次变更增加了todo路由的启用标志控制，并添加回归测试以验证功能。
用户输入moai相关子命令（如plan, run, sync等）
需要自动路由开发任务给特定智能体
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 及社交登录等安全功能，提供平台选型指导与安全合规建议。
需要选择身份认证平台
实现多因素认证或单点登录
集成 WebAuthn 或社交登录
处理令牌安全与合规性
npx skills add modu-ai/moai-adk --skill moai-platform-auth -g -y
Chrome扩展Manifest V3开发专家，覆盖Service Worker、内容脚本、消息传递及Web Store发布。用于构建现代浏览器扩展，处理API调用与安全模型。
检测manifest.json中manifest_version为3的项目
涉及Chrome扩展的Service Worker或Content Script开发
需要配置chrome.* API或声明权限
npx skills add modu-ai/moai-adk --skill moai-platform-chrome-extension -g -y
Vercel、Railway和Convex部署平台专家，指导应用选型、基础设施配置及CI/CD设置。
选择云服务商
配置服务器less环境
设置持续部署
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 MCP进行视觉渲染及原型制作，以及将设计导出为React/Tailwind代码。默认采用shadcn/ui Nova风格，辅助前端开发实现高保真UI还原。
从Figma文件提取设计上下文或组件映射
使用Pencil进行快速UI原型设计和视觉渲染
将设计稿转换为React和Tailwind CSS代码
npx skills add modu-ai/moai-adk --skill moai-design-tools -g -y
提供使用 Sphinx、MkDocs、TypeDoc 等工具生成技术文档、API 文档及静态站点的模式与实现指南，支持从代码注释自动生成文档及 CI/CD 自动化流程。
需要生成 API 文档
构建技术文档站点
自动化文档更新工作流
npx skills add modu-ai/moai-adk --skill moai-docs-generation -g -y
专注于企业级 UI/UX 设计系统，涵盖 WCAG 无障碍合规、原子化组件架构、多平台设计令牌及主题系统。适用于构建现代化前端界面、集成图标库及实现深色模式等用户体验优化任务。
构建现代 UI 组件库
实施无障碍访问标准
设置设计令牌架构
创建可定制的主题系统
npx skills add modu-ai/moai-adk --skill moai-domain-uiux -g -y
管理多智能体工作流的上下文窗口优化、会话状态持久化及200K令牌预算分配，支持会话交接与渐进式披露。
多智能体协作场景
长时运行工作流
上下文窗口接近限制
会话状态持久化需求
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。用于根据需求（如Serverless、实时同步、离线缓存、向量搜索等）选择或配置合适的云数据库服务。
选择云数据库
设置云数据库
比较Neon Supabase Firestore
npx skills add modu-ai/moai-adk --skill moai-platform-database-cloud -g -y
SVG创建、优化与变换专家，涵盖矢量图形生成、SVGO压缩、图标系统构建、数据可视化及动画实现，提供从基础形状到复杂图形的完整开发模式。
创建或编辑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
企业级模板管理系统，提供代码样板、反馈模板及项目优化工作流。支持多框架脚手架生成、GitHub Issue 模板管理及版本控制，用于加速开发并保持一致性。
创建新项目或功能脚手架
生成代码样板文件
管理模板版本与备份恢复
使用 /moai:9-feedback 创建 GitHub Issue
npx skills add modu-ai/moai-adk --skill moai-workflow-templates -g -y
基于 --deepthink 标志的序列思维技能，通过 MCP 工具进行结构化分步分析。适用于复杂问题拆解、架构决策及多方案权衡，支持迭代修订与分支思考，确保逻辑严密性。
显式包含 --deepthink 标志
需要分解复杂问题或进行架构设计
npx skills add modu-ai/moai-adk --skill moai-workflow-thinking -g -y
