Agent Skills
返回列表
💻

HeartFlow 调试工作流

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 超时等端到端路径