技能 generating-sorbet-inline

💎

generating-sorbet-inline

Name: generating-sorbet-inline
Author: DmitryPogrebnoy

安全 ⚙️ 外部命令🌐 網路存取📁 檔案系統存取

Add Sorbet type signatures to Ruby methods

Ruby projects need type safety for reliable code. This skill adds Sorbet inline type signatures to methods using sig blocks. It analyzes Ruby source files, generates proper type annotations, and validates signatures with the Sorbet type checker.

支援: Claude Codex Code(CC)

📊 69 充足

下載技能 ZIP

在 Claude 中上傳

前往設定 → 功能 → 技能 → 上傳技能

開啟並開始使用

測試它

正在使用「generating-sorbet-inline」。 Add Sorbet types to this User class

預期結果:

Added # typed: true sigil
Added extend T::Sig to User class
Generated sig for initialize(name: String, age: Integer).void
Generated sig for greet(greeting: String).returns(String)
Generated sig for attr_reader :name returns(String)
Generated sig for attr_reader :age returns(Integer)

正在使用「generating-sorbet-inline」。 Type this service object with params and returns

預期結果:

Analyzed PaymentService class
Generated sig for process(amount: T.any(Integer, Float), currency: String).returns(T::Boolean)
Generated sig for validate_customer(customer_id: Integer).void
Ran 'bundle exec srb tc' - all signatures valid

正在使用「generating-sorbet-inline」。 Add types to this module with class methods

預期結果:

Found module with class methods
Added extend T::Sig to module
Generated sig for self.from_json(json: String).returns(T.untyped)
Generated sig for self.parse(data: T::Hash[String, T.untyped]).returns(self)

安全審計

安全

v5 • 1/17/2026

This is a documentation-only skill providing instructions for generating Sorbet inline type signatures. All static findings are in the reference/ directory which contains example code from the Packwerk gem (Shopify) for learning purposes. The 'weak cryptographic algorithm' findings are for MD5 digests used in cache invalidation (non-security use). Shell backtick execution is for running 'srb tc' validation command (legitimate tooling). No credential access or exfiltration patterns exist. The skill explicitly prohibits running project Ruby code.

已掃描檔案

5,273

分析行數

發現項

審計總數

風險因素

⚙️ 外部命令 (168)

🌐 網路存取 (30)

📁 檔案系統存取 (6)

reference/sorbet_examples/packwerk/packwerk/disable_sorbet.rb:36 reference/sorbet_examples/packwerk/packwerk/files_for_processing.rb:82 reference/sorbet_examples/packwerk/packwerk/package_set.rb:70 reference/sorbet_examples/packwerk/packwerk/package_todo.rb:89 reference/sorbet_examples/packwerk/packwerk/rails_load_paths.rb:42 reference/sorbet_examples/packwerk/packwerk/rails_load_paths.rb:43

審計者: claude 查看審計歷史 →

品質評分

架構

100

可維護性

內容

社群

100

安全

規範符合性

你能建構什麼

Add types to existing Ruby codebase

Gradually add type safety to Ruby methods in legacy applications

Type Rails models and services

Add type signatures to Rails models, services, and PORO classes

Document public APIs with types

Generate type signatures for gem public interfaces

試試這些提示

Add signatures to single class

Add Sorbet inline type signatures to all methods in this Ruby class file

Type entire file

Analyze this Ruby file and add sig blocks to all methods, attributes, and class methods

Handle generics

Add Sorbet signatures to this Ruby class with type parameters and generics

Validate with Sorbet

Add Sorbet inline signatures to this file and run 'srb tc' to validate them

最佳實務

Start with # typed: true and gradually increase strictness
Use specific types like String, Integer instead of T.untyped
Run 'srb tc' after adding signatures to catch errors early
Ask for clarification when type information is ambiguous

避免

Using T.untyped as a shortcut defeats the purpose of typing
Changing typed sigil levels without understanding impact
Adding signatures without running validation
Running project Ruby code during signature generation

常見問題

What is Sorbet?

Sorbet is a static type checker for Ruby developed by Stripe. It validates type annotations at compile time.

What is the difference between inline types and RBI files?

Inline types use sig blocks directly in Ruby files. RBI files are separate type stub files for external gems.

Does this skill run my Ruby code?

No. The skill explicitly prohibits running project Ruby code. It only analyzes source structure.

What does sig { returns(String) } mean?

It declares that the method returns a String value. The sig block defines types for a method.

How do I handle unknown types?

Ask the user for clarification. Use T.any for union types and T.nilable for optional values.

What typed sigil should I use?

Start with typed: true for gradual adoption. Increase to strict or strong as your codebase matures.

開發者詳情

作者

DmitryPogrebnoy

授權

MIT

儲存庫

https://github.com/DmitryPogrebnoy/ruby-agent-skills/tree/main/plugins/ruby-type-signature-skills/skills/generating-sorbet-inline

引用

main

檔案結構

📁 reference/

📁 sorbet_examples/

📁 packwerk/

📄 packwerk.rb

📄 STRUCTURE.md

📄 syntax.md

📄 SKILL.md