Agent Skills
› netalertx/NetAlertX
netalertx/NetAlertX
GitHub提供 Devices 表写入路径清单、字段来源映射及审计日志设计指南，辅助开发者正确实现数据写入与版本控制。
Install All Skills
npx skills add netalertx/NetAlertX --all -g -y
Skills in Collection (55)
Showing top 50 of 55 by quality score. Use the install list command or open individual skills for the rest.
提供 Devices 表写入路径清单、字段来源映射及审计日志设计指南，辅助开发者正确实现数据写入与版本控制。
设计涉及 Devices 表写入的功能
选择 SQLite 触发器或 Python 钩子进行审计
需要理解设备身份标识迁移策略
npx skills add netalertx/NetAlertX --skill database-patterns -g -y
规范Git工作流，禁止擅自创建分支，默认直接提交至next_release分支，推送前需确认，执行命令前检查仓库状态以避免共享环境冲突。
用户意图创建新Git分支
用户要求推送代码到远程仓库
需要执行可能改变Git分支状态的命令
npx skills add netalertx/NetAlertX --skill git-workflow -g -y
规范安装脚本的编辑与审查，涵盖卸载安全、检查脚本退出码差异及遗留代码路径说明。
编辑 install/ 目录下的文件
审查涉及安装脚本的 PR
npx skills add netalertx/NetAlertX --skill install-scripts -g -y
指导创建、运行和测试 NetAlertX 插件的开发技能。涵盖插件目录结构、配置规范（如 config.json）、脚本执行流程及数据契约，帮助开发者快速集成新功能。
创建新插件
运行或调试现有插件
开发插件功能
npx skills add netalertx/NetAlertX --skill plugin-development -g -y
用于编写或审查 NetAlertX 插件的 README.md。提供文档结构规范，强调不重复记录 UI 已生成的配置项，需基于代码验证准确性并保留版本作者信息。
创建插件说明文档
审查插件文档质量
清理插件 README
npx skills add netalertx/NetAlertX --skill plugin-readme -g -y
插件审查技能，提供PR审查清单。重点检查插件脚本中是否违规使用原生SQL、数据日志安全性、新依赖构建目标覆盖及scanPresence正确性，确保代码符合框架规范。
审查插件PR时
审计现有插件脚本
npx skills add netalertx/NetAlertX --skill plugin-review -g -y
指导如何分析和回应 GitHub PR 审查评论，强调复用现有技能、代码可读性及测试规范。
处理 PR 审查反馈
回复代码行内评论
npx skills add netalertx/NetAlertX --skill pr-analysis -g -y
用于撰写PRD、设计文档或功能提案的规范。强调在编码前通过查阅实际代码验证所有声明，追踪下游消费者，评估性能影响，并记录被否决的方案，确保跨系统变更设计的准确性与严谨性。
write a PRD
draft a design doc
spec out this feature
create a PRD for X
npx skills add netalertx/NetAlertX --skill prd-writing -g -y
指导修改扫描管道，涵盖设备存在性、连接事件及会话生命周期。涉及CurrentScan/Events/Sessions数据流、字段写入权限及会话自动关闭机制。适用于处理设备上下线、连接断开等逻辑变更。
需要修改设备存在性检测逻辑
处理设备连接或断开事件
调整会话状态或时间线行为
理解扫描管道的数据处理流程
npx skills add netalertx/NetAlertX --skill scan-pipeline -g -y
规范 SKILL.md 及内部文档的写作标准，强调仅陈述当前行为、使用简洁平实语言并禁止使用破折号，旨在维护技术参考文档的准确性与可读性。
编写或编辑 SKILL.md 文件时
撰写 .gemini/internal-docs/ 下的研究或审计文档时
npx skills add netalertx/NetAlertX --skill skill-hygiene -g -y
提供在devcontainer中运行测试的完整工作流，涵盖环境检查、全量/快速测试执行、特定测试运行、API令牌获取及常见陷阱排查。
用户要求运行测试
需要检查测试失败原因
调试失败的测试用例
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
规范前端UI元素开发，要求复用现有模式而非创新。提供设计权衡优先级（现有行为>直观性等）及代码搜索方法，确保视觉一致性与暗色主题兼容。
添加或修改前端UI元素
创建新的交互模式或布局
npx skills add netalertx/NetAlertX --skill ux-design-patterns -g -y
提供NetAlertX设备表数据库架构模式，涵盖写入路径审计、主键迁移及触发器与Python钩子选型指南。
设计涉及Devices表写入的功能
实现审计或历史日志记录
选择触发器或Python钩子方案
npx skills add netalertx/NetAlertX --skill database-patterns -g -y
指导如何识别、管理和运行NetAlertX开发容器内的命令。涵盖查找活跃容器、执行脚本及排查容器问题，确保在正确的运行时环境中进行开发和测试操作。
用户询问如何在开发容器中运行命令
需要设置或重启开发环境服务
排查容器相关的问题
npx skills add netalertx/NetAlertX --skill devcontainer-management -g -y
规范Git操作，禁止擅自创建分支以防共享仓库状态冲突。默认直接提交至next_release分支而非PR流程。执行push前必须二次确认，并在任何变更命令前检查当前状态，确保协作安全。
用户请求创建新分支
用户请求推送代码到远程仓库
用户请求切换分支
涉及git checkout -b或branch命令的场景
npx skills add netalertx/NetAlertX --skill git-workflow -g -y
指导安装脚本的审查与修改，涵盖卸载安全、检查脚本退出码规范及遗留代码处理。
编辑 install/ 目录下的文件
审查涉及 install/ 的 PR
npx skills add netalertx/NetAlertX --skill install-scripts -g -y
定义NetAlertX后端Python代码的日志规范，包括使用mylog模块、日志级别选择、消息格式及最佳实践。适用于添加、修改或审查日志语句的场景。
添加新日志语句
修改现有日志逻辑
审查代码中的日志规范
npx skills add netalertx/NetAlertX --skill logging-standards -g -y
配置 MCP 连接以启用与 NetAlertX 运行时的实时交互，支持数据库查询、网络扫描和设备管理。
需要访问运行时 API
执行动态操作如调试或故障排除
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中的代码审查意见。强调在修复重复问题时更新相关Skill，遵循代码风格规范（如逻辑清晰），严格执行测试代码编写检查清单，并在行动前加载code-standards、testing-workflow等前置Skill以确保合规性。
处理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等核心表视图关系及字段写入权限机制。用于在修改会话事件或设备处理代码前理解系统行为。
需要理解设备连接状态变化逻辑
准备修改session_events.py或device_handling.py
npx skills add netalertx/NetAlertX --skill scan-pipeline -g -y
定义NetAlertX配置项的开发规范，涵盖命名、类型选择、验证、默认值及前后端读取方式，确保配置声明式、自文档化且向后兼容。
添加新的系统或插件配置项
修改现有配置项的定义或行为
检查配置代码是否符合最佳实践
npx skills add netalertx/NetAlertX --skill nax-settings-development -g -y
定义 SKILL.md 文档的编写规范，要求仅陈述当前行为、使用简洁语言并禁止使用破折号。旨在消除历史痕迹和冗余叙述，确保技能文档作为即时参考的准确性和可读性。
编写新的 SKILL.md 文件
编辑或清理现有的 SKILL.md 内容
npx skills add netalertx/NetAlertX --skill skill-hygiene -g -y
提供跨AI助手（Gemini CLI、Copilot、Claude Code）的技能索引与映射，帮助用户快速定位和切换不同工具中的对应技能。
需要查找或切换AI助手技能时
对比不同助手间同名技能的差异
npx skills add netalertx/NetAlertX --skill skills-index -g -y
指导在开发容器中运行测试工作流，包括执行完整或快速测试套件、处理特定测试文件、重置环境以获取API Token及排查认证失败问题。
需要运行单元测试或集成测试时
测试因403错误或Token无效失败时
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
规范前端UI开发，要求复用现有组件而非新建。规定设计优先级：现有行为>直觉>密度等。通过实际案例强调搜索代码库的重要性，避免视觉错误或功能缺失。
添加或修改前端UI元素
创建新的交互模式
实现控件、布局或按钮
npx skills add netalertx/NetAlertX --skill ux-design-patterns -g -y
指导开发NetAlertX Flask REST API，涵盖路由注册、鉴权及响应规范。用于创建端点、添加API路由或修改接口逻辑。
创建新的API端点
添加API路由
实现API功能
修改API响应格式
npx skills add netalertx/NetAlertX --skill api-development -g -y
管理 NetAlertX 的 API 令牌和认证密钥，涵盖获取、轮换及排查 401/403 认证错误。提供 Python 脚本读取、Docker 容器内检查及安全最佳实践，确保认证配置的正确性与安全性。
需要查找或验证 NetAlertX API Token
遇到 401 或 403 认证失败错误
需要轮换或重置认证密钥
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表的所有写入路径以确保证据性，并解释从MAC地址迁移到GUID作为持久化身份标识的设计决策与最佳实践。
设计涉及设备数据写入的功能
实现审计或历史日志功能
选择触发器与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 配置文件及 Dockerfile。在修改模板、功能或设置后运行，确保开发环境配置正确。
生成 devcontainer 配置文件
更新 devcontainer 模板
重新生成 devcontainer
npx skills add netalertx/NetAlertX --skill netalertx-devcontainer-configs -g -y
用于在开发容器中控制 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镜像
启动生产容器
运行docker build
npx skills add netalertx/NetAlertX --skill netalertx-docker-build -g -y
清理未使用的Docker资源（容器、镜像、卷、网络）以释放磁盘空间。适用于构建缓存损坏或需要测试环境重置时。此操作危险，需人工确认。
prune docker
clean docker
remove unused images
free disk space
docker cleanup
npx skills add netalertx/NetAlertX --skill netalertx-docker-prune -g -y
规范 Git 工作流，禁止未经确认创建分支，默认直接提交至 next_release 分支。执行 push 前需显式确认，操作前检查共享仓库状态，防止因多终端并发导致的状态冲突。
用户请求创建新分支
用户请求执行 git push
用户请求切换分支或进行其他改变分支状态的操作
npx skills add netalertx/NetAlertX --skill netalertx-git-workflow -g -y
提供NetAlertX安装脚本的审查规范，涵盖卸载安全、检查脚本退出码设计及遗留代码路径说明。
审查或编辑install目录下的安装/卸载脚本
处理涉及install/或back/的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 连接以启用 NetAlertX 运行时 API 访问，支持数据库查询、网络扫描和设备管理。需先确保后端运行并生成配置，随后重载 VS Code 窗口以激活工具。
需要实时调试或排查系统状态
执行数据库查询或触发网络扫描
进行设备管理操作
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
用于审查 NetAlertX 插件 PR 或审计现有插件脚本的清单。涵盖四大检查点：禁止使用原始 SQL、可疑数据日志记录、新依赖构建目标覆盖及 scanPresence 正确性，并提供实际案例参考。
审查插件 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 审查评论。包含代码风格规范、测试编写强制检查清单，以及处理评论前需加载相关技能（如 code-standards, testing-workflow）的流程要求。
需要回复或解决 GitHub PR 中的审查意见
在修改代码或添加测试前确认符合项目规范
npx skills add netalertx/NetAlertX --skill netalertx-pr-analysis -g -y
提供严谨的PRD写作方法论，强调基于代码验证主张、追踪下游依赖及评估性能影响。适用于跨子系统机制或Schema变更等高风险设计的文档编写与审查。
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项目的代码结构、关键路径及架构信息，帮助快速定位后端Python、前端PHP文件及配置文档。
询问项目目录结构
查找特定功能代码位置
了解配置文件或日志路径
npx skills add netalertx/NetAlertX --skill about-netalertx-project-structure -g -y
在NetAlertX开发容器中生成并导入合成设备数据，通过API端点将CSV格式的设备记录批量加载至数据库和UI，用于测试或演示场景。
加载示例设备
种子数据导入
导入测试设备
填充数据库
生成测试数据
npx skills add netalertx/NetAlertX --skill netalertx-sample-data -g -y
解析NetAlertX扫描管道内部逻辑，涵盖设备存在性计算、事件生成与会话关联机制。用于修改扫描处理代码或分析设备在线状态及连接事件。
修改扫描或会话相关后端代码
排查设备连接/断开异常
理解扫描管道数据流
npx skills add netalertx/NetAlertX --skill netalertx-scan-pipeline -g -y
