code-review

作成者: contentstack

Management Python SDKのPRをレビューする際に使用 — パブリックAPI、_APIClient、OAuth、テスト、セキュリティ。

npx skills add https://github.com/contentstack/contentstack-management-python --skill code-review

Code review – Contentstack Management Python

When to use

  • Reviewing a PR, self-review before submit, or automated review prompts.

Instructions

Work through the checklist below. Optionally tag findings: Blocker, Major, Minor.

Public API

  • Exported Client, Region, stack and resource helpers match README and contentstack_management.__all__ / __init__.py.
  • Docstrings on Client and changed public methods when behavior or parameters change.

Compatibility

  • Avoid breaking Client constructor or stack method chains without a semver strategy; document migration for breaking changes.

HTTP / auth

  • Changes to _APIClient or OAuth paths: verify retries, headers, and interceptor behavior with unit tests; no regressions for authtoken / management_token headers.

Testing

  • Unit coverage for new logic; API updates when live CMA request/response behavior changes; mock when contract-style tests are appropriate.
  • pytest tests/unit/ passes.

Security

  • No hardcoded tokens; no logging secrets in new code.

Severity (optional)

LevelExamples
BlockerBreaking public API without approval; security issue; no tests for new logic where tests are practical
MajorInconsistent HTTP/auth behavior; README examples that do not match code
MinorStyle; minor docs

contentstackのその他のスキル

cms-assets
contentstack
開発者がContentstackでアセットを整理、配信、変換する方法についてアドバイスします。フォルダ構造、Image Delivery API変換、公開について取り上げます…
cms-branches-aliases
contentstack
Contentstackのブランチを使用した分離されたコンテンツ開発と、エイリアスを使用したダウンタイムゼロのコンテンツデプロイについて開発者にアドバイスします。ブランチ戦略、…
cms-data-modeling-best-practices
contentstack
開発者がContentstackでコンテンツをモデリングする際、最もシンプルで再利用可能な構造を用いるよう導きます。このスキルでは、コンテンツタイプ、参照、グローバル…をいつ使用すべきかを説明します。
cms-live-preview-visual-builder-support-assistant
contentstack
Contentstack Live PreviewおよびVisual Builderの実装を診断し、ガイドします。プレビューコンテキストを追跡し、壊れたコントラクトを特定して、推奨…
cms-releases
contentstack
Contentstack Releasesを使用した、調整されたアトミックなコンテンツデプロイについて開発者にアドバイスします。リリース作成、アイテム管理、段階的デプロイをカバーします…
cms-roles-permissions
contentstack
Contentstackにおけるロール、権限、チーム、トークンアクセスの設計について開発者に助言します。組み込みロール、カスタムロール、権限のマージ、…について説明します。
cms-taxonomy
contentstack
開発者に対し、構造化された階層的なコンテンツ分類と配信側フィルタリングのためのContentstack Taxonomyの使用についてアドバイスします。タクソノミーとタグの比較、…
cms-tokens-authentication
contentstack
フロントエンド、バックエンド、自動化、およびサードパーティアプリのユースケースに適したContentstack認証方法とトークンタイプの選択について、開発者にアドバイスします。…