Agent Skills
› netalertx/NetAlertX
netalertx/NetAlertX
GitHub指导识别和管理NetAlertX开发容器，通过docker ps查找容器并执行命令。用于运行测试、设置脚本及排查容器问题，确保在正确的运行时环境中进行后端逻辑和集成测试操作。
Install All Skills
npx skills add netalertx/NetAlertX --all -g -y
Skills in Collection (27)
指导识别和管理NetAlertX开发容器，通过docker ps查找容器并执行命令。用于运行测试、设置脚本及排查容器问题，确保在正确的运行时环境中进行后端逻辑和集成测试操作。
需要运行命令或脚本
测试环境配置
容器故障排查
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 运行时的交互，支持数据库查询、网络扫描及实时故障排查。
需要访问运行时 API
执行动态操作如数据库查询或网络扫描
验证修复效果
npx skills add netalertx/NetAlertX --skill mcp-activation -g -y
指导如何分析和响应 GitHub PR 中的审查评论。涵盖测试代码规范、PR 评论分类及处理流程，要求结合其他技能执行变更并验证，确保代码质量与合规性。
需要回复或处理 GitHub PR 上的审查意见
收到关于代码的评论、建议或问题
npx skills add netalertx/NetAlertX --skill pr-analysis -g -y
定义 NetAlertX 配置项的开发规范，涵盖命名、类型选择、验证、默认值及 UI 渲染最佳实践，确保配置声明式、自文档化且向后兼容。
新增或修改 NetAlertX 配置项
遵循配置开发最佳实践
npx skills add netalertx/NetAlertX --skill nax-settings-development -g -y
提供 Gemini CLI 与 GitHub Copilot 技能索引，映射同名技能的差异及单侧独有技能，辅助开发者快速定位最适合任务的 AI 工具。
需要查找或对比不同 AI 助手的技能
在多个 AI 系统中切换工作流
npx skills add netalertx/NetAlertX --skill skills-index -g -y
指导在开发容器中运行测试工作流，包括环境检查、执行全量或快速单元测试、处理认证令牌获取及排查预存故障，确保代码完整性。
用户请求运行测试
代码开发完成后需要验证
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
指导开发NetAlertX Flask REST API端点，涵盖路由添加、鉴权实现及标准化响应格式规范。
创建新的API端点
添加API路由
修改API响应结构
npx skills add netalertx/NetAlertX --skill api-development -g -y
用于管理、检索、轮换和排查 NetAlertX 的 API 令牌及认证密钥。提供通过 Python 或容器命令获取令牌的方法，指导处理 401/403 错误及安全最佳实践。
API Token 泄露需立即轮换
客户端出现 401/403 认证失败错误
需要验证当前 API_TOKEN 配置是否正确
排查同步节点间的令牌不一致问题
npx skills add netalertx/NetAlertX --skill netalertx-authentication-tokens -g -y
定义NetAlertX项目的编码规范，涵盖代码结构、数据库访问、MAC地址处理、子进程安全及时间工具使用等标准，旨在提升代码可维护性、安全性和一致性。
编写新功能代码时参考规范
进行代码审查以检查合规性
实现涉及数据库或系统调用的特性
npx skills add netalertx/NetAlertX --skill netalertx-code-standards -g -y
提供NetAlertX Devices表写入路径审计及*Source字段溯源机制，指导开发者规避数据一致性风险，选择触发器或Python钩子方案。
设计涉及Devices表写入的新功能
实现审计日志或历史记录功能
决定使用数据库触发器还是Python钩子
npx skills add netalertx/NetAlertX --skill netalertx-database-patterns -g -y
用于重置 NetAlertX 数据库和配置。通过终止进程、删除数据文件并重新运行初始化脚本来实现数据库的彻底清除与重建，适用于需要恢复出厂设置或解决数据库异常的场景。
重置数据库
清除数据库
全新数据库
重新开始
npx skills add netalertx/NetAlertX --skill reset-netalertx-database -g -y
根据模板生成和合并VS Code devcontainer配置文件，适用于修改模板、特性或设置后重新生成配置的场景。
修改.devcontainer/模板文件
更改devcontainer特性或设置
提交devcontainer变更前
npx skills add netalertx/NetAlertX --skill netalertx-devcontainer-configs -g -y
用于在 devcontainer 环境中管理 NetAlertX 服务的启停与状态检查，涵盖后端、前端及定时任务。
启动或重启后端服务
启动或重启前端服务
停止所有相关服务
检查服务运行状态
npx skills add netalertx/NetAlertX --skill restarting-netalertx-services -g -y
重置 devcontainer 环境，强制清除并重建运行时状态、目录及服务。适用于环境损坏、修改配置脚本后或需恢复初始状态的场景。
修复 devcontainer 权限问题
重置运行时状态
环境处于损坏状态
重新运行启动流程
npx skills add netalertx/NetAlertX --skill netalertx-idempotent-setup -g -y
提供构建 Docker 测试镜像及启动生产容器的流程，包含预检查清单和端口配置说明。
构建容器或 Docker 镜像
构建测试镜像
启动生产容器
npx skills add netalertx/NetAlertX --skill netalertx-docker-build -g -y
用于清理未使用的Docker资源以释放磁盘空间。执行时会删除停止的容器、镜像、卷和网络，属危险操作，需人工确认后方可进行。
清理Docker资源
释放磁盘空间
移除未使用的镜像
npx skills add netalertx/NetAlertX --skill netalertx-docker-prune -g -y
定义NetAlertX后端Python代码的日志规范，包括导入方式、函数签名、日志级别使用场景、消息格式及禁止行为，确保日志记录的一致性与安全性。
添加新的日志语句
修改现有日志逻辑
审查代码中的日志实现
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
指导如何分析并响应 NetAlertX 项目的 GitHub PR 评论。包含测试代码规范、PR 评论分类处理流程、变更执行步骤及回复准则，确保代码质量与审查一致性。
需要处理 GitHub PR 中的评论或反馈
针对 PR 进行代码修改和验证
回复 PR 审查线程
npx skills add netalertx/NetAlertX --skill netalertx-pr-analysis -g -y
提供NetAlertX项目的代码结构、关键文件路径、架构说明及运行时配置信息，辅助开发者快速定位源码和文档。
询问项目目录结构
查找特定文件或模块位置
了解前后端架构分布
npx skills add netalertx/NetAlertX --skill about-netalertx-project-structure -g -y
加载合成设备数据到开发容器。当需要导入测试设备、填充数据库或生成种子数据时触发。通过脚本生成CSV并调用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技能的交叉索引，帮助用户根据任务快速定位对应AI系统的技能模块，支持跨平台查找与互补使用。
需要查找特定功能的AI技能
在Copilot和Gemini之间切换工具
npx skills add netalertx/NetAlertX --skill skills-overview -g -y
指导在NetAlertX开发容器中运行、调试pytest测试及排查失败的工具，涵盖前置检查、执行策略、环境配置及常见陷阱处理。
运行测试
检查测试失败
调试失败的测试
执行pytest
npx skills add netalertx/NetAlertX --skill netalertx-testing-workflow -g -y
