mcpField
D
devtu-code-optimization

devtu-code-optimization

github.com/mims-harvard開発1.8k268 回インストール2 日前に更新
リポジトリ

devtu-code-optimization について

ToolUniverse の開発と保守に向けたコード最適化スキルです。コミット前チェックリスト、問題パターンの分類、API 修正とコードのリファレンスをまとめています。

主な機能

  1. 01コミット前チェックリスト
  2. 02兆候別に整理した問題例
  3. 03API 修正リファレンス
  4. 04再利用可能なコードパターン
  5. 05Git と PR の手順

活用シーン

  1. 01ToolUniverse の変更をコミット前に確認
  2. 02ツール出力やスキーマの問題を調査
  3. 03API 呼び出しや例外処理の不具合を修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mims-harvard/tooluniverse --skill devtu-code-optimization

インストール後、Claude Code で/devtu-code-optimizationを入力して読み込まれたか確認します。

同梱ファイルreferences/api-fixes.mdreferences/code-patterns.md

詳細

ToolUniverse コード最適化

コードの作成または変更後は、必ず Skill(skill="simplify") を実行してください。

コミット前のチェックリスト

  • return_schema に oneOf: [{data+metadata}, {error}] がある
  • テスト例では実在する ID を使用している（DUMMY/PLACEHOLDER は使用しない）
  • try: と except: のインデントレベルが完全に一致している
  • JSON に末尾のカンマがない（python3 -c "import json; json.load(open('f.json'))"）
  • 新しいツールクラスが _lazy_registry_static.py と default_config.py に登録されている
  • ruff check src/tooluniverse/<file>.py が成功する
  • python -c "from tooluniverse.<module> import <Class>" が成功する
  • python -m tooluniverse.cli run <Tool> '<real_args_json>' が期待されるデータを返す
  • 変更したすべてのファイルに対して Skill(skill="simplify") を実行した

主な修正カテゴリ

カテゴリ状況参照先
パラメーターが無視されるAPI は受け付けるが、フィルターが適用されないcode-patterns.md — クライアント側フィルター
API フィールド／エンドポイントの誤り結果が 0 件、または 404api-fixes.md — クイック参照表
スキーマが無効null 型、oneOf の欠落code-patterns.md — スキーマパターン
正規化の非開示自動変換がユーザーに示されないcode-patterns.md — 正規化の開示
try/except のインデント実行時に SyntaxError が発生code-patterns.md — try/except セクション
切り詰め情報が埋もれているデータ件数が注記に隠れているcode-patterns.md — 切り詰め
ホスト型モデル API（NIM）ポーリング時に非同期 404、JSON でラップされた出力、200 だが内部で失敗、「not found for account」code-patterns.md — ホスト型モデル API ツール
R サブプロセスツールRscript -e で '\.' unrecognized escape が発生code-patterns.md — R サブプロセスツール

参考資料

  • references/api-fixes.md — API ごとのバグ修正（GtoPdb、CIViC、GTEx、ENCODE、CPIC など）
  • references/code-patterns.md — 再利用可能な Python パターン（スキーマ、フィルタリング、ページネーション、正規化）

Git と PR のワークフロー

git fetch origin && git stash && git rebase origin/main && git stash pop
git push --force-with-lease origin fix/round-XX-bugs
gh pr view <N> --json mergeable  # must be MERGEABLE before done
  • main に直接プッシュしないでください
  • 修正用の PR を複数同時にオープンしないでください
  • コミットメッセージには「Feature」または「Fix」を使用し、「Bug」は使用しないでください
  • コミットに AI の帰属情報を含めないでください
  • リポジトリ：mims-harvard/ToolUniverse — git remote -v で確認してください

コメント

Markdown 対応