AgentSkillsCN

fetching-truffle-documentation

从 GraalVM、Truffle 以及 Graal 编译器的官方文档中获取权威信息，涵盖 API 指南、性能优化策略、编译器标志、性能剖析、特殊化技术、字节码 DSL、Truffle DSL、部分求值以及编译分析等内容。当您需要关于 Truffle 框架、GraalVM 编译器选项或各类优化技巧的权威参考资料时，可优先选用此工具。此外，当您就 Truffle API、编译器标志、特殊化模式或 Graal 选项进行咨询时，亦可参考该工具。

SKILL.md
--- frontmatter
name: fetching-truffle-documentation
description: Fetches information from official GraalVM, Truffle, and Graal compiler documentation for API guidance, performance optimization, compiler flags, profiling, specializations, Bytecode DSL, Truffle DSL, partial evaluation, and compilation analysis. Use when you need authoritative documentation about Truffle framework, GraalVM compiler options, or optimization techniques. Use when asking about Truffle API, compiler flags, specialization patterns, or Graal options.

Fetching Truffle Documentation

Searches official GraalVM, Truffle, and Graal compiler documentation to answer technical questions about APIs, performance optimization, and compiler behavior.

Primary Documentation Sources

GraalVM Official Docs: https://docs.oracle.com/en/graalvm/

  • •Language implementation guides
  • •Tools and utilities
  • •Performance optimization guides

GraalVM Tools Javadoc: https://www.graalvm.org/tools/javadoc/

  • •API reference for com.oracle.truffle.api.* packages
  • •Node implementations, frame management, interop protocols

Graal GitHub Repository: https://github.com/oracle/graal

  • •Truffle framework documentation in /truffle/docs/
  • •Compiler documentation in /compiler/docs/
  • •SimpleLanguage reference implementation

Key Documentation Paths

Performance Optimization:

  • •/truffle/docs/Optimizing.md - Optimization strategies
  • •/truffle/docs/Profiling.md - Profiling tools
  • •/compiler/docs/ - Graal compiler tuning

Truffle Framework:

  • •/truffle/docs/LanguageTutorial.md - Language implementation guide
  • •/truffle/docs/DSL.md - Truffle DSL specializations
  • •/truffle/docs/BytecodeDSL.md - Bytecode DSL implementation

Compiler Options Quick Reference

Profiling and Tracing:

  • •--engine.TraceCompilation - Log compilation events
  • •--engine.TracePerformanceWarnings - Detect optimization barriers
  • •--engine.TraceInlining - Show inlining decisions
  • •--cpusampler, --cputracer, --memtracer - Profiling tools

Diagnostic Options:

  • •-Djdk.graal.Dump=Truffle - Dump compiler graphs
  • •-Djdk.graal.PrintGraph=File - Output format for graphs

When to Use This Skill

Search documentation when you need:

  • •Explanation of compiler flags or profiling tools
  • •API usage for Truffle DSL or Bytecode DSL
  • •Performance optimization strategies
  • •Understanding of compiler warnings or deoptimization causes