Hermes Agent代码质量检查需执行五步：一、ESLint静态分析；二、TypeScript类型校验；三、Prettier统一格式化；四、Jest单元测试覆盖率验证；五、Secret Scanner敏感信息扫描。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在开发Hermes Agent相关代码，但发现存在潜在逻辑缺陷、风格不一致或可维护性下降等问题，则可能是由于缺乏系统化的质量检查机制。以下是针对Hermes Agent代码开展质量检查的具体操作路径：
一、执行ESLint静态分析
ESLint可识别不符合Hermes Agent代码规范的语法结构、未声明变量、冗余代码及潜在运行时错误，确保基础编码一致性。
1、在项目根目录下确认存在.eslintrc.js配置文件，且已启用@hermes/eslint-config-agent共享规则集。
2、运行命令npx eslint src/**/*.{js,ts} --fix，自动修复可修正项并输出剩余问题报告。
3、检查控制台中所有error级别告警，逐条确认是否属于误报；若为真实缺陷，必须修改代码直至无error级提示。
二、运行TypeScript类型校验
TypeScript编译器能捕获接口缺失、参数类型错配、泛型约束失效等强类型问题，保障Hermes Agent模块间契约可靠性。
1、确保tsconfig.json中"strict": true、"noImplicitAny": true、"skipLibCheck": false均已启用。
2、执行npx tsc --noEmit --watch启动类型监听模式，实时反馈类型错误位置。
3、对报错行中的any、undefined、null使用场景进行重构，所有Agent服务入口函数必须标注完整参数与返回类型。
三、集成Prettier统一格式化
Prettier消除团队成员间缩进、引号、分号、括号换行等主观风格差异，使Hermes Agent代码具备视觉一致性与可读性。
1、安装依赖：npm install --save-dev prettier @prettier/plugin-xml（如含XML模板需额外插件）。
2、创建.prettierrc配置文件，明确设置"semi": true、"singleQuote": true、"tabWidth": 2。
3、执行npx prettier --write "src/**/*.{js,ts,jsx,tsx,json}"，禁止手动调整格式，全部交由Prettier接管。
四、运行单元测试覆盖率验证
Jest测试套件覆盖Hermes Agent核心状态机、消息路由、上下文注入等关键路径，防止低覆盖率引入隐蔽缺陷。
1、确认jest.config.js中collectCoverageFrom包含src/agent/**/*.{js,ts}且排除__mocks__与index.ts。
2、执行npx jest --coverage --collectCoverageFrom=src/agent/**/*.{js,ts}生成覆盖率报告。
3、检查Statements与Branches两项均不低于85%，任何低于该阈值的模块必须补充对应测试用例后重新运行。
五、扫描敏感信息与硬编码
Secret Scanner工具可识别Hermes Agent代码中意外嵌入的API密钥、Token、内部域名、测试账号等高风险字符串，规避安全泄露。
1、安装git-secrets或gitleaks，初始化规则库并添加自定义正则模式，例如匹配HERMES_[A-Z_]+_KEY。
2、执行gitleaks detect -r . --no-git --verbose扫描全部源码文件。
3、对扫描出的每处匹配结果人工复核，确认为密钥或凭证的必须移至环境变量注入，并在代码中使用process.env读取。
