用途
Scope Check 用于在团队承诺某个功能或项目之前,审查功能规格、工单、PRD 与提案,识别隐藏复杂度、范围蔓延风险、缺失需求、模糊语言、未言明假设与依赖。它关注那些会让“两周项目”变成“三个月噩梦”的因素。
主要能力
技能会按结构化流程执行:解析规格(要构建什么、为谁、时间线、估算、作者、阶段),并扫描代码库获取上下文,包括搜索功能关键词、现有模型/模式、API 端点、测试、相似历史功能、TODO/FIXME、技术债相关文件。
它会识别三类风险信号:关键红旗(如“简单/只是/快速/容易”、“类似某复杂产品”、“以及一切相关的东西”、“用户应该能够”但未指明用户等),并列出隐藏的“冰山”(如“添加搜索”实际需要全文引擎、索引、排序、过滤、分页、高亮、容错;“添加通知”需要通知服务、多渠道、偏好、模板、调度、退订、限流等)。警告红旗包括表述不明确(“通常流程”、“适当处理错误”、“响应式设计”、“良好性能”、“安全”、“好看的 UI”等),跨领域关注点未提及(认证、授权、日志、监控、限流、缓存、数据校验、错误处理、迁移、文档、测试策略、部署计划、回滚计划),以及依赖未被点明(设计未开始、其他团队 API 不存在、第三方服务评估、基础设施、数据迁移、合规审查、外部协调、新环境变量、CI/CD 变更)。
技能还会将规格拆成工作流并标注复杂度,应用工作量倍数(如规格清晰 ×1.0、模糊 ×1.5、单行工单 ×2.0 等),给出 1-5 分复杂度评分,并进行假设审计(列出已声明与未声明假设及其影响)。
使用方式
按照技能流程,需要先创建输出目录并保存结果:
mkdir -p project-decisions
文件保存为:
project-decisions/YYYY-MM-DD-scope-[kebab-case-topic].md
随后依次执行:解析规格、扫描代码库、识别红旗、复杂度分析、假设审计、缺失需求清单、范围削减建议、提交前问题清单。
适用场景
适用于产品、工程、设计或利益相关者提交的功能规格、工单、PRD 与提案审查;理想时机是团队正式承诺范围之前。特别适合应对“应该很简单”的请求、跨团队依赖多的功能、涉及数据库迁移、支付、SSO、多租户、离线、实时更新等高风险类别。
限制
技能明确要求将输出保存为 Markdown 文件,并强调目标是“在团队承诺之前”捕获风险。资料未提供该技能的具体安装命令、收费方式、支持的平台或模型版本,也未说明是否需要特定代码仓库结构或语言支持。实际效果依赖输入规格的完整性与代码库可访问性;对于完全没有规格的工单,技能只能基于有限信息推测,无法保证发现的全部风险。