Agent Skills
› netalertx/NetAlertX
netalertx/NetAlertX
GitHub指导创建、运行和测试 NetAlertX 插件。涵盖工作流、目录结构、配置模式、数据契约及执行阶段，用于开发自定义功能模块。
Install All Skills
npx skills add netalertx/NetAlertX --all -g -y
Skills in Collection (32)
指导创建、运行和测试 NetAlertX 插件。涵盖工作流、目录结构、配置模式、数据契约及执行阶段，用于开发自定义功能模块。
创建 NetAlertX 插件
运行 NetAlertX 插件
测试插件功能
开发插件逻辑
npx skills add netalertx/NetAlertX --skill plugin-development -g -y
用于编写、审查或清理 NetAlertX 插件的 README.md 文档。遵循特定结构，避免重复配置说明，强调基于代码验证内容准确性，并负责补充作者等元数据信息。
创建新插件的 README
审查现有插件文档
清理过时或错误的插件说明
补全缺失的作者信息
npx skills add netalertx/NetAlertX --skill plugin-readme -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代理与NetAlertX运行时的实时交互，支持数据库查询、网络扫描及设备管理。
需要实时查询数据库或触发运行时操作
调试或验证NetAlertX运行时状态
npx skills add netalertx/NetAlertX --skill mcp-activation -g -y
指导Agent分析GitHub PR评论，分类并执行代码修改、测试验证及回复。强调加载相关技能规范，遵循MAC地址小写等强制检查清单，确保变更合规。
处理PR评审意见
响应代码审查反馈
解答内联代码问题
npx skills add netalertx/NetAlertX --skill pr-analysis -g -y
定义NetAlertX配置项的开发规范，涵盖命名、类型选择、验证、默认值及UI渲染最佳实践，确保配置声明式、自文档化且向后兼容。
添加新的配置项
修改现有配置逻辑
优化设置界面展示
npx skills add netalertx/NetAlertX --skill nax-settings-development -g -y
提供Gemini CLI、GitHub Copilot和Claude Code的技能索引与交叉参考，帮助定位各助手间的对应技能及版本差异。
需要查找特定AI助手的技能
比较不同助手间相似技能的差异
npx skills add netalertx/NetAlertX --skill skills-index -g -y
指导在开发容器中运行测试的规范，涵盖全量套件、快速单元及特定测试的执行命令，强调必须重置环境以获取最新API Token并处理认证问题。
需要执行单元测试或完整测试套件时
代码提交后需验证完整性时
需要获取或重置API Token进行认证测试时
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
用于开发NetAlertX REST API端点，涵盖路由创建、认证配置及响应规范遵循。指导添加新接口并维护与UI的JSON缓存交互。
创建API端点
添加API路由
实现API功能
修改API响应
npx skills add netalertx/NetAlertX --skill api-development -g -y
用于管理、检索、轮换和调试 NetAlertX 的 API 令牌及认证密钥，协助排查 401/403 错误并遵循安全最佳实践。
API token 丢失或泄露需轮换
遇到 401/403 认证失败错误需排查
需要读取或验证当前 API_TOKEN 值
npx skills add netalertx/NetAlertX --skill netalertx-authentication-tokens -g -y
定义NetAlertX项目的编码规范与开发流程，涵盖代码审查、实现计划、DRY原则、文件长度限制及数据库访问规范。指导AI在编写、审查代码或实现功能时遵循统一标准，确保可维护性与安全性。
编写新功能代码
进行代码审查
实施架构变更
npx skills add netalertx/NetAlertX --skill netalertx-code-standards -g -y
提供NetAlertX设备表数据库架构模式，梳理所有写入路径以预防正确性Bug，解释*Source字段归属机制及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 配置
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测试镜像和启动生产容器的操作指南，包含前置检查及端口配置说明。
build container
docker build
build test image
npx skills add netalertx/NetAlertX --skill netalertx-docker-build -g -y
清理未使用的Docker资源（容器、镜像、卷、网络）以释放磁盘空间。此操作具有破坏性，会删除所有停止的容器及未使用的资源，执行前需人工确认。适用于磁盘不足或需要干净环境时。
清理docker
prune docker
释放磁盘空间
移除未使用的镜像
npx skills add netalertx/NetAlertX --skill netalertx-docker-prune -g -y
定义NetAlertX后端Python代码的日志记录规范，包括使用mylog模块、分级标准（none到trace）、消息格式及禁止行为，确保日志一致性与安全性。
添加或修改Python日志语句时
审查代码中的日志实现是否符合规范时
npx skills add netalertx/NetAlertX --skill netalertx-logging-standards -g -y
配置 MCP 连接以启用 AI 代理与 NetAlertX 运行时的实时交互，支持数据库查询、网络扫描和设备管理等操作。
需要访问 NetAlertX 运行时 API
进行实时调试或故障排除
执行数据库查询或网络扫描
npx skills add netalertx/NetAlertX --skill mcp-activation -g -y
用于撰写、审查或清理 NetAlertX 插件的 README.md 文档。遵循特定结构，避免重复配置项，需结合代码验证内容准确性并补充作者信息。
创建新插件的说明文档
优化现有插件 README
审计插件文档一致性
修复缺失的作者信息
npx skills add netalertx/NetAlertX --skill netalertx-plugin-readme -g -y
指导如何创建、运行和测试 NetAlertX 插件。涵盖工作流、手动执行命令、目录结构、配置模式及数据契约，帮助开发者理解插件机制并正确生成结果日志。
创建 NetAlertX 插件
运行 NetAlertX 插件
测试插件功能
插件开发咨询
npx skills add netalertx/NetAlertX --skill netalertx-plugin-run-development -g -y
指导如何分析GitHub PR评论并响应。涵盖测试代码规范、PR评论分类（修改/提问/建议）、执行步骤及回复准则，确保符合代码标准与测试工作流。
处理GitHub 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和Claude Code的Skills索引与交叉引用，帮助快速定位各助手目录下的对应技能，支持跨平台技能查找与版本对比。
需要查找AI助手的特定技能时
在不同AI助手间切换并寻找对应功能时
npx skills add netalertx/NetAlertX --skill skills-overview -g -y
指导在NetAlertX开发容器中运行、调试测试用例。涵盖前置检查失败状态、执行pytest、处理认证及403错误，并重点解决sys.modules存根导致的跨文件模块污染问题。
需要运行单元测试
排查测试失败原因
调试pytest报错
处理403认证错误
npx skills add netalertx/NetAlertX --skill netalertx-testing-workflow -g -y
