تشغيل أي مهارة في Manus بنقرة واحدة

codebase-map

النجوم٢

التفرعات٠

آخر تحديث٩ يوليو ٢٠٢٦ في ١٩:١٥

Use when you need to know where a file, module, or subsystem lives in the Arrow repository (Rust src/, Python impl_python/, examples/, vscode-extension/), or what a given file is responsible for. Read this before navigating an unfamiliar part of the tree instead of globbing blindly.

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

تشغيل في Manus

المصدر

KoichiYatsuzuka

KoichiYatsuzuka/new_language

فتح مستودع GitHub عرض مستودعات المنشئ

تنزيل

تشغيل في Manus

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

مطوّرو البرمجياتمهن الحاسوب والرياضيات·SOC 15-1252

SKILL.md

readonly

name	codebase-map
description	Use when you need to know where a file, module, or subsystem lives in the Arrow repository (Rust src/, Python impl_python/, examples/, vscode-extension/), or what a given file is responsible for. Read this before navigating an unfamiliar part of the tree instead of globbing blindly.

Directory Structure

Arrow/
├── src/
│   ├── main.rs              # Entry point / argument parsing / error formatting
│   ├── token.rs             # Token enum / Span / Spanned definitions
│   ├── ast.rs                # AST node definitions (with embedded Span)
│   ├── python_converter.rs  # Python source converter utilities
│   ├── repl.rs               # Interactive REPL implementation
│   ├── frontend_tests.rs    # Lexer/parser/type-checker tests
│   ├── lexer/               # Lexer module
│   │   ├── mod.rs           # Lexer entry point (returns Vec<Spanned>)
│   │   ├── chars.rs         # Character utilities
│   │   ├── keyword.rs       # Keyword recognition
│   │   ├── literal.rs       # Numeric / string literal scanning
│   │   ├── math.rs          # Operator scanning
│   │   ├── scan.rs          # Main scan loop
│   │   └── symbol.rs        # Symbol / punctuation scanning
│   ├── parser/              # Parser module
│   │   ├── mod.rs           # Parser entry point (input: Vec<Spanned>)
│   │   ├── stmts.rs         # Statement parsing
│   │   ├── exprs.rs         # Expression parsing
│   │   ├── classes.rs       # Class / trait parsing
│   │   ├── types.rs         # Type annotation parsing
│   │   └── imports.rs       # Import statement parsing
│   ├── type_check/          # Static type checker module
│   │   ├── mod.rs           # Type checker entry point
│   │   ├── stmt.rs          # Statement type checking
│   │   ├── infer.rs         # Type inference
│   │   ├── types.rs         # Type representations
│   │   ├── errors.rs        # StaticTypeError definitions
│   │   ├── scope.rs         # Scope / environment
│   │   ├── type_utils.rs    # Type utility functions
│   │   ├── call_check.rs    # Function call type checking
│   │   ├── binop.rs         # Binary operator type checking
│   │   └── decorator.rs     # Decorator type checking
│   ├── interpreter.rs       # Interpreter entry point (re-exports interpreter/ module)
│   ├── interpreter/         # Interpreter module
│   │   ├── eval.rs          # Expression evaluation
│   │   ├── exec.rs          # Statement execution
│   │   ├── functions.rs     # Function / closure / generator execution
│   │   ├── classes.rs       # Class / trait execution
│   │   ├── templates.rs     # Template instantiation
│   │   ├── ops.rs           # Operator implementations
│   │   ├── str_methods.rs   # String method dispatch
│   │   ├── scope.rs         # Lexical scope / environment
│   │   ├── exceptions.rs    # Exception handling (try/except/finally/raise)
│   │   ├── async_mgr.rs     # AsyncManager and task submission
│   │   ├── native_api.rs    # Handle arena, TlCallbacks struct, C callback impls
│   │   ├── py_interop.rs    # Python interop (import[py] / import[py-int])
│   │   ├── debugger.rs      # break_point debugger support
│   │   ├── msvc_errors.rs   # MSVC-style error formatting
│   │   └── tests.rs         # Interpreter integration tests
│   ├── partial_compiler/    # --compile subsystem
│   │   ├── mod.rs           # Entry point: orchestrates compile pipeline
│   │   ├── codegen.rs       # Rust source code generator (fn → handle-based i64 ABI)
│   │   ├── module_compiler.rs # Writes .arc (v0/v1) and .ars; v1 embeds DLL inside .arc
│   │   ├── rs_loader.rs     # Loads and links compiled Rust shared libraries
│   │   └── stub_gen.rs      # .ars stub file generator
│   └── built_in_stab/       # Built-in type stubs (used by VS Code extension)
│       ├── built_in_const.ars
│       ├── built_in_type.ars
│       ├── basic_traits.ars
│       └── error.ars
├── spec.md                  # Language specification
├── examples/
│   ├── ....ar                 # Example files
│   ├── ..._error.ar           # Error examples
│   ├── test_modules/          # modules used by importation.ar
│   ├── geometry/              # example package
│   └── archived/              # older examples (kept for reference)
├── impl_python/               # Python implementation of the interpreter
│   ├── __main__.py            # CLI entry point: python -m impl_python <file.ar>
│   ├── __init__.py
│   ├── token.py               # Token / Span / Spanned definitions
│   ├── ast.py                 # AST node dataclasses
│   ├── repl.py                # Interactive REPL
│   ├── lexer/                 # Lexer module (mirrors src/lexer/)
│   ├── parser/                # Parser module (mirrors src/parser/)
│   ├── type_check/            # Static type checker module (mirrors src/type_check/)
│   ├── interpreter/           # Tree-walk interpreter package
│   │   ├── __init__.py        # run(stmts) entry point
│   │   ├── interpreter.py     # Interpreter class (exec / eval)
│   │   ├── value.py           # Runtime value types (TlList, TlClass, TlInstance, …)
│   │   ├── env.py             # Lexical scope / Environment
│   │   ├── exceptions.py      # Control-flow signals (ReturnSignal, RaiseSignal, …)
│   │   ├── native_api.py      # Native API bindings
│   │   └── builtins.py        # Built-in functions and collection method dispatch
│   └── partial_compiler/      # Partial compiler (mirrors src/partial_compiler/)
│       ├── codegen.py
│       ├── module_compiler.py
│       └── stub_gen.py
└── vscode-extension/          # VS Code extension (type inference inline hints)
    └── src/
        ├── extension.ts
        └── type_infer.ts

المزيد من هذا المستودع

نفس المستودع

c-abi-interop

KoichiYatsuzuka/new_language

Use when working on C/C++ ABI interop — passing values/structs to/from external C/C++ DLLs (import[cpp-dll]/import[cpp-lib]), C ABI type annotations (int8/int32/float32/...), InstanceData raw-block layout, zero-copy vs. shadow-conversion struct passing, or write-back for mutable pointer arguments. This is a design spec + implementation-phase log (P0–P7, all marked done) referenced from many src/ comments.

2026-07-122

vscode-debug-runner

KoichiYatsuzuka/new_language

Use when debugging or testing the VS Code extension's type-inference/analysis code (inlay hints, hover, diagnostics) via the standalone debug runner (node run_debug.js), without launching VS Code itself. Also use after changing analysis.ts, type_infer.ts, or native_module.ts to know which npm script to recompile. For adding/modifying an extension feature itself or packaging the VSIX, use the vscode-extension-dev skill instead.

2026-07-112

vscode-extension-dev

KoichiYatsuzuka/new_language

Use when adding or modifying a feature of the Arrow VS Code extension itself (vscode-extension/) — syntax highlighting, hover, inlay hints, completions, go-to-definition, diagnostics, commands/keybindings, settings, or the built-in function stub. Covers the source-file map, build commands, and the mandatory VSIX packaging step. For just exercising existing analysis code against a .ar file, use the vscode-debug-runner skill instead.

2026-07-112

architecture-overview

KoichiYatsuzuka/new_language

Use before modifying the lexer, parser, static type checker, interpreter, or VS Code extension — gives a compact map of what each subsystem already supports (keywords, control flow, type-guard narrowing, value types, closures, exceptions, async, native modules) and which dedicated skill to open for the full implementation reference.

2026-07-092

importation

KoichiYatsuzuka/new_language

Use when writing, reading, or extending Arrow (.ar) import statements — `import[lang] module.path as alias` / `from module import[lang] Name` — including .py, .dll/.lib (C), .rs, C#, or Node.js interop. Explains what each `[lang]` tag loads and how src/parser/imports.rs and src/interpreter/exec.rs implement it, down to key line numbers.

2026-07-092

interpreter-internals

KoichiYatsuzuka/new_language

Use when modifying src/interpreter/ — the tree-walk interpreter (statement exec, expression eval, function/closure calls, class instantiation, operators, exceptions, async task threads, or the native ABI handle arena). Gives the module map, Interpreter/Value struct layout, exec/eval dispatch tables, closure capture rules, and the native ABI handle table.

2026-07-092

Directory Structure

Arrow/ ├── src/ │ ├── main.rs # Entry point / argument parsing / error formatting │ ├── token.rs # Token enum / Span / Spanned definitions │ ├── ast.rs # AST node definitions (with embedded Span) │ ├── python_converter.rs # Python source converter utilities │ ├── repl.rs # Interactive REPL implementation │ ├── frontend_tests.rs # Lexer/parser/type-checker tests │ ├── lexer/ # Lexer module │ │ ├── mod.rs # Lexer entry point (returns Vec<Spanned>) │ │ ├── chars.rs # Character utilities │ │ ├── keyword.rs # Keyword recognition │ │ ├── literal.rs # Numeric / string literal scanning │ │ ├── math.rs # Operator scanning │ │ ├── scan.rs # Main scan loop │ │ └── symbol.rs # Symbol / punctuation scanning │ ├── parser/ # Parser module │ │ ├── mod.rs # Parser entry point (input: Vec<Spanned>) │ │ ├── stmts.rs # Statement parsing │ │ ├── exprs.rs # Expression parsing │ │ ├── classes.rs # Class / trait parsing │ │ ├── types.rs # Type annotation parsing │ │ └── imports.rs # Import statement parsing │ ├── type_check/ # Static type checker module │ │ ├── mod.rs # Type checker entry point │ │ ├── stmt.rs # Statement type checking │ │ ├── infer.rs # Type inference │ │ ├── types.rs # Type representations │ │ ├── errors.rs # StaticTypeError definitions │ │ ├── scope.rs # Scope / environment │ │ ├── type_utils.rs # Type utility functions │ │ ├── call_check.rs # Function call type checking │ │ ├── binop.rs # Binary operator type checking │ │ └── decorator.rs # Decorator type checking │ ├── interpreter.rs # Interpreter entry point (re-exports interpreter/ module) │ ├── interpreter/ # Interpreter module │ │ ├── eval.rs # Expression evaluation │ │ ├── exec.rs # Statement execution │ │ ├── functions.rs # Function / closure / generator execution │ │ ├── classes.rs # Class / trait execution │ │ ├── templates.rs # Template instantiation │ │ ├── ops.rs # Operator implementations │ │ ├── str_methods.rs # String method dispatch │ │ ├── scope.rs # Lexical scope / environment │ │ ├── exceptions.rs # Exception handling (try/except/finally/raise) │ │ ├── async_mgr.rs # AsyncManager and task submission │ │ ├── native_api.rs # Handle arena, TlCallbacks struct, C callback impls │ │ ├── py_interop.rs # Python interop (import[py] / import[py-int]) │ │ ├── debugger.rs # break_point debugger support │ │ ├── msvc_errors.rs # MSVC-style error formatting │ │ └── tests.rs # Interpreter integration tests │ ├── partial_compiler/ # --compile subsystem │ │ ├── mod.rs # Entry point: orchestrates compile pipeline │ │ ├── codegen.rs # Rust source code generator (fn → handle-based i64 ABI) │ │ ├── module_compiler.rs # Writes .arc (v0/v1) and .ars; v1 embeds DLL inside .arc │ │ ├── rs_loader.rs # Loads and links compiled Rust shared libraries │ │ └── stub_gen.rs # .ars stub file generator │ └── built_in_stab/ # Built-in type stubs (used by VS Code extension) │ ├── built_in_const.ars │ ├── built_in_type.ars │ ├── basic_traits.ars │ └── error.ars ├── spec.md # Language specification ├── examples/ │ ├── ....ar # Example files │ ├── ..._error.ar # Error examples │ ├── test_modules/ # modules used by importation.ar │ ├── geometry/ # example package │ └── archived/ # older examples (kept for reference) ├── impl_python/ # Python implementation of the interpreter │ ├── __main__.py # CLI entry point: python -m impl_python <file.ar> │ ├── __init__.py │ ├── token.py # Token / Span / Spanned definitions │ ├── ast.py # AST node dataclasses │ ├── repl.py # Interactive REPL │ ├── lexer/ # Lexer module (mirrors src/lexer/) │ ├── parser/ # Parser module (mirrors src/parser/) │ ├── type_check/ # Static type checker module (mirrors src/type_check/) │ ├── interpreter/ # Tree-walk interpreter package │ │ ├── __init__.py # run(stmts) entry point │ │ ├── interpreter.py # Interpreter class (exec / eval) │ │ ├── value.py # Runtime value types (TlList, TlClass, TlInstance, …) │ │ ├── env.py # Lexical scope / Environment │ │ ├── exceptions.py # Control-flow signals (ReturnSignal, RaiseSignal, …) │ │ ├── native_api.py # Native API bindings │ │ └── builtins.py # Built-in functions and collection method dispatch │ └── partial_compiler/ # Partial compiler (mirrors src/partial_compiler/) │ ├── codegen.py │ ├── module_compiler.py │ └── stub_gen.py └── vscode-extension/ # VS Code extension (type inference inline hints) └── src/ ├── extension.ts └── type_infer.ts