Agent Skills
返回列表
💻

HeartFlow 审计修复与自愈

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fdb96f95/heartflow-audit-self-heal。

技能介绍

要解决什么问题

HeartFlow(心虫)体量一大,外部静态审计往往会一口气抛出几十到上百条 CRITICAL/HIGH/MEDIUM 告警。若照单全收改代码,很容易把 == null 这类合法惯用法、正则 pattern 列表的「重复块」、JSDoc 示例注释误当成缺陷,反而引入回归。另一条线是 自我升级:module_health 显示大量模块 degraded,根因常是缺 destroy/stop、getStats 等标准接口,逐个文件补洞成本高,且改完 MCP 仍可能读到旧引擎实例。

技能如何工作

审计修复按报告先分级:CRITICAL/HIGH 立即修,MEDIUM 评估后修,LOW 多数需确认。对典型误报用 search_files 等手段验证后再决定不动刀;只修可复现的真 bug(例如对 undefined 崩溃的 summarizeAdvice)。MEDIUM 里的空 catch 可用 Python 脚本批量加注释,避免用手工 patch 啃 4000+ 行文件。测试缺口则补 .gitignore、跑用例,并同步 VERSION 与 package.json。

自我升级(self-heal)针对模块健康分低:用零侵入 mixin 统一补齐生命周期与统计接口,配套 test/module-health-self-heal.test.js 模拟缺接口模块。代码落盘后必须 重启 src/mcp-server.js --port 8588,再调 heartflow_module_health 才能看到 live 实例上的效果。

边界与注意点

  • 审计报告不等于改稿清单:未经验证的条目默认不改。
  • Self-heal 场景不重启 MCP,工具侧会长期读到旧内存实例。
  • 收尾需对照验证清单:误报验证、语法与测试、版本同步、提交时排除 runtime artifact。

使用场景

  • 收到 HeartFlow 全量审计报告,要求按严重程度修一轮并排除 null 比较类误报
  • module_health 显示百余模块 degraded,需要 mixin 补生命周期接口而非逐文件手改
  • 审计要求给 engine-initializer 等文件里 30+ 处空 catch 批量加说明注释
  • self-heal 改完代码后 health 仍不变,需要按流程重启 8588 端口 MCP 再验证

适合人员

  • 维护 HeartFlow MCP 的工程师,常被要求「根据审计报告全面修复升级一次心虫」
  • 负责模块治理的开发者,需要把 healthScore 从个位数拉到满分且不动各模块业务逻辑
  • 做静态扫描治理的同学,要区分 MEDIUM 误报与 stability-guard 类真崩溃 bug
  • 发布前负责人,需要 VERSION、测试与 git 提交与审计清单逐项对齐