Agent Skills
› netalertx/NetAlertX
netalertx/NetAlertX
GitHub用于创建、运行和测试 NetAlertX 插件的开发技能，涵盖插件结构定义、配置管理、数据契约及执行流程。
Install All Skills
npx skills add netalertx/NetAlertX --all -g -y
Skills in Collection (30)
用于创建、运行和测试 NetAlertX 插件的开发技能，涵盖插件结构定义、配置管理、数据契约及执行流程。
创建新插件
运行插件脚本
测试插件功能
开发插件特性
npx skills add netalertx/NetAlertX --skill plugin-development -g -y
指导如何分析GitHub PR评论并规范响应流程，涵盖分类处理、加载相关技能、执行代码变更及测试验证，确保符合代码标准与测试规范。
处理PR评审意见
回复代码审查评论
解决PR中的反馈
npx skills add netalertx/NetAlertX --skill pr-analysis -g -y
提供在 devcontainer 中运行测试的完整工作流，涵盖环境检查、全量/快速测试执行、特定用例调试、API Token 获取及跨测试污染排查，确保测试环境正确与结果可靠。
用户要求运行测试
需要检查测试失败原因
请求调试失败的测试用例
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
指导识别、管理和运行 NetAlertX 开发容器内的命令。用于在容器中执行测试、设置脚本或排查容器相关问题，确保正确找到并操作目标容器。
用户请求在开发环境中运行命令
需要执行测试或设置脚本
排查开发容器相关问题
npx skills add netalertx/NetAlertX --skill devcontainer-management -g -y
定义NetAlertX后端Python代码的日志规范，包括使用mylog库、日志级别划分及消息格式。适用于添加、修改或审查日志语句的场景。
添加新日志语句
修改现有日志逻辑
审查代码中的日志实现
npx skills add netalertx/NetAlertX --skill logging-standards -g -y
配置 MCP 连接以启用 AI Agent 与 NetAlertX 运行时交互，支持数据库查询、网络扫描和设备管理等动态操作。
需要实时调试或验证运行时状态
执行数据库查询或触发网络扫描
npx skills add netalertx/NetAlertX --skill mcp-activation -g -y
指导如何分析并响应GitHub PR审查评论。包含测试代码编写规范、PR评论分类处理流程、变更执行步骤及回复准则，确保符合代码标准和测试工作流。
需要处理GitHub PR中的审查评论
针对PR反馈或内联代码注释进行响应
在修改测试文件前检查规范
npx skills add netalertx/NetAlertX --skill pr-analysis -g -y
NetAlertX配置开发最佳实践，规范setting的声明、命名、类型选择、验证及UI渲染，确保配置自文档化、本地化及向后兼容。
添加或修改NetAlertX配置项
遵循配置命名与验证规范
npx skills add netalertx/NetAlertX --skill nax-settings-development -g -y
提供 Gemini CLI、GitHub Copilot 和 Claude Code 的跨平台技能索引与映射，帮助定位各助手中同名或互补技能的差异及最佳版本。
需要查找特定功能的 AI 助手技能
比较不同 AI 工具中相似技能的实现差异
在多个 AI 助手间迁移或切换工作流
npx skills add netalertx/NetAlertX --skill skills-index -g -y
指导在开发容器中运行测试的工作流，包括环境检查、默认全量套件或快速单元测试的执行、特定测试运行、认证令牌获取及环境重置。
执行代码测试
运行单元测试
验证代码完整性
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
用于开发、扩展和修改 NetAlertX REST API 端点。指导创建路由、实现接口逻辑及调整响应格式，遵循统一的授权与响应契约规范。
创建新 API 端点
添加 API 路由
实现 API 功能
修改 API 响应结构
npx skills add netalertx/NetAlertX --skill api-development -g -y
管理NetAlertX的API令牌和认证密钥，涵盖检索、轮换及401/403错误排查。指导通过Python或Docker安全获取Token，利用UI或配置文件轮换密钥，并基于日志诊断认证问题，确保系统访问安全。
需要查找或验证NetAlertX API Token
处理401或403认证错误
轮换或生成新的API密钥
npx skills add netalertx/NetAlertX --skill netalertx-authentication-tokens -g -y
定义NetAlertX项目的代码规范、架构约束及最佳实践，涵盖编码风格、数据库访问模式、安全处理及测试要求，指导AI进行代码编写与审查。
编写新功能代码
审查现有代码
实施功能模块
npx skills add netalertx/NetAlertX --skill netalertx-code-standards -g -y
提供NetAlertX设备表数据库架构模式，梳理所有写入路径以保障数据一致性，详解字段溯源机制及触发器与Python钩子的选型建议，辅助开发者正确实现功能。
设计涉及Devices表的写入功能
实现审计或历史记录日志
选择触发器或Python钩子方案
npx skills add netalertx/NetAlertX --skill netalertx-database-patterns -g -y
用于重置 NetAlertX 数据库和配置，清空数据后重新初始化。适用于需要清理环境或恢复初始状态的场景。
reset database
wipe db
fresh database
clean slate
start fresh
npx skills add netalertx/NetAlertX --skill reset-netalertx-database -g -y
用于生成和合并 VS Code Devcontainer 配置文件。当修改了 devcontainer 模板、特性或设置后，需运行此技能以更新最终配置，确保开发环境一致。
用户要求生成 devcontainer 配置
用户要求更新 devcontainer 模板
修改了 .devcontainer/ 下的文件后
npx skills add netalertx/NetAlertX --skill netalertx-devcontainer-configs -g -y
用于在 devcontainer 环境中启动、停止及检查 NetAlertX 相关服务（如后端、前端、Cron），并提供调试和端口信息。
启动或重启后端/前端/Cron服务
停止所有开发服务
检查服务运行状态
npx skills add netalertx/NetAlertX --skill restarting-netalertx-services -g -y
重置 devcontainer 运行时环境，强制重启服务、重建 tmpfs 和日志，保留持久化数据。用于环境损坏、脚本修改后或需要重置状态时执行。
修复 devcontainer 环境故障
重新运行启动配置
容器重建后重置状态
npx skills add netalertx/NetAlertX --skill netalertx-idempotent-setup -g -y
用于构建和启动 NetAlertX 的 Docker 容器，支持测试镜像与生产环境部署。包含前置检查、构建命令及端口配置说明。
构建 Docker 镜像
启动生产容器
重建测试镜像
npx skills add netalertx/NetAlertX --skill netalertx-docker-build -g -y
清理未使用的Docker资源以释放磁盘空间，包括停止的容器、镜像、卷和网络。此为危险操作，需人工确认后方可执行。
清理docker
删除未使用的镜像
释放磁盘空间
docker cleanup
npx skills add netalertx/NetAlertX --skill netalertx-docker-prune -g -y
定义 NetAlertX 后端 Python 代码的日志规范，包括使用 mylog、日志级别及格式，指导添加或审查日志语句。
添加新的日志语句
修改现有日志内容
审查代码中的日志实现
npx skills add netalertx/NetAlertX --skill netalertx-logging-standards -g -y
配置MCP连接以暴露NetAlertX运行时API，支持AI代理进行实时调试、数据库查询和网络扫描等操作。
需要实时访问NetAlertX API进行调试或故障排除
执行数据库查询、网络扫描或设备管理操作
npx skills add netalertx/NetAlertX --skill mcp-activation -g -y
指导如何创建、运行和测试 NetAlertX 插件。涵盖插件结构、配置、执行命令及结果获取，辅助插件开发工作流。
创建插件
运行插件
测试插件
插件开发
执行插件脚本
npx skills add netalertx/NetAlertX --skill netalertx-plugin-run-development -g -y
指导如何分析和响应 GitHub PR 审查评论，涵盖代码变更、测试规范及回复流程。
处理 PR 审查意见
回复代码评论
解决 PR 反馈
npx skills add netalertx/NetAlertX --skill netalertx-pr-analysis -g -y
提供 NetAlertX 项目的代码结构导航，包括关键路径、架构说明（PHP/Nginx前端与Python后端）、运行时配置及环境变量。帮助用户快速定位文件位置、理解项目布局并查阅相关文档。
询问项目文件位置
查询代码库结构
查找特定功能代码路径
了解项目架构
npx skills add netalertx/NetAlertX --skill about-netalertx-project-structure -g -y
通过脚本生成合成设备数据并导入后端API，用于填充数据库和UI。适用于加载示例、种子数据或测试设备场景。
加载示例设备
导入种子数据
导入测试设备
填充数据库
生成测试数据
npx skills add netalertx/NetAlertX --skill netalertx-sample-data -g -y
管理 NetAlertX 配置设置，提供读取、添加核心或插件设置的规范与开发指南。涵盖命名、类型选择、验证、默认值及本地化等最佳实践，确保配置声明式且易维护。
添加新配置项
读取配置值
配置应用选项
npx skills add netalertx/NetAlertX --skill netalertx-settings-management -g -y
提供 GitHub Copilot、Gemini CLI 和 Claude Code 的跨平台技能索引，映射同名或相似技能的差异与位置，辅助开发者快速定位最丰富的对应技能。
需要查找特定功能的 AI 技能
对比不同 AI 助手的技能实现差异
在多个 AI 工具间切换时寻找对应配置
npx skills add netalertx/NetAlertX --skill skills-overview -g -y
指导在NetAlertX开发容器中运行、调试和修复测试。涵盖预检失败状态、执行pytest、处理403认证错误及解决sys.modules模块污染等常见问题，确保测试环境稳定可靠。
运行测试
检查测试失败
调试失败的测试
执行pytest
npx skills add netalertx/NetAlertX --skill netalertx-testing-workflow -g -y
