SuperAPI AI 工具集

cy-spec-peer-review

智能体与模型

查看项目

更新于 10-15 20:27

技能介绍

用途:对 Codex 以 gpt-5.4 编写的 AGH TechSpec 做 Claude Opus 压力测试,仅在用户批准当前草稿并明确要求评审轮次后执行,不会自动运行、自动采纳发现或自动循环多轮。

主要能力:校验输入与上下文,确认规格为最终形态并含 Architectural Boundaries、Implementation Steps、Test Strategy;读取 references/quality-markers.md 校验六项质量标记,缺失则中止并报告;组装评审提示;调用 compozy exec --ide claude --model opus --reasoning-effort xhigh --format json --prompt-file … 执行跨 LLM 评审;解析输出的 blockers、nits、readiness;生成摘要并呈现裁决与主要主题;按用户选择采纳发现(全部 blocker、选定项、不采纳或先手动编辑);可选进行下一轮评审。

使用方式:可提供 techspec-path,省略时解析 .compozy/tasks/<slug>/_techspec.md 中最新的候选;qa/ 目录若不存在则创建;轮次编号由已有 peer-review-result-round*.json 决定,从 round1 开始;所有提示、结果、摘要与采纳文件带 -roundN 版本且从不覆盖。

限制:若运行时无专用交互提问工具,必须以完整助手消息提问并停止,不得替用户作答;模型配置错误时停止并暴露所配置模型,不得擅自替换模型;compozy exec 不在 PATH 时失败并给出安装提示;空输出视为可疑并先再次询问用户;质量标记缺失时不运行 Opus。该技能不会自动修改 TechSpec 或 ADR,仅按用户选定范围改。

适用场景:用户批准草稿后需要跨 LLM 额外压力测试、但又希望保留人工决策权的工作流。