核心用法
servicenow-agent是一款专为ServiceNow平台设计的只读API客户端技能，通过命令行界面提供对Table API、Attachment API、Aggregate API和Service Catalog API的安全访问。用户需配置SERVICENOW_DOMAIN、SERVICENOW_USERNAME、SERVICENOW_PASSWORD三个环境变量完成认证初始化。
该技能采用明确的GET-only设计原则，严格禁止任何数据修改操作（POST/PUT/PATCH/DELETE）。核心命令包括：
list/get：查询表记录或按sys_id获取单条数据attach：读取附件元数据及下载文件内容stats：执行聚合统计分析sc：访问服务目录变量和配置schema：查询表结构字段定义history：获取工单完整评论和工作记录时间线batch：执行预设的批量查询配置
查询参数通过--sysparm_*前缀传递，支持字段筛选、结果限制、条件过滤等ServiceNow标准语法。输出默认为JSON格式，可使用--pretty美化展示，--out指定附件下载路径。
显著优点
安全架构设计：零第三方依赖，仅使用Node.js内置模块（fs/path/url），彻底消除供应链攻击风险。代码结构清晰无混淆，静态分析得分85分。
只读权限保障：功能设计层面锁定HTTP GET方法，从根本上杜绝误操作导致的数据变更风险，适合生产环境敏感数据查询场景。
企业级API覆盖：完整对接ServiceNow四大核心API，支持从基础数据查询、文件附件管理到服务目录配置的全方位只读访问，满足ITSM、CMDB、客服工单等多场景需求。
凭证安全实践：采用环境变量注入模式，避免硬编码敏感信息，符合GDPR数据最小化原则和CCPA透明度要求。
批量查询支持：通过specialists/目录下的JSON预设文件，可快速执行组合查询，提升重复性数据分析效率。
潜在缺点与局限性
功能边界严格：纯只读设计意味着无法执行任何工单状态更新、评论添加或附件上传操作，完整ITSM工作流仍需结合ServiceNow原生界面完成。
Basic Auth局限：当前仅支持基础认证方式，未集成OAuth 2.0等现代令牌机制，在企业SSO统一认证环境中可能需要额外适配。
结果集管控依赖用户：虽然提供sysparm_limit参数，但缺乏服务端强制分页限制，不当的大批量查询可能导致ServiceNow实例性能压力或请求超时。
字段名学习成本：初次使用陌生数据表时需借助schema命令探查字段定义，对ServiceNow数据模型不熟悉的用户存在上手门槛。
T3来源可信度：维护者为ClawHub平台个人开发者，非ServiceNow官方或企业级供应商背书，长期维护稳定性和安全更新响应需持续观察。
适合的目标群体
- IT运维工程师：需要批量查询CMDB配置项、监控告警工单状态、导出历史变更记录
- 客服与技术支持团队：快速检索客户工单详情、下载故障截图附件、追溯问题处理时间线
- 数据分析人员：通过Aggregate API获取服务台KPI统计，如工单分级分布、平均解决时长等
- ServiceNow管理员：执行表结构巡检、审计数据一致性、验证目录配置
- 合规审计角色：只读权限天然满足数据访问审计要求，降低越权操作风险
使用风险与注意事项
凭证泄露风险：环境变量配置模式下，.env文件若被误提交至版本控制或设置过于宽松的文件权限，将导致ServiceNow账号暴露。建议设置chmod 600权限并配置.gitignore排除。
权限过度授予风险：部分用户可能图方便直接使用管理员账号配置认证，违反最小权限原则。强烈建议ServiceNow端创建专用只读API账号，严格限制可访问的数据表范围。
数据隐私合规：查询结果可能包含终端用户个人信息（姓名、联系方式等），下载的附件内容需符合企业数据分类分级管理要求，避免本地存储造成合规隐患。
网络传输安全：虽默认使用HTTPS，但需确认目标实例强制启用TLS 1.2+，禁用SSLv3等弱协议版本，防范中间人攻击。
附件路径遍历：--out参数未对输出路径进行严格校验，恶意构造的附件文件名可能触发目录遍历。建议仅在受控目录（如/tmp或专用下载文件夹）执行下载操作。
查询性能影响：对大型数据表（如sys_audit审计表）执行无过滤条件的list操作，可能触发ServiceNow平台查询限制或影响生产实例响应性能。始终配合sysparm_query添加筛选条件。