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命令
npx skills add netalertx/NetAlertX --skill git-workflow -g -y
提供安装脚本的审查规范，涵盖卸载安全、检查脚本退出码设计及遗留代码处理，辅助PR审查与修改。
review PR涉及install目录
编辑install下的脚本
npx skills add netalertx/NetAlertX --skill install-scripts -g -y
指导 NetAlertX 插件的开发、配置与运行。涵盖插件目录结构、配置文件规范、设置模式及数据契约，帮助开发者创建和调试插件功能。
创建新的 NetAlertX 插件
运行或测试现有插件
配置插件参数和脚本
npx skills add netalertx/NetAlertX --skill plugin-development -g -y
指导生成、审查或清理 NetAlertX 插件的 README.md 文档，强调以 Settings UI 为唯一事实来源，避免重复记录配置项，需基于实际代码验证内容并正确回填作者信息。
创建新插件的 README
审查现有插件文档
清理或增强插件说明
npx skills add netalertx/NetAlertX --skill plugin-readme -g -y
提供插件代码审查检查清单，重点检测脚本中违规使用原始SQL、数据日志安全性、依赖构建目标覆盖及scanPresence逻辑正确性，并附真实案例。
审查插件Pull Request
审计现有插件脚本
npx skills add netalertx/NetAlertX --skill plugin-review -g -y
指导Agent分析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
扫描管道与设备存在生命周期文档，涵盖进程顺序、核心表视图关系及会话关闭机制。用于修改设备连接、会话行为或字段写入权限时的参考指南。
修改扫描管道逻辑
处理设备在线/离线状态
调整会话或时间线行为
理解字段写入权限
npx skills add netalertx/NetAlertX --skill scan-pipeline -g -y
规范技能文档（SKILL.md）的写作标准，要求仅陈述当前行为、使用简洁平实的语言并禁止使用破折号。旨在维护知识库的准确性与可读性，避免混杂历史修订或叙事性内容。
编写新的 SKILL.md 文件
编辑现有的 SKILL.md 文件
清理或审查内部研究/审计文档
npx skills add netalertx/NetAlertX --skill skill-hygiene -g -y
提供在开发容器中运行测试的完整工作流，包括环境检查、执行全量或快速测试套件、运行特定测试及获取API令牌。指导如何处理预存失败和Docker镜像重建，并警示模块桩污染陷阱。
用户要求运行测试
需要检查测试失败原因
调试失败的测试用例
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
前端UI设计模式指南，规定添加或修改界面元素前需复用现有模式。提供设计决策优先级（已有行为>直观性等），并给出实操检查清单，旨在避免重复造轮子，确保UI一致性与主题兼容。
新增前端UI组件
修改现有界面交互
设计UI布局或控件
npx skills add netalertx/NetAlertX --skill ux-design-patterns -g -y
NetAlertX数据库架构规范，指导Devices表写入路径审计及*Source字段溯源机制设计，涵盖触发器与Python钩子方案选择。
设计涉及Devices表的读写功能
实现审计或历史日志记录
选择数据库触发器或Python钩子方案
npx skills add netalertx/NetAlertX --skill database-patterns -g -y
指导识别和管理NetAlertX开发容器，通过docker ps查找容器并执行命令。用于运行测试、设置脚本或排查容器问题，确保在正确的环境中操作后端逻辑。
需要运行开发环境命令
调试容器相关问题
执行安装或设置脚本
npx skills add netalertx/NetAlertX --skill devcontainer-management -g -y
规范 Git 工作流，禁止擅自创建分支，默认直接提交至 next_release 分支。执行关键操作前需确认状态并征得用户同意，防止共享仓库状态冲突。
需要创建新 Git 分支时
执行 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后端Python代码的日志规范，规定使用mylog函数、日志级别及消息格式，禁止直接导入logging或硬编码路径。
添加新日志语句
修改现有日志逻辑
审查代码中的日志实现
npx skills add netalertx/NetAlertX --skill logging-standards -g -y
配置 NetAlertX 的 MCP 连接，使 AI Agent 能访问运行时 API，支持数据库查询、网络扫描和设备管理等动态操作。
需要连接 NetAlertX 运行时进行调试
执行实时设备管理或网络扫描任务
npx skills add netalertx/NetAlertX --skill mcp-activation -g -y
提供插件代码审查清单，重点检查插件脚本中是否违规使用原始SQL、数据日志安全性、依赖构建目标覆盖及scanPresence逻辑正确性。
审查插件Pull Request
审计现有插件脚本
npx skills add netalertx/NetAlertX --skill plugin-review -g -y
指导 Agent 分析并响应 GitHub PR 审查评论。涵盖代码风格、测试规范及评论分类处理流程，强调在修复问题时同步更新或创建相关 Skill，确保符合项目标准。
处理 GitHub PR 审查反馈
回复代码评论线程
解决内联代码注释
npx skills add netalertx/NetAlertX --skill pr-analysis -g -y
指导编写PRD和设计文档的严谨方法，强调基于实际代码验证声明、追溯下游影响及评估性能。适用于跨子系统机制或Schema变更等高成本设计场景。
write a PRD
draft a design doc
npx skills add netalertx/NetAlertX --skill prd-writing -g -y
解析扫描流水线中设备存在性生命周期，涵盖CurrentScan、Events、Sessions等核心表与视图关系，说明会话闭合机制及字段写入权限，辅助修改session_events.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 文件
撰写 .gemini/internal-docs/research/ 下的研究或审计文档
npx skills add netalertx/NetAlertX --skill skill-hygiene -g -y
提供Gemini CLI、GitHub Copilot和Claude Code三大AI助手的技能索引与交叉参考，帮助用户在不同工具间查找对应或更丰富的技能版本。
需要在不同AI助手之间迁移或对比技能
查找特定功能的AI技能实现
npx skills add netalertx/NetAlertX --skill skills-index -g -y
指导在开发容器中运行测试的规范，涵盖全量套件、快速单元测试及特定文件执行。包含环境检查、认证令牌获取与重置流程，以及预存失败排查和 PYTHONPATH 配置说明。
用户请求运行测试
代码完成后自动触发测试
需要获取 API Token 进行测试
npx skills add netalertx/NetAlertX --skill testing-workflow -g -y
指导前端开发遵循复用优先原则，禁止无PRD创新UX。提供设计决策优先级（现有行为>直觉等）及实操检查清单，要求通过grep查找并复用已有UI模式，确保样式与主题一致。
添加或修改前端UI元素
设计交互模式或布局
决定前端视觉风格
npx skills add netalertx/NetAlertX --skill ux-design-patterns -g -y
指导开发NetAlertX REST API端点，涵盖Flask入口、现有路由、Bearer令牌鉴权及统一响应格式规范。用于创建新接口或修改API逻辑，确保遵循授权与契约标准。
创建新的API端点
添加API路由
实现API功能
修改API响应结构
npx skills add netalertx/NetAlertX --skill api-development -g -y
管理 NetAlertX API 令牌和认证密钥，涵盖查找、轮换、验证及调试 401/403 错误。提供通过 Python 或 Docker 检索令牌的方法，以及安全最佳实践。
需要生成或轮换 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设备表写入路径审计与来源追踪机制的设计模式，指导开发者在涉及数据写入、历史日志及触发器实现时遵循规范，确保数据一致性与正确性。
设计涉及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 运行时环境，清理服务、临时文件及日志，同时保留持久化数据。适用于修复环境损坏、重新配置或容器重建后的状态初始化。
re-run startup
reprovision setup 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 资源
释放磁盘空间
Docker 清理
npx skills add netalertx/NetAlertX --skill netalertx-docker-prune -g -y
规范 Git 工作流，禁止擅自创建分支，默认直接提交至 next_release 分支。执行任何变更状态的命令前需确认当前状态，推送前必须获得用户明确许可，防止共享仓库状态冲突。
需要创建新分支
准备提交代码
执行 git push 操作
npx skills add netalertx/NetAlertX --skill netalertx-git-workflow -g -y
规范 NetAlertX 安装脚本的维护与审查，涵盖卸载安全、检查脚本退出码差异及遗留代码处理。
审查或编辑 install/ 目录下的脚本
评估涉及安装流程的 PR
npx skills add netalertx/NetAlertX --skill netalertx-install-scripts -g -y
定义NetAlertX后端Python代码的日志记录规范，包括使用mylog模块、日志级别选择、消息格式及安全注意事项，用于指导日志语句的添加、修改和审查。
添加或修改Python代码中的日志语句
审查代码中的日志实现是否符合规范
npx skills add netalertx/NetAlertX --skill netalertx-logging-standards -g -y
配置 MCP 连接以启用 NetAlertX 运行时交互，支持数据库查询、网络扫描和设备管理等实时操作。
需要访问 NetAlertX 运行时 API
进行实时系统调试或故障排查
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、数据日志安全、依赖构建目标及扫描存在性正确性等非机械检查项，辅助代码质量把控。
审查插件Pull Request
审计现有插件脚本
npx skills add netalertx/NetAlertX --skill netalertx-plugin-review -g -y
指导如何开发、配置和手动运行 NetAlertX 插件。涵盖插件结构、配置文件设置模式、Python 脚本执行命令及结果日志的读取方法，帮助开发者完成插件创建与调试。
创建 NetAlertX 插件
运行或测试插件
插件开发相关任务
npx skills add netalertx/NetAlertX --skill netalertx-plugin-run-development -g -y
指导 Agent 分析并响应 GitHub PR 审查评论。涵盖代码风格、测试规范及评论分类处理流程，强调根据反馈更新或创建 Skill，确保代码变更符合标准。
需要处理 GitHub PR 审查意见
收到关于代码的评论或建议
需要决定如何回复 PR 线程中的问题
npx skills add netalertx/NetAlertX --skill netalertx-pr-analysis -g -y
用于编写或审查PRD及设计文档的严谨方法论。强调基于实际代码验证主张、挑战方案合理性、识别正交关注点，并记录被拒方案与决策，适用于高风险架构变更前的设计阶段。
write a PRD
draft a design doc
spec out this feature
npx skills add netalertx/NetAlertX --skill netalertx-prd-writing -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 扫描流水线内部逻辑，涵盖 CurrentScan、Events、Sessions 等核心表视图关系及字段写入权限。用于修改设备存在性判断、连接断开事件或会话时间线相关代码时的参考。
修改 scan/session_events.py
修改 scan/device_handling.py
分析设备在线状态与连接事件
npx skills add netalertx/NetAlertX --skill netalertx-scan-pipeline -g -y
