Agent Skills
› modu-ai/moai-adk
modu-ai/moai-adk
GitHubLSEL本地自我进化循环的聚类与排水引擎。通过drain.sh脚本过滤Bash超时等噪音，对工具失败日志进行事件键聚类和频率筛选，生成重要性评分候选集，用于闭环缺陷治理。
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脚本过滤Bash超时等噪音，对工具失败日志进行事件键聚类和频率筛选，生成重要性评分候选集，用于闭环缺陷治理。
处理lessons-inbox中的工具失败日志
执行数据清洗与聚类分析
生成自我进化候选建议
npx skills add modu-ai/moai-adk --skill hns-lsel-curator -g -y
提供moai-adk-go本地开发参考，涵盖版本管理、Shell Hook脚本开发及构建命令。指导如何同步版本信息、配置Hook及执行编译测试，旨在节省上下文并规范开发流程。
进行项目版本发布或打标签
开发或调试Shell Hook脚本
查询或执行构建与测试命令
npx skills add modu-ai/moai-adk --skill hns-moaiadk-dev-reference -g -y
定义多语言文档协作规范，涵盖本地化链、同步更新、图表与格式限制及URL版本管理。
多语言文档编辑
国际化规则检查
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文档站点的文件结构、多语言配置及菜单映射规范，重点说明图标与SVG的耦合校验、Vercel重定向规则及构建检查流程，辅助开发者正确编辑导航和配置。
需要修改文档站点侧边栏菜单结构
添加或更新多语言内容元数据
配置页面重定向规则
调整导航图标及其对应的SVG显示
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
自动监控 GitHub PR CI 检查，区分必须与辅助失败，对机械性失败执行最多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 API
数据库设计与优化
微服务架构实施
后端安全与认证
npx skills add modu-ai/moai-adk --skill moai-domain-backend -g -y
数据库领域专家技能，涵盖PostgreSQL、MongoDB、Redis、Oracle及云平台。用于架构设计、查询优化、索引策略、数据建模及多库混合架构选型与实现。
数据库模式设计与数据建模
查询性能优化与索引策略制定
缓存策略实施与分布式系统协调
多数据库混合架构选型与集成
npx skills add modu-ai/moai-adk --skill moai-domain-database -g -y
前端开发专家技能，涵盖React 19、Next.js 16和Vue 3.5的现代UI/UX模式。用于构建Web界面、实现组件、优化性能及集成状态管理。
构建Web UI
实现前端组件
优化前端性能
集成状态管理
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字体和确定性源码检查。适用于需像素级控制、非标准形状或离线交付的场景，与Mermaid互补。
需要生成静态图片用于演示或邮件
需要自由形式的架构或概念信息图
要求像素级的位置、间距或分层控制
CJK标签需要精确验证宽度的换行
npx skills add modu-ai/moai-adk --skill moai-domain-svg-infographic -g -y
提供 Claude Code 扩展开发的全方位参考，涵盖 Skills、插件、子代理、命令、钩子及配置等核心功能的创建与管理指南。
需要创建或管理 Claude Code Skills
配置 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预算管理及渐进式披露等架构规范。
需要遵循TRUST 5质量标准时
规划SPEC-First DDD工作流时
优化Agent Token预算时
设计模块化系统架构时
npx skills add modu-ai/moai-adk --skill moai-foundation-core -g -y
提供MoAI质量模型背景，涵盖TRUST 5原则及通过Agent、3级Harness和/moai gate的执行机制。用于代码审查、质量门禁检查、覆盖率目标设定及合规性评估。
进行代码审查
执行质量门禁检查
评估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
自动化看板调度器，监控待办队列，将已选任务分派给隔离工作节点执行并收集证据。全程无人值守，禁止人工交互与合并操作，仅负责单次迭代的任务分发与报告生成。
需要自动化执行看板任务分发
运行 /loop 进行无人值守迭代
npx skills add modu-ai/moai-adk --skill moai-kanban-foreman -g -y
废弃的7阶段元工作流技能，现作为重定向入口指向v4 Harness Builder。保留旧内容仅作历史参考和向后兼容，引导用户通过自然语言请求使用新的动态编排构建器创建Harness。
用户尝试使用旧的7阶段元工作流命令
需要向后兼容的历史引用或重定向场景
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
提供多模型代码审计收敛参考，指导 Agent 并行调用 Codex 和 GLM 后端，结合 Claude 结果生成综合审查结论。
执行多模型代码审计
需要整合多个 AI 模型的审查意见
npx skills add modu-ai/moai-adk --skill moai-ref-cross-model-audit -g -y
提供Git工作流参考，涵盖分支策略、命名规范、提交信息及PR模板，辅助Agent执行标准化Git操作。
需要创建或管理Git分支
遵循Conventional Commits规范
生成Pull Request模板
npx skills add modu-ai/moai-adk --skill moai-ref-git-workflow -g -y
提供OWASP Top 10、认证及HTTP安全头部的参考清单，用于增强后端API实现与安全审计工作流中的生产级安全模式。
后端API实现期间的安全检查
执行安全审计或代码审查
npx skills add modu-ai/moai-adk --skill moai-ref-owasp-checklist -g -y
提供React/Next.js组件设计模式、状态管理策略及项目结构参考，适用于前端开发。涵盖复合组件、自定义Hook、容器与展示分离等生产级规范，指导Agent生成高质量前端代码。
需要设计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细节打磨规范，涵盖圆角、阴影、动效等规则，辅助前端开发与设计评审，提升界面精致度。
前端组件实现时的样式优化
UI设计审查与反馈
npx skills add modu-ai/moai-adk --skill moai-ref-ui-polish -g -y
DDD重构工作流，通过ANALYZE-PRESERVE-IMPROVE循环在保持行为不变的前提下优化代码结构、降低技术债务并迁移遗留系统。
重构遗留代码
在不改变功能的情况下改进代码结构
减少生产系统的技术债务
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扫描和测试验证，实现持续代码质量改进。支持自动修复、零错误目标开发及CI工作流，通过迭代纠错直至完成条件满足。
实现带有零错误目标的特性
自动化代码质量改进
错误驱动的开发模式
npx skills add modu-ai/moai-adk --skill moai-workflow-loop -g -y
集成项目管理技能，涵盖文档生成、多语言初始化和模板优化。支持自动项目检测、多语种文档管理及性能调优，统一接口服务于 Claude Code Agent 的项目初始化与维护全生命周期。
需要生成或更新项目文档
初始化项目的多语言支持配置
优化项目模板的性能与结构
npx skills add modu-ai/moai-adk --skill moai-workflow-project -g -y
管理MoAI开发中的SPEC工作流，支持GEARS/EARS格式的需求定义、验收标准及Plan-Run-Sync集成。提供标准化模板、并行开发隔离和质量门禁，适用于创建规格文档和定义需求。
需要编写或定义软件需求规格说明书
制定功能验收标准
使用GEARS或EARS格式描述系统行为
npx skills add modu-ai/moai-adk --skill moai-workflow-spec -g -y
TDD工作流专家，通过RED-GREEN-REFACTOR循环指导测试驱动开发。适用于从零开始构建新功能、新API或UI组件，强调先写测试定义行为再实现代码，确保高质量交付。
需要从零开始开发新功能
使用TDD模式进行开发
行为规范驱动实现
创建新的API端点
npx skills add modu-ai/moai-adk --skill moai-workflow-tdd -g -y
综合开发工作流专家，整合DDD测试、AI调试、性能优化、代码审查及CI/CD质量门禁。支持遗留系统特征测试与新项目规范测试，通过TRUST 5框架保障质量，覆盖从调试到重构的全生命周期管理。
编写测试或测量覆盖率
运行性能分析或PR代码审查
执行TRUST 5质量验证
进行遗留代码重构
npx skills add modu-ai/moai-adk --skill moai-workflow-testing -g -y
用于管理Git worktree，为并行SPEC开发提供隔离工作区、自动注册和同步功能。支持多SPEC同时开发、实验性特性开发及代码审查流程，减少上下文切换开销，实现无缝集成MoAI-ADK工作流。
需要并行开发多个SPEC或特性分支
创建隔离的测试或实验环境
设置独立的代码审查工作区
npx skills add modu-ai/moai-adk --skill moai-workflow-worktree -g -y
MoAI统一编排器，用于自主开发。通过路由自然语言或子命令（如plan、run、review等）至专用智能体，协调多阶段工作流与资源调度，实现自动化代码生成与质量管控。
需要规划或执行复杂开发任务
请求代码审查或修复
启动自动化测试或部署流程
npx skills add modu-ai/moai-adk --skill moai -g -y
Electron 33+桌面应用开发专家，涵盖主渲染进程架构、IPC通信、自动更新及打包。用于构建跨平台桌面应用，支持Vite集成与安全最佳实践。
检测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 等安全功能实现指导及平台选型建议。
实现身份验证或授权逻辑
配置 MFA、SSO 或社交登录
对比 Auth0、Clerk 与 Firebase 平台特性
npx skills add modu-ai/moai-adk --skill moai-platform-auth -g -y
Chrome Manifest V3 扩展开发专家，涵盖 Service Worker、内容脚本、消息传递及 chrome API 使用，支持侧边栏、网络过滤及 Web Store 发布。
检测 manifest.json 且 manifest_version 为 3
涉及 service worker 文件处理
需要配置 content scripts
使用 chrome.* APIs 进行功能开发
npx skills add modu-ai/moai-adk --skill moai-platform-chrome-extension -g -y
部署平台专家技能，涵盖Vercel、Railway和Convex。用于指导应用部署、边缘函数配置、持续集成及Serverless基础设施管理，提供选型决策与常见架构模式。
选择部署平台
配置CI/CD流程
部署Next.js或容器化应用
管理Serverless基础设施
npx skills add modu-ai/moai-adk --skill moai-platform-deployment -g -y
专注于意图优先的设计工艺专家，涵盖设计方向、领域词汇、设计记忆及构建后批判。用于确立设计意图或在规划阶段审计代码与设计原则的一致性。
建立设计意图或探索领域时
执行 /moai review --design 进行设计审计时
执行 /moai review --critique 进行构建后批判时
npx skills add modu-ai/moai-adk --skill moai-design-craft -g -y
设计工具集成专家，指导Figma MCP获取设计上下文、Pencil MCP进行视觉渲染及导出React/Tailwind代码。默认采用shadcn/ui Nova风格，覆盖从设计提取到前端代码生成的完整工作流。
从Figma获取设计上下文或组件映射
将文本描述转换为UI原型或视觉设计
将设计稿导出为React和Tailwind CSS代码
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 组件库
实现无障碍用户界面
设置设计令牌架构
集成图标系统
创建自定义主题系统
npx skills add modu-ai/moai-adk --skill moai-domain-uiux -g -y
管理多智能体工作流的上下文窗口优化、会话状态持久化及200K Token预算分配，支持会话分叉与智能体间交接。
多智能体协作流程
长运行会话Token接近限制
跨会话上下文保持
npx skills add modu-ai/moai-adk --skill moai-foundation-context -g -y
集成第一性原理、设计思维与系统工程的结构化决策框架，用于架构设计、根因分析及复杂技术选型。通过假设审查、根本原因分解和权衡分析，辅助进行高影响力的长期决策。
涉及5个以上文件的架构决策
技术栈或库的选择
性能与维护性的权衡
重构范围评估
破坏性变更考量
npx skills add modu-ai/moai-adk --skill moai-foundation-philosopher -g -y
云数据库平台专家技能，涵盖Neon、Supabase和Firebase Firestore。提供平台对比、决策指南及选型矩阵，辅助在Serverless PostgreSQL、实时功能、离线同步等场景下选择合适的数据库方案。
选择或设置云数据库
比较不同数据库平台特性
根据应用场景进行技术选型
npx skills add modu-ai/moai-adk --skill moai-platform-database-cloud -g -y
SVG创建、优化与转换专家，涵盖矢量图形生成、SVGO压缩、图标系统构建、数据可视化及动画实现，提供从基础形状到复杂图形的完整开发模式。
创建矢量图形
使用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
npx skills add modu-ai/moai-adk --skill moai-workflow-templates -g -y
通过 --deepthink 标志触发，利用 Sequential Thinking MCP 工具进行结构化逐步推理。适用于复杂问题分解、架构决策及多方案权衡等需要深度分析的场景。
显式传入 --deepthink 标志
涉及复杂问题分解或架构设计
npx skills add modu-ai/moai-adk --skill moai-workflow-thinking -g -y
