HeartFlow 调试工作流
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fdb96f95/heartflow-debug-workflow。
技能介绍
要解决什么问题
HeartFlow(心虫)是多模块 Node 引擎:boot 报 ReferenceError、注册了却没人 think() 调用、Pipeline 抛出 deadlock、或 package.json / VERSION / SKILL.md 多处版本不一致,都会让「能跑起来」和「认知输出靠谱」两件事同时崩掉。本技能把这类故障收成可复现的诊断路径,而不是零散搜日志。
技能如何工作
- 入口分流:按用户描述(启动失败、版本错误、写了一堆代码没调用、目录嵌套奇怪等)匹配模式——快速 Step 1(P0) 还是 7 阶段启动诊断、是否要做 SKILL.md 与实际文件一致性审计。
- 结构性修复:目录结构修复模式会归一化
require路径、清理注册表与ALLOWED_ROUTES里的死模块;版本修复以package.json为唯一真相源,区分bumpVersion()会同步与需手改注释的文件。 - Pipeline 与认知坑:覆盖阶段循环依赖、
ctx.<stageId>字段不匹配、whatIsThis空壳、情绪单字误报、judgmentEngine.recordOutcome缺id、场域快照被后续dispatch覆盖等已知根因与对应改法。 - 验证清单:修完后强调
node -e "require(...)"测惰性加载、并行语法审计、以及think()输出是否含judgment/ 认知字段,避免 try-catch 静默吞错。
适用边界与注意点
技能针对 HeartFlow 代码库与约定结构(如 heartflow.js、_registerModules()、pipeline.js),不替代通用 Node 项目排错。多引擎版本并存时须先确认实际活跃引擎,避免改错副本。并发 cron 修复同一问题时,可能出现 working tree 已空、无需重复 commit 的情况——文档里已有判定方式。
使用场景
- 心虫 boot 抛 ReferenceError 或 new 某类失败,需要按 Step 1 找缺失 import 与 stub 委托
- 用户反馈写了许多模块但 think 没走到,要区分注册表 60 个模块与 Pipeline 实际阶段
- Pipeline.run 报 deadlock 或某阶段 ctx 上游字段为 undefined,要核对 DEFAULT_PIPELINE 依赖与阶段 id
- 升级后 VERSION、package.json、SKILL.md 三处版本不一致,要以 package.json 为准做 bumpVersion 同步
适合人员
- 维护心虫 monorepo 的工程师,需要在用户说「启动失败」时快速做 P0 boot 与 7 阶段存活检查
- 负责 Pipeline 重构的开发者,要把硬编码 think 流水线迁到 pipeline.js 并消除阶段死锁与数据流断裂
- 做认知模块联调的同学,要修 whatIsThis 空壳、情绪误报、judgment 模板化及 LEARNED 记忆未写入
- 接入 Hermes/插件链路的集成者,要验证 cli think、判定注入与 prefetch 超时等端到端路径