HeartFlow 核心优化工作流
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fdb96f95/heartflow-core-optimizer。
技能介绍
要解决什么问题
大型 HeartFlow 类引擎仓库常见症状:单文件逼近五万行、几十个源文件、测试名存实亡、多版本号并存,以及 require 成功却从不调用的「死工具」模块。若只靠直觉删文件,容易误删 Q-learning、元学习等有完整导出但未引用的模块;若只做行级 patch,审计与批量归档的成本会差一个数量级。
技能如何工作
本技能把 唯一对齐标准 写死:模块是否直接服务「思考宇宙与人的关系、传递答案、减少逻辑错误」。不满足则归档,并给出重建触发信号(如审计评分低于 4 分、主引擎超 1 万行等)。
核心能力包括:
- 重建 vs 增量修复:清单式批量写入待删项,三遍 pass 覆盖
require、wrapper、module.exports;子目录用find而非os.listdir。 - 四层验证法:加载 → 初始化(
new)→ 方法被调用 → 间接依赖链;区分「有导出未调用」与真实运行模块。 - 落核心:优先设计 bridge(如 critic-healing、decision-execution 串联),而非堆新文件。
- 真实升级对照表:不只比删行数,还要看核心模块对齐、零警告加载、测试同步、归档
.bak可恢复。 - 专项工作流:记忆层死代码审计、CORE 规则 BM25 去重、Cron 单模块功能补全(≥50 行真实判断逻辑)、SKILL.md token 瘦身、三路并行源码审计。
适用边界与注意点
技能面向 HeartFlow 生态内的源码治理,不是通用 JavaScript 重构教程。执行前需能跑引擎加载与项目自带测试脚本;删除模块时必须同步修复 transitive require 链与测试中的版本断言。装饰性哲学文案可能掩盖可用函数,归档前需扫描 class/function 导出;「未在引用图出现」不等于无价值,按决策表保留未来模块。
使用场景
- 主引擎文件突破一万行且审计评分低于四分,需要判断是完全重建还是保留 CORE_IDENTITY 后重写核心模块
- 批量归档几十个装饰性 JS 文件前,要区分「未被 require 但有完整 Q-learning 导出」与纯 wrapper 死代码
- 记忆系统专项清理:删除从未 require 的 mem0-memory、仅 new 从不调方法的 meaningful-memory 及 internal 镜像目录
- 升级单个 skeleton 模块(如 execution-verifier)时,按 Cron 工作流只改一个文件并补全状态枚举与错误分级逻辑
适合人员
- 维护 HeartFlow 衍生引擎的 Node 开发者,需要在不破坏加载链的前提下删掉数 MB 死代码并同步测试
- 负责心虫/Agent 技能 SKILL.md 体积的维护者,希望把 Historical 章节归档以降低 Hermes 解析 token
- 做开源技能发布前代码审计的贡献者,要用三路并行扫描产出 CRITICAL/HIGH 问题清单并二次验证误报
- 在 meaningful-core.json 上治理 CORE 规则的工程师,要清理重复 entropy 规则与单字 identity 项以减轻 BM25 噪声