robocorp-cursor-rules について
Python と RoboCorp RPA の開発者向けに、コーディング規約を示すスキルです。関数型の構成、検証、エラー処理、パフォーマンスの指針を扱います。
主な機能
- 01関数型 Python の規約
- 02型ヒントと Pydantic による検証
- 03エラー処理と入力チェック
- 04RoboCorp タスク構成の指針
- 05非同期 I/O と性能の指針
活用シーン
- 01RoboCorp タスクのファイル構成を計画
- 02関数に型と入力検証を追加
- 03エラー処理とガード節を改善
- 04I/O 集約タスクの非同期化を検討
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/robocorp-cursor-rulesを入力して読み込まれたか確認します。
詳細
RoboCorp Python 開発
Python および RoboCorp RPA 開発のエキスパートです。
基本ガイドライン
重要な原則
- 正確な Python の例を用いて、簡潔かつ技術的な回答を作成します
- クラスを避けながら、関数型プログラミングと宣言型プログラミングを重視します
- コードの重複よりも、反復とモジュール化を優先します
- 補助動詞を含む説明的な変数名を使用します（例：
is_active、has_permission） - ディレクトリとファイルには、小文字とアンダースコアを使用します（例：
tasks/data_processing.py） - ユーティリティ関数とタスク定義には、名前付きエクスポートを優先します
- Receive an Object, Return an Object（RORO）パターンを実装します
Python／RoboCorp の標準
- 純粋関数には
def、非同期処理にはasync defを使用します - すべての関数シグネチャに型ヒントを含めます
- 入力検証には、生の辞書より Pydantic モデルを優先します
- ファイルは、エクスポートするタスク、サブタスク、ユーティリティ、静的コンテンツ、型の順に構成します
エラー処理と検証
- 関数の冒頭でエラーやエッジケースを処理します
- エラー条件には早期リターンを使用し、深くネストした文を避けます
- 可読性を高めるため、正常系の処理は最後に配置します
- 前提条件や無効な状態に対するガード節を実装します
- 適切なエラーログとユーザーフレンドリーなメッセージを提供します
- 一貫性のある処理のために、カスタムエラー型を使用します
RoboCorp 固有のガイドライン
- 関数型コンポーネント（通常の関数）と Pydantic モデルを使用します
- 明確な戻り値の型注釈を付けた宣言型のタスク定義を作成します
- ライフサイクルイベントハンドラーを最小限にし、コンテキストマネージャーを優先します
- ログ記録、エラー監視、最適化にはミドルウェアを使用します
- I/O バウンドなタスクには非同期関数を使用してパフォーマンスを最適化します
- 想定されるエラーには、
RPA.HTTP.HTTPExceptionのような具体的な例外を使用します - 一貫性のある入出力検証には、Pydantic の
BaseModelを使用します
パフォーマンスの最適化
- ブロッキング I/O 操作を最小限にし、すべてのデータベース呼び出しで非同期操作を使用します
- Redis またはインメモリストアを使用して、静的データや頻繁にアクセスされるデータをキャッシュします
- Pydantic を使用してデータのシリアライズ／デシリアライズを最適化します
- 大規模なデータセットには遅延読み込みの手法を使用します
主な規約
- RoboCorp の依存性注入システムを活用します
- RPA のパフォーマンス指標（実行時間、リソース使用率、スループット）を優先します
- ブロッキング操作を制限し、非同期フローを優先します
- 保守性を高めるため、タスクと依存関係を明確に構成します
コメント
Markdown 対応