SuperAPI AI 工具集

speckit-critique-run

编程与开发

查看项目

更新于 10-16 03:11

技能介绍

用途:在进入实现阶段之前,从产品战略与工程风险两个视角,对规格说明与实施计划进行评审,避免实施中途返工并提前发现战略与技术盲点。产品视角关注是否解决了正确的用户问题与价值;工程视角关注技术方案是否可靠、可扩展及是否存在隐藏风险。

主要能力:加载 spec.md(需求、用户故事、验收标准)与 plan.md(架构、技术栈、实施阶段)等上下文,必要时读取 constitution.md、tasks.md 与既有评审报告;从产品视角评估问题验证、用户价值、替代方案、边界与用户体验、成功度量;从工程视角评估架构合理性、失效模式、安全与隐私、性能与可扩展性、测试策略、运维就绪度、依赖与集成风险;并进行双视角综合,识别两类视角共同关注的高优先项。

使用方式:需先从仓库根目录运行 .specify/scripts/bash/check-prerequisites.sh --json --include-tasks,解析出 FEATURE_DIR 与 AVAILABLE_DOCS,所有路径须为绝对路径。命令严格只读,不直接修改既有项目文件,仅可在 FEATURE_DIR/critiques/critique-{timestamp}.md 按 .specify/templates/critique-template.md 创建评审报告,报告包含执行摘要、产品视角发现、工程视角发现、跨视角洞察与发现汇总表(字段为 ID、Lens、Severity、Category、Finding、Suggestion)。对 spec.md 与 plan.md 的修改仅提出建议,需用户明确批准后才应用。

严重级别:🎯 Must-Address 阻塞进入实现(关键产品缺口、安全漏洞、架构缺陷或违反 constitution);💡 Recommendation 建议改进;🤔 Question 需相关方确认。结论为 ✅ PROCEED、⚠️ PROCEED WITH UPDATES 或 🛑 RETHINK,并给出后续命令建议。

限制:仅覆盖上述评审流程与报告生成;是否支持特定平台、具体收费与价格等信息暂未提供。扩展钩子读取 .specify/extensions.yml 的 hooks.before_critique 与 hooks.after_critique,YAML 无效则静默跳过;enabled 为 false 的钩子被过滤,含非空 condition 的钩子交由 HookExecutor 处理。