SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场scope

scope

编程与开发

查看项目

更新于 10-16 05:38

技能介绍

用途

Scope 用于在开始任何新功能或产品之前，把模糊的想法整理成 AI 工具能够执行、干系人能够评估的规格文档。它适用于以下场景：启动新功能或产品、在雇佣开发者或估算成本之前、当 AI 反复构建错误内容（规格不清晰）时，以及当干系人需要评审范围和预算时。

主要能力

Scope 提供两种规格编写方式：

  • 快速功能规格（10-15 分钟）：适用于单个功能、迭代或新增内容，可直接交给 AI 工具（如 Claude Code、Lovable、Replit）构建。参考 QUICK-SPEC.md。
  • 全项目范围（1-2 小时）：适用于新产品、重大版本或干系人评审，可交给承包商、团队成员或用于预算规划。参考 PROJECT-SCOPE.md。

使用方式

快速功能规格工作流

按清单完成以下部分：

  1. 写用户将做什么（2-3 句话）
  2. 展示它看起来什么样（参考、截图或描述）
  3. 定义正常流程（3-5 步）
  4. 列出边界情况（2-4 个场景）
  5. 明确范围外内容
  6. 保存到 docs/specs/YYYY-MM-DD-feature-name.md

第 1 部分：用户将做什么

用 2-3 句话描述用户行为和结果。模板：

Users can [ACTION] to [OUTCOME]. When they [DO THIS], they see [WHAT HAPPENS]. If [EDGE CASE], then [WHAT HAPPENS].

示例：

Users sign up with email/password, receive confirmation email, and log in to see their dashboard. They can reset forgotten passwords via email link.

第 2 部分：它看起来什么样

选择一种方式：

  • 参考应用：“Login like Linear - minimal, centered, email/password/button”
  • 截图/草图：快速原型或手机照片
  • 描述：“Card 400px wide, 'Welcome' header Inter 24px, two inputs, blue button”

第 3 部分：正常流程

列出用户完成任务所采取的 3-5 个步骤。

第 4 部分：边界情况

列出 2-4 个事情未按计划发展的场景以及会发生什么。格式：

  • [Scenario]: [Response shown to user]

第 5 部分：范围外

定义不构建的内容，以防止范围蔓延。

完整模板和示例见 QUICK-SPEC.md。

全项目范围工作流

按清单进行全面的项目规划：

  1. 写引言（背景、范围内、范围外）
  2. 定义用户角色
  3. 列出所有页面/屏幕
  4. 描述核心功能
  5. 识别集成
  6. 创建里程碑和小时估算
  7. 记录假设和未决问题
  8. 保存到 docs/specs/YYYY-MM-DD-project-name.md

7 个必需部分

  1. 引言 - 背景、范围内、范围外
  2. 用户角色 - 每个角色的职责
  3. 页面与屏幕 - 每个页面及其一句话用途
  4. 核心功能 - 以结果为导向的能力
  5. 集成 - 外部服务及复杂度/风险说明
  6. 里程碑与任务 - 各阶段及小时估算
  7. 未决问题 - 假设和未解决的决策

完整模板和示例见 PROJECT-SCOPE.md。

与 AI 工具配合使用

  • Claude Code / Cursor：Build this feature: [paste Quick Feature Spec]
  • Lovable / Replit / Bolt：将快速功能规格作为初始提示粘贴；将复杂功能拆分为更小的块；迭代：“Close, but error message should say X not Y”
  • 雇佣承包商：发送全项目范围；询问：“What's unclear? What would you change?”；获取小时估算并与自己的估算比较

适用场景

  • 启动新功能或产品
  • 在雇佣开发者或估算成本之前
  • 当 AI 反复构建错误内容时
  • 当干系人需要评审范围和预算时
  • 需要为承包商或团队成员提供清晰规格时

限制与常见错误

常见错误及修正：

  • “Build a dashboard” → 描述仪表盘上有什么以及每项功能做什么
  • 描述如何编码 → 描述它应该做什么
  • 忘记移动端 → 在每个规格中添加“Works on mobile”
  • 跳过边界情况 → 定义出错时会发生什么
  • 没有范围外内容 → 防止范围蔓延

当卡住时：

  • “I don't know what I want yet” → 使用竞争对手产品 20 分钟；截图 3 个你喜欢的东西；写：“I want these 3 things, but simpler”
  • “AI keeps building the wrong thing” → 你的规格太模糊；使用 QUICK-SPEC.md 或 PROJECT-SCOPE.md 中的模板；填写每个部分

完成后保存为：docs/specs/YYYY-MM-DD-feature-name.md。快速功能规格直接交给 AI 工具；全项目范围先与干系人/承包商评审。

成功标志：AI 第一次就构建正确（或非常接近）；承包商给出实际估算且无意外；边界情况在生产中不会让你意外；干系人确切知道他们将得到什么。