用途:这是 StarMapper 项目的代码库健康审计技能,在用户要求运行迁移后的 tech-audit-codebase 命令时使用,建议在重大发布或架构变更前执行。
主要能力:按 7 个类别打分(每类 0–10 分),计算加权全局分并给出分级结论。类别与权重为:密钥与令牌 2x、安全 2x、依赖 1x、结构 1.5x、限流安全 2x、缓存完整性 1.5x、代码质量 1x。全局分 = sum(分数×权重)/sum(权重)。分级:0–4 为 Tier 1 严重,阻止发布;5–7 为 Tier 2 需改进,本迭代内处理;8–10 为 Tier 3 可投入生产。输出包含分级评估、加权全局分和按优先级排列的行动计划。
使用方式:/tech:audit-codebase 执行全量审计;加 --category secrets 审计单个类别;加 --fix 审计并自动修复安全项;加 --json 输出 JSON 供 CI 使用。审计通过 grep、find 等命令检查硬编码密钥、CSP 头、依赖过期与 CVE、命名与导入规范、Nominatim 调用延迟与熔断、缓存键规范化与压缩、TypeScript 与 ESLint 错误等,并运行 rtk pnpm outdated、rtk tsc、pnpm lint。
适用场景:StarMapper 发布前检查、架构调整前评估、CI 中集成 JSON 结果。
限制:评分规则与检查项针对 StarMapper 特定实现(如 Nominatim 1100ms 延迟、Jawg/Geoapify 熔断、GeoCache 键、StargazerCache 压缩),其他项目需调整;资料未提供安装方式、收费信息与运行环境要求。