review-and-qa

review-and-qa 技能是一款自动化的工程助理，旨在维护 Storyblok 单体仓库 (monorepo) 及其相关 SDK 的高标准。它为任何提交、分支或合并请求 (PR) 提供结构化的两阶段评估流程。第一阶段侧重于静态代码分析，确保变更在架构上合理、安全且符合项目既定的规范。通过强制执行标准化的 PR 检查清单，此技能能帮助开发人员在开发周期的早期识别出常见陷阱，例如密钥泄漏、缺乏文档或次优的设计模式。

第二阶段转向质量保证 (QA) 规划。它会针对具体变更生成详细的手动测试案例，涵盖正常路径、负面场景、边缘情况和错误恢复程序。这种系统化的方法确保了功能在不同环境中（包括 Storyblok 的 JavaScript, React, Vue 和 Astro SDK）都能得到验证。

• 自动化代码审查：分析代码结构、命名惯例以及对 DRY 原则的遵守情况。

• 安全合规性：检查潜在的注入漏洞以及是否不小心包含敏感凭证或代码。

• PR 检查清单强制执行：验证每个合并请求是否包含必要的测试、文档更新以及针对破坏性变更的适当迁移说明。

• QA 测试计划生成：根据模板生成可执行的测试套件，确保正常操作与复杂边缘情况的全面覆盖。

• 架构验证：确保新代码与现有的 Storyblok 模块、工具辅助函数及集中式常数无缝整合。

• 依赖管理：评估新第三方依赖的授权兼容性、维护状态及套件大小影响。

• 用户应通过提供目标提交哈希值 (commit hash)、分支名称或 PR 参考作为主要参数来触发此技能。

• 输出结果采用 Markdown 格式，将问题按严重程度（严重、主要、次要）分类，并直接参考文件路径与具体代码行号。

• 此技能假设项目遵循 Storyblok 生态系统中的标准仓库模式（例如 packages/cli, packages/js-client）。

• 开发人员应利用生成的测试计划作为手动回归测试与跨浏览器验证的起点。

• 限制条件包括仓库必须具备网络访问权限，且需遵守 Conventional Commits 标准以进行版本说明。