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命令
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
