Agent Skills
› netalertx/NetAlertX
netalertx/NetAlertX
GitHub提供Devices表写入路径清单、字段来源映射及身份标识迁移指南，辅助开发者在涉及设备数据读写时确保正确性并选择合适的数据模式。
安装全部 Skills
npx skills add netalertx/NetAlertX --all -g -y
集合内 Skills (55)
按质量分展示前 50 个（共 55 个），完整列表请用安装命令预览或逐个打开详情。
提供Devices表写入路径清单、字段来源映射及身份标识迁移指南，辅助开发者在涉及设备数据读写时确保正确性并选择合适的数据模式。
设计涉及Devices表的写操作功能
实现审计或历史记录日志功能
选择SQLite触发器或Python钩子
npx skills add netalertx/NetAlertX --skill database-patterns -g -y
规范 Git 操作，禁止擅自创建分支，默认直接提交至 next_release 分支。推送前需确认状态并获用户许可，防止共享工作区冲突。
执行 git checkout -b 或 branch 命令
执行 git push 命令
npx skills add netalertx/NetAlertX --skill git-workflow -g -y
指导安装脚本的编辑与审查，涵盖卸载安全、检查脚本退出码差异及遗留代码处理。
编辑 install/ 目录下的文件
审查涉及安装脚本的 PR
npx skills add netalertx/NetAlertX --skill install-scripts -g -y
指导创建、运行和测试 NetAlertX 插件的开发流程，涵盖插件结构、配置模式（如超时与调度）、数据契约及执行脚本的具体步骤。
创建新插件
运行现有插件
测试插件功能
开发插件特性
npx skills add netalertx/NetAlertX --skill plugin-development -g -y
用于编写、审查或清理 NetAlertX 插件的 README 文档。规范了文档结构，强调以 Settings UI 为唯一真相源，禁止重复记录配置项，要求基于代码和 config.json 验证内容并回填作者信息。
创建新插件的 README
审查现有插件文档
清理过时的插件说明
npx skills add netalertx/NetAlertX --skill plugin-readme -g -y
提供插件PR审查清单，重点检查插件脚本中是否违规使用原始SQL、数据日志安全性、新依赖构建目标覆盖及scanPresence正确性。
审查插件Pull Request
审计现有插件脚本
npx skills add netalertx/NetAlertX --skill plugin-review -g -y
指导如何分析和回应 GitHub PR 中的审查评论。强调复用现有技能、遵循代码风格规范，并在处理测试和代码变更前加载相关领域技能，确保符合项目标准。
处理 GitHub PR 审查意见
回复代码行内评论
解决 PR 反馈线程
npx skills add netalertx/NetAlertX --skill pr-analysis -g -y
指导撰写PRD和设计文档，强调在编写前验证代码主张、追踪下游消费者及评估性能影响。适用于涉及跨子系统或架构变更的高风险需求，确保设计严谨性。
撰写产品需求文档
起草设计文档
规格化功能特性
npx skills add netalertx/NetAlertX --skill prd-writing -g -y
文档化扫描流水线中设备存在性、事件生成及会话生命周期的核心逻辑。涵盖CurrentScan等表结构、视图关联机制及字段写入权限，指导修改设备连接状态或会话行为时的代码规范。
需要理解或修改扫描管线中的设备连接/断开逻辑
涉及会话状态推导或事件生成的代码变更
排查设备在线状态计算异常
npx skills add netalertx/NetAlertX --skill scan-pipeline -g -y
定义技能文档的写作规范，要求仅陈述当前行为、使用简洁语言并禁止使用破折号，旨在维护技能的准确性与可读性。
编写新的 SKILL.md
编辑或清理现有技能文档
撰写研究或审计报告
npx skills add netalertx/NetAlertX --skill skill-hygiene -g -y
提供在devcontainer中运行pytest测试的标准化流程，涵盖环境检查、全量/快速测试执行、特定用例运行及API Token获取。指导如何排查预存失败、重置环境及处理模块桩污染等陷阱。
用户要求运行测试套件
用户询问测试失败原因
需要获取API Token进行测试
调试失败的测试用例
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
规范前端UI开发，强调在添加或修改界面元素前必须复用现有模式。禁止无PRD创新，遵循现有行为优先原则，通过搜索代码避免重复造轮子及样式错误。
新增前端组件或页面布局
修改现有UI交互或样式
实现按钮、表格、弹窗等通用控件
npx skills add netalertx/NetAlertX --skill ux-design-patterns -g -y
NetAlertX数据库架构模式，梳理Devices表所有写路径以规避正确性Bug，并说明从MAC到GUID的身份迁移策略，指导功能设计与审计日志实现。
设计涉及Devices表写入的功能
实现审计或历史日志记录
选择触发器与Python钩子的实现方案
npx skills add netalertx/NetAlertX --skill database-patterns -g -y
指导识别并管理 NetAlertX 开发容器，提供查找容器、在容器内执行命令及运行设置脚本的方法，用于解决环境配置和调试问题。
需要识别当前活跃的 Docker 容器
需要在容器中执行特定命令或脚本
排查开发容器相关的环境或启动问题
npx skills add netalertx/NetAlertX --skill devcontainer-management -g -y
规范Git操作行为，禁止擅自创建分支，默认直接提交至next_release分支。执行任何改变共享状态的Git命令前需确认当前状态，推送前必须获得用户明确许可，防止因多终端并发导致的状态冲突与失败。
需要创建新Git分支时
准备执行git push命令时
执行可能改变仓库状态的Git命令前
npx skills add netalertx/NetAlertX --skill git-workflow -g -y
提供安装脚本的编辑与PR审查规范，涵盖卸载安全、检查脚本退出行为差异及遗留代码范围，指导正确维护安装逻辑。
修改或创建 install/ 目录下的安装/卸载脚本
审查涉及安装脚本的 Pull Request
npx skills add netalertx/NetAlertX --skill install-scripts -g -y
定义 NetAlertX Python 后端的日志记录规范，包括导入 mylog、函数签名、日志级别及适用场景、消息格式（模块标签与 f-string）、时间戳处理及禁止行为。
添加或修改后端代码中的日志语句
审查日志相关代码是否符合规范
npx skills add netalertx/NetAlertX --skill logging-standards -g -y
配置 MCP 连接以启用 AI Agent 与 NetAlertX 运行时的实时交互，支持数据库查询、网络扫描和设备管理等动态操作。
需要访问 NetAlertX 运行时进行调试或故障排查
执行数据库查询、网络扫描或设备管理等动态操作
npx skills add netalertx/NetAlertX --skill mcp-activation -g -y
面向插件PR审查的清单，补充测试未覆盖的四项检查：禁止插件脚本使用原生SQL、可疑数据日志记录、新依赖构建目标覆盖及scanPresence正确性，并附真实案例。
审查插件Pull Request
审计现有插件脚本安全性与规范性
npx skills add netalertx/NetAlertX --skill plugin-review -g -y
指导如何分析并响应GitHub PR中的审查评论。包含代码风格偏好、测试编写规范及处理PR反馈前的技能加载流程，旨在提升代码质量与审查效率。
需要回复或解决GitHub PR中的审查意见
处理PR中的行内代码评论
针对PR反馈进行代码修改或测试补充
npx skills add netalertx/NetAlertX --skill pr-analysis -g -y
用于编写或审查PRD及设计文档的严谨方法论。强调基于实际代码验证声明、追踪下游消费者并评估性能影响，避免凭记忆或推测写作，适用于涉及跨子系统或复杂状态机制的设计任务。
撰写产品需求文档
起草设计文档
规划新功能规格
npx skills add netalertx/NetAlertX --skill prd-writing -g -y
提供扫描管道与设备存在生命周期的参考文档，涵盖CurrentScan、Events、Sessions等核心表结构及字段写入权限机制。用于在修改会话或设备处理代码前理解系统行为。
修改服务器扫描或设备处理逻辑
分析设备连接断开事件
排查会话状态异常
npx skills add netalertx/NetAlertX --skill scan-pipeline -g -y
定义NetAlertX配置项的开发规范与最佳实践，涵盖声明式配置、UI渲染、验证、本地化及兼容性，确保配置自文档化且易于维护。
新增或修改系统配置项
遵循配置开发规范
实现配置验证逻辑
npx skills add netalertx/NetAlertX --skill nax-settings-development -g -y
规范 SKILL.md 等技能文档的编写标准，要求仅陈述当前行为、使用简洁语言并禁止破折号，旨在提升技术文档的准确性与可读性。
编写或编辑 SKILL.md 文件
撰写研究或审计文档
npx skills add netalertx/NetAlertX --skill skill-hygiene -g -y
提供跨 AI 助手（Gemini CLI、GitHub Copilot、Claude Code）的技能索引与对照表，帮助快速定位各平台对应技能并识别版本差异。
需要查找特定功能的 AI 技能
对比不同 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
规范前端 UI 开发，强调复用现有模式而非自创。要求新增或修改 UI 元素前搜索已有实现，遵循优先级顺序，避免视觉错误和主题兼容问题，提升代码一致性与维护性。
添加新 UI 组件
修改现有界面布局
实现交互逻辑
重构前端样式
npx skills add netalertx/NetAlertX --skill ux-design-patterns -g -y
用于开发和维护NetAlertX的REST API接口，涵盖路由创建、认证及响应规范。适用于需要添加API端点、修改API逻辑或实现新接口的场景。
创建新的API端点
添加API路由
实现API功能
修改API响应格式
npx skills add netalertx/NetAlertX --skill api-development -g -y
用于管理和排查 NetAlertX API 令牌及认证密钥。涵盖令牌的获取、轮换、验证以及 401/403 错误的调试，确保系统安全与正常运行。
API 令牌泄露或需要轮换
遇到 401/403 认证错误
需要读取或验证 API_TOKEN 设置
npx skills add netalertx/NetAlertX --skill netalertx-authentication-tokens -g -y
定义NetAlertX项目的编码规范，涵盖代码结构、数据库交互、测试策略及前后端边界。指导AI在编写、审查代码或实现功能时遵循DRY原则、文件长度限制及特定工具函数使用。
编写新代码
代码审查
实现新功能
npx skills add netalertx/NetAlertX --skill netalertx-code-standards -g -y
提供NetAlertX Devices表的写入路径审计清单及数据库架构模式。指导开发者在涉及设备数据写入、历史日志实现或选择触发器与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
用于生成和合并 devcontainer 配置文件及 Dockerfile。在修改模板、功能或设置后运行，将配置整合为 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
重置开发容器运行时状态，清理服务、临时文件及日志，保留持久化数据。用于环境修复、重建后恢复或脚本修改后的重新配置。
re-run startup
reprovision devcontainer
fix permissions
reset runtime state
npx skills add netalertx/NetAlertX --skill netalertx-idempotent-setup -g -y
用于构建和启动 NetAlertX 的 Docker 镜像，支持测试与生产环境。包含单元测试镜像构建、生产容器部署及前置检查清单，确保服务正确运行并释放端口。
构建 Docker 镜像
启动生产容器
Dockerfile 变更后重建镜像
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
规范Git工作流，禁止擅自创建分支，默认提交至next_release分支，推送前需确认，执行命令前检查共享状态，防止多终端冲突。
用户请求创建新分支
用户请求推送代码
用户请求切换分支
npx skills add netalertx/NetAlertX --skill netalertx-git-workflow -g -y
提供安装脚本的维护规范，明确卸载安全边界、检查脚本退出码设计意图及遗留代码范围，指导PR审查与修改。
审查或编辑 install/ 目录下的文件
处理涉及安装脚本的 PR
npx skills add netalertx/NetAlertX --skill netalertx-install-scripts -g -y
定义NetAlertX后端Python代码的日志规范，包括使用mylog模块、分级标准（none到trace）、消息格式及禁止行为。用于指导日志语句的添加、修改与审查，确保输出一致性与安全性。
需要添加或修改后端Python日志时
审查代码中的日志语句是否符合规范时
npx skills add netalertx/NetAlertX --skill netalertx-logging-standards -g -y
配置MCP连接以启用AI代理与NetAlertX运行时的实时交互，支持数据库查询、网络扫描及设备管理。
需要实时访问NetAlertX API进行调试或操作
需要在devcontainer中激活MCP工具
npx skills add netalertx/NetAlertX --skill mcp-activation -g -y
用于编写、审查或清理 NetAlertX 插件的 README.md 文档。指导如何结构化概述、使用方法和注意事项，强调不重复记录 UI 已展示的字段设置，并需基于代码验证信息以维护文档准确性。
创建新插件的 README
审查现有插件文档
清理或增强插件说明
npx skills add netalertx/NetAlertX --skill netalertx-plugin-readme -g -y
面向插件 PR 审查的检查清单，补充自动化测试未覆盖的规范。重点审查脚本中禁止使用原始 SQL、敏感数据日志记录、依赖构建目标覆盖及扫描存在性正确性，确保代码安全与架构合规。
审查插件 Pull Request
审计现有插件脚本
npx skills add netalertx/NetAlertX --skill netalertx-plugin-review -g -y
指导如何开发、运行和测试 NetAlertX 插件，包括执行命令、目录结构及配置说明。
创建插件
运行插件
测试插件
插件开发
npx skills add netalertx/NetAlertX --skill netalertx-plugin-run-development -g -y
指导如何分析并响应 NetAlertX 项目的 GitHub PR 审查意见。包含代码风格偏好、测试编写规范及处理评论前的技能加载流程，强调重复问题需更新 Skill。
处理 GitHub PR 审查反馈
回复代码评论线程
检查内联代码注释
npx skills add netalertx/NetAlertX --skill netalertx-pr-analysis -g -y
针对NetAlertX项目的严谨PRD撰写技能，强调在动笔前验证代码声明、追踪下游消费者及评估性能影响。适用于跨子系统或架构变更的设计文档编写与审查，避免设计错误导致的返工。
write a PRD
draft a design doc
spec out this feature
create a PRD for X
npx skills add netalertx/NetAlertX --skill netalertx-prd-writing -g -y
提供 NetAlertX 项目的代码结构导航，包括关键文件路径、前后端架构说明、运行时配置及环境变量。用于快速定位代码位置和理解项目布局。
询问代码文件位置
了解项目目录结构
查找特定功能模块路径
npx skills add netalertx/NetAlertX --skill about-netalertx-project-structure -g -y
该技能用于在开发容器中加载合成设备数据。通过运行脚本生成模拟设备记录并导入API，为测试和数据库填充提供种子数据。
加载示例设备
导入种子数据
导入测试设备
填充数据库
生成测试数据
npx skills add netalertx/NetAlertX --skill netalertx-sample-data -g -y
解析NetAlertX扫描管道内部机制，涵盖设备存在性、事件生成与会话推导逻辑。用于修改扫描代码或分析设备连接状态时的参考指南。
需要理解设备在线/离线状态判定逻辑
正在修改scan/session_events.py或device_handling.py文件
排查设备会话断连或重连异常
npx skills add netalertx/NetAlertX --skill netalertx-scan-pipeline -g -y
