AGENT SKILL

estree-ast-spec

暂无简介

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 13
Forks
2

03 SKILL.md 正文

/estree-ast-spec

When to Use

  • Write AST walkers/visitors without a framework dependency
  • Understand node shapes before writing Babel/ESLint plugins
  • Build custom parsers, formatters, or analysis tools that consume ESTree output
  • Type-guard node types in TypeScript-based AST tooling

Do NOT use for

  • Babel-specific transforms (use [[babel-ast-transform]])
  • TypeScript AST (use [[ts-morph-refactor]] — TypeScript extends ESTree)

Core ESTree node types (reference)

// ESTree node base
interface Node {
  type: string
  loc?: SourceLocation
}

// Common statement nodes
type Statement =
  | ExpressionStatement   // expr;
  | VariableDeclaration   // const x = 1
  | FunctionDeclaration   // function f() {}
  | ReturnStatement       // return x
  | IfStatement           // if (x) {}
  | BlockStatement        // { ... }
  | ImportDeclaration     // import x from 'y'
  | ExportNamedDeclaration

// Common expression nodes
type Expression =
  | Identifier            // x
  | Literal               // 42, "str", true
  | CallExpression        // f(args)
  | MemberExpression      // obj.prop
  | ArrowFunctionExpression
  | BinaryExpression      // a + b
  | AssignmentExpression  // a = b
  | ObjectExpression      // { k: v }
  | ArrayExpression       // [1, 2]
  | TemplateLiteral       // `${x}`

Simple recursive AST walker

import { parse } from 'acorn'

function walk(node, visitors) {
  if (!node || typeof node !== 'object') return

  const visitor = visitors[node.type]
  if (visitor) visitor(node)

  for (const key of Object.keys(node)) {
    const child = node[key]
    if (Array.isArray(child)) {
      child.forEach(c => walk(c, visitors))
    } else if (child && typeof child === 'object' && child.type) {
      walk(child, visitors)
    }
  }
}

// Usage: find all function declarations
const ast = parse(source, { ecmaVersion: 2022, sourceType: 'module' })
const fns: string[] = []

walk(ast, {
  FunctionDeclaration(node) {
    fns.push(node.id?.name ?? '<anonymous>')
  },
  ArrowFunctionExpression(node) {
    fns.push('<arrow>')
  },
})

console.log('Functions:', fns)

Type guards for safe node access

function isIdentifier(node: Node): node is Identifier {
  return node.type === 'Identifier'
}
function isCallExpression(node: Node): node is CallExpression {
  return node.type === 'CallExpression'
}
function isMemberExpression(node: Node): node is MemberExpression {
  return node.type === 'MemberExpression'
}

// Safe extraction: detect `process.env.FOO` pattern
function isProcessEnvAccess(node: Node): boolean {
  if (!isCallExpression(node)) return false
  const { callee } = node
  return (
    isMemberExpression(callee) &&
    isMemberExpression(callee.object) &&
    isIdentifier(callee.object.object) &&
    callee.object.object.name === 'process' &&
    isIdentifier(callee.object.property) &&
    callee.object.property.name === 'env'
  )
}

Count cyclomatic complexity via AST

function cyclomaticComplexity(fnNode) {
  let complexity = 1  // base path
  walk(fnNode, {
    IfStatement:         () => complexity++,
    ConditionalExpression: () => complexity++,  // ternary
    LogicalExpression(n) { if (n.operator === '&&' || n.operator === '||') complexity++ },
    SwitchCase:          () => complexity++,
    WhileStatement:      () => complexity++,
    ForStatement:        () => complexity++,
    ForInStatement:      () => complexity++,
    ForOfStatement:      () => complexity++,
    CatchClause:         () => complexity++,
  })
  return complexity
}

Anti-Fake-Pass Checklist

❌ Accessing node.name without checking node.type === 'Identifier' → runtime crash
❌ Walking AST without null guards → loc, id, init can all be null
❌ Confusing ESTree with Babel's @babel/types — Babel adds extra nodes (OptionalCallExpression etc.)
❌ Using acorn without ecmaVersion: 2022 → modern syntax fails to parse
❌ Recursive walker without cycle detection → circular references hang the process
❌ Missing sourceType: 'module' → import/export statements throw SyntaxError

04 同仓库更多 Skills

Horonomos-laps
Horonomos-laps/Yana-AI

openai--sentry--sentry

Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script and require `SENTRY_AUTH_TOKEN`.

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

ito-basket-compare

Compare Itô prediction-market baskets against a user's knowledge base, portfolio notes, financial context, watchlist, or research thesis. Use for read-only basket comparison and gap analysis without investment advice or live trading.

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

implementing-network-traffic-baselining

Build network traffic baselines from NetFlow/IPFIX data using Python pandas for statistical analysis, z-score anomaly detection, and hourly/daily traffic pattern profiling

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

detecting-evasion-techniques-in-endpoint-logs

Detects defense evasion techniques used by adversaries in endpoint logs including log tampering, timestomping, process injection, and security tool disabling. Use when investigating suspicious endpoint behavior, building detection rules for evasion tactics, or conducting threat hunting for stealthy adversary activity. Activates for requests involving evasion detection, defense evasion analysis, log tampering detection, or MITRE ATT&CK TA0005.

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

implementing-microsegmentation-with-guardicore

Implementing microsegmentation using Akamai Guardicore Segmentation to map application dependencies, create granular network policies, visualize east-west traffic flows, and enforce least-privilege communication between workloads across data centers and cloud.

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

ramdisk-tmpfs-patterns

暂无简介

★ 13