用途:在审查 Contentstack Management Python SDK 的 PR、提交前自审或使用自动化审查提示时,按清单逐项检查。
主要能力: 公开 API:确认导出的 Client、Region、stack 与资源辅助函数与 README 及 contentstack_management.all / init.py 一致;当行为或参数变化时,检查 Client 与变更的公开方法是否有 docstring。 兼容性:避免在没有 semver 策略的情况下破坏 Client 构造函数或 stack 方法链;破坏性变更需记录迁移方式。 HTTP / 认证:对 _APIClient 或 OAuth 路径的改动,用单元测试验证重试、请求头与拦截器行为;确保 authtoken / management_token 请求头无回归。 测试:为新逻辑补充单元测试;当实时 CMA 请求/响应行为变化时更新 API 测试;适合契约式测试时使用 mock;确保 pytest tests/unit/ 通过。 安全:不得硬编码 token;新代码不得记录密钥。
使用方式:按上述清单逐项审查,可选地为发现项标注 Blocker、Major、Minor。严重级别示例:Blocker 包括未经批准破坏公开 API、安全问题、在可测试处未为新逻辑添加测试;Major 包括 HTTP/认证行为不一致、README 示例与代码不符;Minor 包括风格与文档小问题。
适用场景:SDK 的 PR 审查、提交前自审、自动化审查提示。
限制:资料未提供具体安装命令、运行环境要求、价格或平台信息,暂未提供。