cs-compilers

cs-compilers

用途

此技能可帮助 AI 处理编译器相关任务，包括词法分析、语法分析（LL/LR/PEG）、构建 AST、语义分析、使用 LLVM 生成代码、优化，以及集成 Tree-sitter 进行实时解析。

使用时机

在开发编译器、分析源代码、调试解析器、生成优化后的机器码，或将解析功能集成到 IDE 等工具中时，使用此技能。它适用于涉及代码转换的任务，例如编程语言中的转译或静态分析。

核心能力

• 词法分析：使用正则表达式对输入进行标记化；例如，在词法分析器中定义 r'\b(int|float)\b' 这样的关键字模式。
• 语法分析：使用递归下降法实现 LL(1)，或借助 yacc 等工具实现 LR(1)；使用 packrat 等库实现 PEG；集成 Tree-sitter 以实现高效解析，例如使用 tree_sitter.Language.build('path/to/tree-sitter-javascript.wasm') 加载语言语法。
• AST 处理：构建和操作 AST；遍历节点进行分析，例如使用 Tree-sitter 的游标：cursor = tree.walk(); while cursor.goto_first_child(): process_node(cursor)。
• 语义分析：执行类型检查和作用域解析；例如，在符号表中检查变量声明与使用情况是否匹配。
• 代码生成：生成 LLVM IR；使用 LLVM C++ API 创建模块，例如调用 LLVMModuleCreateWithName("MyModule")，然后添加函数。
• 优化：应用常量传播或死代码消除等优化遍；例如，运行 LLVM 的 opt 工具并使用 -O3 等标志进行积极优化。
• Tree-sitter 集成：实时解析代码；通过预构建的语法支持 C、Python 等语言。

使用模式

通过 OpenClaw CLI 直接调用此技能，或通过 SDK 以编程方式访问。始终以 JSON 格式指定操作和参数。对于 CLI，请使用：openclaw invoke cs-compilers --action <action> --params '<JSON string>'。在代码中，导入 SDK 并调用：from openclaw import Client; client = Client(api_key=os.environ['OPENCLAW_API_KEY']); response = client.invoke('cs-compilers', {'action': 'parse', 'params': {'language': 'c', 'code': 'int main(){}'}})。将 params 组织为字典，包含 "language" 和 "code" 等键。如果使用外部工具，请确保依赖项（例如 LLVM）已安装且路径配置正确。

常用命令/API

• 解析代码：CLI：openclaw invoke cs-compilers --action parse --params '{"language": "python", "code": "def foo(x): return x+1"}'；返回 JSON 格式的 AST。API：POST /api/skills/cs-compilers，正文为 { "action": "parse", "params": { "language": "python", "code": "def foo(x): return x+1" } }。
• 生成 LLVM IR：CLI：openclaw invoke cs-compilers --action generate-llvm --params '{"language": "c", "code": "int add(int a, int b) { return a+b; }", "optimize": true}'；使用 --optimize 等标志执行优化遍。API：POST /api/skills/cs-compilers，正文为 { "action": "generate-llvm", "params": { "language": "c", "code": "int add(int a, int b) { return a+b; }" } }。
• 分析输入：CLI：openclaw invoke cs-compilers --action lex --params '{"input": "int x = 5;", "patterns": ["\\bint\\b"]}'；输出令牌数组。API：POST /api/skills/cs-compilers，正文为 { "action": "lex", "params": { "input": "int x = 5;", "patterns": ["\bint\b"] } }。
• 配置格式：使用 JSON 传递 params，例如 { "grammar": "path/to/grammar.json", "options": { "debug": true } }。身份验证：为所有 API 调用设置环境变量 $OPENCLAW_API_KEY。

集成说明

通过安装 OpenClaw SDK（pip install openclaw）并在项目中导入它来进行集成。对于 LLVM，请确保已安装 clang，并通过 llvm-config --cxxflags 进行链接。Tree-sitter 需要编译语法；例如，克隆一个仓库并使用 make 构建。在环境中处理依赖项；例如，为 LLVM 工具设置 PATH。对于自定义解析器，请提供如下配置 JSON：{ "parserType": "LR", "grammarRules": [{ "rule": "E -> T + E" }] }。在沙盒中测试集成，以验证响应。

错误处理

始终检查响应对象中是否有 'error' 键；如果存在，其中包含错误代码和消息。对于命令行，请解析输出 JSON：如果 response['error'] 存在，则使用 response['error']['code'] 退出。在 SDK 中：try: response = client.invoke(...); except OpenClawError as e: log(e.code, e.message)。常见错误：400 表示参数无效（例如，JSON 格式错误），401 表示身份验证问题（检查 $OPENCLAW_API_KEY），500 表示内部故障，例如解析器崩溃。对于暂时性错误（例如，503），使用指数退避重试，并在调用前验证输入，例如确保 'language' 是受支持的字符串，如 'c' 或 'python'。

具体用法示例

1. 解析 C 函数：要解析并提取简单 C 函数的 AST，请运行：openclaw invoke cs-compilers --action parse --params '{"language": "c", "code": "int main() { return 0; }"}'。这会返回类似 { "type": "function_definition", "name": "main", "body": [...] } 的 JSON AST。使用 AST 分析结构，例如统计节点数。
2. 生成优化后的 LLVM IR：要从 C 代码生成并优化 LLVM IR，请执行：openclaw invoke cs-compilers --action generate-llvm --params '{"language": "c", "code": "int add(int a, int b) { return a + b; }", "optimize": true}'。输出可能为："define i32 @add(i32 %a, i32 %b) { %1 = add i32 %a, %b; ret i32 %1 }"。将其传递给 LLVM 工具以进行后续编译。

图关系

• 相关：programming-languages（共享语言设计中的解析和 AST 技术）
• 相关：software-engineering（通过代码优化以及与构建工具的集成建立联系）
• 相关：algorithms（在 LL 和 LR 等高效解析算法方面存在交集）