技能 generating-sorbet-inline

💎

generating-sorbet-inline

Name: generating-sorbet-inline
Author: DmitryPogrebnoy

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

إضافة توقيعات نوع Sorbet إلى طرق Ruby

تحتاج مشاريع Ruby إلى أمان الأنواع لرموز موثوقة. تضيف هذه المهارة توقيعات نوع Sorbet المضمنة إلى الطرق باستخدام كتل sig. تحلل ملفات مصدر Ruby، وتولد تعليقات توضيحية مناسبة للأنواع، وتتحقق من التوقيعات مع مدقق نوع Sorbet.

支援: Claude Codex Code(CC)

📊 69 充足

下載技能 ZIP

在 Claude 中上傳

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

開啟並開始使用

測試它

正在使用「generating-sorbet-inline」。 إضافة أنواع Sorbet إلى فئة User هذه

預期結果:

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」。 كتابة كائن الخدمة هذا مع المعاملات والإرجاع

預期結果:

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」。 إضافة أنواع إلى هذه الوحدة مع طرق الفئة

預期結果:

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

安全

規範符合性

你能建構什麼

إضافة أنواع إلى قاعدة كود Ruby الموجودة

إضافة أمان الأنواع تدريجياً إلى طرق Ruby في التطبيقات القديمة

كتابة نماذج Rails والخدمات

إضافة توقيعات نوع إلى نماذج Rails والخدمات وفئات PORO

توثيق واجهات API العامة مع الأنواع

توليد توقيعات نوع لواجهات العامة للمجوهرات

試試這些提示

إضافة توقيعات إلى فئة واحدة

إضافة توقيعات نوع Sorbet المضمنة إلى جميع الطرق في ملف فئة Ruby هذا

كتابة ملف بالكامل

تحليل ملف Ruby هذا وإضافة كتل sig إلى جميع الطرق والسمات وطرق الفئة

معالجة الأنواع العامة

إضافة توقيعات Sorbet إلى فئة Ruby هذه مع معاملات الأنواع والأنواع العامة

التحقق باستخدام Sorbet

إضافة توقيعات Sorbet المضمنة إلى هذا الملف وتشغيل 'srb tc' للتحقق منها

最佳實務

ابدأ بـ # typed: true وزيادة الصرامة تدريجياً
استخدام أنواع محددة مثل String وInteger بدلاً من T.untyped
تشغيل 'srb tc' بعد إضافة التوقيعات لاكتشاف الأخطاء مبكراً
طلب التوضيح عندما تكون معلومات النوع غامضة

避免

استخدام T.untyped كاختصار defeats الغرض من الكتابة
تغيير مستويات typed sigil بدون فهم التأثير
إضافة التوقيعات بدون تشغيل التحقق
تشغيل رمز Ruby الخاص بالمشروع أثناء توليد التوقيعات

常見問題

ما هو Sorbet؟

Sorbet هو مدقق نوع ثابت لـ Ruby طوره Stripe. يتحقق من تعليقات الأنواع في وقت التجميع.

ما الفرق بين الأنواع المضمنة وملفات RBI؟

تستخدم الأنواع المضمنة كتل sig مباشرة في ملفات Ruby. ملفات RBI هي ملفات نوع stub منفصلة للمجوهرات الخارجية.

هل تشغل هذه المهارة رمز Ruby الخاص بي؟

لا. تحظر المهارة صراحة تشغيل رمز Ruby الخاص بالمشروع. إنه يحلل فقط بنية المصدر.

ماذا يعني sig { returns(String) }؟

يعلن أن الطريقة ترجع قيمة String. تحدد كتلة sig الأنواع للطريقة.

كيف أتعامل مع الأنواع غير المعروفة؟

اطلب التوضيح من المستخدم. استخدم T.any لاتحاد الأنواع وT.nilable للقيم الاختيارية.

ما هو typed sigil الذي يجب أن أستخدمه؟

ابدأ بـ typed: true للتبني التدريجي. ارفع إلى strict أو strong عندما تنضج قاعدة الكود الخاصة بك.

開發者詳情

作者

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