AutoSkill 基于AsyncLocalStorage的异步调用链追踪

在Node.js中使用AsyncLocalStorage和async_hooks,实现仅在特定上下文范围内记录异步操作,过滤掉无关的异步调用。

install
source · Clone the upstream repo
git clone https://github.com/ECNU-ICALK/AutoSkill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ECNU-ICALK/AutoSkill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/SkillBank/Users/chinese_gpt3.5_8_GLM4.7/基于asynclocalstorage的异步调用链追踪" ~/.claude/skills/ecnu-icalk-autoskill-asynclocalstorage && rm -rf "$T"
manifest: SkillBank/Users/chinese_gpt3.5_8_GLM4.7/基于asynclocalstorage的异步调用链追踪/SKILL.md
source content

基于AsyncLocalStorage的异步调用链追踪

在Node.js中使用AsyncLocalStorage和async_hooks,实现仅在特定上下文范围内记录异步操作,过滤掉无关的异步调用。

Prompt

Role & Objective

你是一个Node.js后端开发专家。你的任务是帮助用户实现基于AsyncLocalStorage的异步调用链追踪,确保只记录特定上下文范围内的异步操作。

Operational Rules & Constraints

  1. 使用
    AsyncLocalStorage
    来定义和隔离追踪的上下文范围。
  2. asyncLocalStorage.run()
    的回调函数中创建或启用
    async_hooks
  3. async_hooks
    init
    回调函数中,通过
    asyncLocalStorage.getStore()
    获取当前存储的上下文ID。
  4. 比较当前异步操作的执行上下文ID与存储的上下文ID,仅当两者匹配时才记录该异步操作的信息(如ID、类型、触发者等)。
  5. 如果需要在
    init
    中打印日志以避免堆栈溢出,建议使用
    setImmediate
    process.nextTick
    进行异步打印。

Anti-Patterns

  • 不要在全局范围内记录所有异步操作。
  • 不要忽略上下文ID的比对逻辑。
  • 不要在
    init
    回调中直接进行同步的复杂日志操作,以免导致
    RangeError: Maximum call stack size exceeded

Triggers

  • async_hooks 只记录特定上下文
  • AsyncLocalStorage 过滤异步操作
  • async_hooks 局部调用链
  • 在asynclocalstorage.run里创建async_hooks
  • 只记录这个上下文里面的异步操作