Agent Skills
› modu-ai/moai-adk
modu-ai/moai-adk
GitHubLSEL集群与过滤引擎，负责从日志中清洗噪音、聚类事件并评估重要性，为自我进化提供候选数据。
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集群与过滤引擎，负责从日志中清洗噪音、聚类事件并评估重要性，为自我进化提供候选数据。
需要清理和聚类系统失败日志时
需要生成自我进化的候选改进项时
npx skills add modu-ai/moai-adk --skill hns-lsel-curator -g -y
提供 moai-adk-go 本地开发参考，涵盖版本管理、发布流程、Shell Hook 脚本开发规范及常用构建命令。旨在优化上下文加载，仅在涉及版本控制、Hook 实现或构建任务时触发。
执行版本发布或打标签
开发或调试 Shell Hook 脚本
运行构建、测试或 linting 命令
npx skills add modu-ai/moai-adk --skill hns-moaiadk-dev-reference -g -y
定义多语言文档本地化的硬性规范，涵盖语言链、同步更新、图表限制及样式规则，确保内容一致性。
执行多语言文档翻译或编辑
检查文档本地化合规性
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 文档站点的结构映射，涵盖配置、内容、菜单及部署路径。指导多语言元数据同步、图标与菜单的强耦合维护，以及 Vercel 重定向规则更新，确保导航配置一致性。
修改 Hugo 站点配置文件
调整多语言内容结构或顺序
新增或修改侧边栏菜单项及图标
处理页面重定向或 URL 变更
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 监控与修复技能，轮询 GitHub PR 检查，分类失败并尝试自动修补，将语义错误升级给用户。
/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开发、PostgreSQL/MongoDB实现、服务发现及缓存策略，解决后端逻辑与架构问题。
需要设计或实现后端API接口
进行数据库模型设计与优化
构建微服务架构或服务间通信
处理后端认证授权与安全合规
npx skills add modu-ai/moai-adk --skill moai-domain-backend -g -y
数据库领域专家技能，涵盖PostgreSQL、MongoDB、Redis等。用于模式设计、查询优化、索引策略及多库架构选型与实施。
数据库模式设计
查询性能优化
多数据库架构搭建
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/UX 设计模式
npx skills add modu-ai/moai-adk --skill moai-domain-frontend -g -y
专注于AI文本人工化润色，检测并去除AI痕迹，在保留原意、事实和数据的前提下提升自然度。支持多语言及散文/营销文案场景，提供严格的改写保护机制。
需要去除AI生成文本的生硬感或模板化表达
要求对已有内容进行润色而非重写
需要在保持事实和语气不变的情况下提升文本可读性
npx skills add modu-ai/moai-adk --skill moai-domain-humanize -g -y
用于生成可编辑的SVG技术信息图及2x PNG。通过数值计算布局，支持CJK字体和确定性Lint，适用于幻灯片、离线阅读等需像素级控制的场景，与Mermaid互补。
需要生成静态图片用于演示或邮件
要求对位置、间距进行像素级精确控制
涉及CJK文本精确换行
npx skills add modu-ai/moai-adk --skill moai-domain-svg-infographic -g -y
提供 Claude Code 扩展开发的权威参考，涵盖 Skills、插件、子代理及配置机制。用于指导创建 Agent 技能、管理上下文记忆及实现自动化流程。
创建或配置 Claude Code 扩展
开发自定义 Agent 技能或插件
设置子代理与自动化工作流
npx skills add modu-ai/moai-adk --skill moai-foundation-cc -g -y
提供MoAI-ADK核心开发原则，包括TRUST 5质量框架、SPEC-First DDD工作流、代理委派模式及Token预算优化。用于指导高质量、模块化的AI驱动开发流程。
需要遵循质量标准或质量门禁配置
规划基于规范的领域驱动开发工作流
优化上下文窗口或管理Token预算
设计模块化系统或代理协作架构
npx skills add modu-ai/moai-adk --skill moai-foundation-core -g -y
提供MoAI质量模型背景，涵盖TRUST 5原则、3级测试套件及自动化工具链。用于代码审查、质量门禁检查、覆盖率目标设定及合规性评估，指导Agent执行标准化质量验证流程。
进行代码审查或评审
执行质量门禁检查
评估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自动更新提案载荷供编排器通过AskUserQuestion展示。触发场景包括检查状态、获取待处理提案及执行应用或回滚流程，用于管理自动化学习的生命周期。
需要检查Harness学习状态或待处理提案时
需要加载并应用下一个自动更新提案时
需要对已应用的更新进行回滚时
npx skills add modu-ai/moai-adk --skill moai-harness-learner -g -y
自动执行看板流程的一次迭代：监控待办队列，将已选任务分派给隔离的工作者，收集完成证据并生成报告。支持无人值守后台运行，严格限制写入权限与集成操作，确保工作区隔离与安全。
需要自动化执行看板任务分发时
配置无人值守的循环迭代流程时
npx skills add modu-ai/moai-adk --skill moai-kanban-foreman -g -y
废弃的7阶段元工具，重定向至v4构建器。保留旧版作为向后兼容入口，新流程使用v4构建器及清单驱动的运行器，不再用于新建任务。
用户尝试使用旧的7阶段工作流创建harness
调用已弃用的moai-meta-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 的评审结果并汇总分歧，用于实现跨模型审计决策。
需要执行多模型（multi）代码审计时
调用 audit_multi MCP 工具进行结果收敛时
npx skills add modu-ai/moai-adk --skill moai-ref-cross-model-audit -g -y
提供Git工作流参考，包括分支策略、命名规范、提交信息及PR模板。用于指导Agent执行标准化的Git操作、分支管理和PR创建，提升协作效率。
需要遵循特定Git分支策略
生成或格式化Git提交信息
创建Pull Request模板
选择合并策略
npx skills add modu-ai/moai-adk --skill moai-ref-git-workflow -g -y
提供OWASP Top 10、认证及HTTP安全头参考，用于后端API实现与安全审计，辅助Agent检查BOLA、SSRF等漏洞及配置安全策略。
后端API实现过程中的安全检查
执行安全审计或代码审查
npx skills add modu-ai/moai-adk --skill moai-ref-owasp-checklist -g -y
提供React/Next.js组件设计模式、状态管理策略及项目结构参考，涵盖组合组件、自定义Hook、容器/展示分离等生产级规范，旨在提升前端开发质量与可维护性。
前端组件架构设计
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循环实现遗留代码的行为安全重构与技术债减少。
重构遗留代码
在不改变行为的前提下优化代码结构
降低生产系统的技术债务
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 工作流，通过 Hook 系统无缝集成 Claude Code。
需要自动修复代码错误或提升代码质量时
实施带有零错误目标的特性开发时
配置持续集成或自动化代码审查流程时
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
用于通过GEARS格式定义需求、验收标准及SPEC文档，支持Plan-Run-Sync工作流集成与并行开发隔离。
创建SPEC文档
定义验收标准
编写需求规格说明
npx skills add modu-ai/moai-adk --skill moai-workflow-spec -g -y
TDD工作流专家，指导通过RED-GREEN-REFACTOR循环进行测试驱动开发。适用于从零开始构建新功能、新模块或行为驱动实现场景，强调先写测试定义预期行为再编码。
从零开始开发新功能
需要明确行为规范的模块开发
遵循测试优先原则的开发任务
npx skills add modu-ai/moai-adk --skill moai-workflow-tdd -g -y
综合开发工作流专家，涵盖DDD测试、AI调试、性能优化及TRUST 5代码审查。支持遗留系统行为保留与绿色场规范测试，集成CI/CD质量门禁，旨在提升代码质量并降低技术债务。
编写测试或测量覆盖率
运行性能分析或基准测试
执行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统一编排器，负责将自然语言或子命令路由至专用智能体。支持自主开发流程，包括计划、执行、同步及审查等阶段，通过路由观察账本记录决策，实现多模式协作与自动化工作流调度。
需要协调多个智能体进行复杂软件开发任务
用户输入包含moai子命令如plan、run、sync、fix等
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 及社会登录等安全功能实现。
需要选择身份认证平台
实现多因素认证或单点登录
集成 WebAuthn 或社会登录
处理令牌安全或合规性要求
npx skills add modu-ai/moai-adk --skill moai-platform-auth -g -y
Chrome Manifest V3 扩展开发专家，涵盖 Service Worker、Content Scripts、消息传递、chrome API 及 Web Store 发布。用于构建现代浏览器扩展。
检测到 manifest.json 且 manifest_version 为 3
涉及 Service Worker 或 Content Script 文件
使用 chrome.* API 模式
npx skills add modu-ai/moai-adk --skill moai-platform-chrome-extension -g -y
部署平台专家技能，涵盖Vercel、Railway和Convex。用于指导应用部署、边缘函数配置、持续集成设置及无服务器基础设施管理。
部署应用到Vercel或Railway
配置边缘计算或CDN
搭建实时后端服务
管理无服务器基础设施
npx skills add modu-ai/moai-adk --skill moai-platform-deployment -g -y
基于意图优先的设计专家，涵盖设计方向、领域词汇、设计记忆及构建后审查。用于确立设计意图或在计划阶段审计代码是否符合设计原则。
/moai plan 检测到设计相关关键词时触发设计方向
执行 /moai review --design 进行设计审计
执行 /moai review --critique 进行构建后审查
npx skills add modu-ai/moai-adk --skill moai-design-craft -g -y
设计工具集成专家，涵盖Figma MCP、Pencil渲染及代码导出。用于获取Figma设计上下文、渲染视觉稿或生成React/Tailwind代码，默认采用shadcn/ui Nova风格。
从 Figma 获取设计上下文
渲染 Pencil 设计稿
将设计导出为 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组件库
实现无障碍用户界面
设置设计令牌架构
集成图标系统
创建深色模式主题
npx skills add modu-ai/moai-adk --skill moai-domain-uiux -g -y
管理多智能体工作流的上下文窗口优化、会话状态持久化及200K令牌预算分配。通过渐进式加载、检查点重置和MCP连续性协议，解决长会话中的上下文超限与丢失问题，支持智能体间协作。
多智能体工作流协调
会话上下文接近150K或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、实时同步、离线缓存、向量搜索等）选择最合适的数据库方案，并提供架构设计与选型决策支持。
需要选择云数据库服务
比较不同数据库平台特性
设计数据库架构
评估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
企业级模板管理系统，支持代码脚手架、Boilerplate生成及GitHub Issue反馈模板管理。用于快速创建项目骨架、标准化开发流程、优化模板结构及版本控制，提升开发效率与一致性。
创建新项目或功能模块的脚手架
生成代码Boilerplate文件
管理项目模板版本和备份恢复
使用反馈模板创建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
