用途:按请求或上下文确定范围,对代码库做只读架构审计,报告具体设计问题。若已有明确授权应用结论,可包含修复建议。判断设计时参考项目边界与公共兼容性策略。
主要能力与关注信号:识别死导出、职责重复、循环依赖、所有权/类型混乱,以及代价高昂的变更模式。用 rg --files、限定范围的 rg 搜索和可用的静态分析输出梳理入口点与相关依赖。分类候选问题时查阅 references/detection-catalog.md 的对应章节;阈值只是线索,不等同于缺陷。
使用方式:先解析范围,再追踪使用情况,确认代码确实无引用后才判定为死代码,需覆盖动态加载、反射、框架钩子、测试与已发布的 API;仅因当前检出没有消费者,不能安全删除未引用的公共导出。每条重要发现都要在源码中确认,说明行为或维护成本,引用路径/行号,标注不确定性,并给出最小可用改动。不要为每个源文件建一个待办,也不要假定是 TypeScript 技术栈;当泛化的异味扫描没有证据时不必单独执行。
报告:规模与请求匹配。大范围审计可参考 assets/report-template.md,保存为 .audits/architectural-analysis-<timestamp>.md,并区分已检查与未检查区域;窄问题用简洁发现列表即可。覆盖缺失不能写成“未发现问题”。现有源码与摘要模板只是可选的呈现辅助,不是必须产出两份报告。
限制:该技能仅做审计,不负责格式化、性能剖析和安全审计。动态加载、反射、框架钩子、测试和公开 API 中的引用需人工追踪,静态分析可能漏报。资料未提供具体安装命令、支持语言或收费信息。