vitepress-template

Appearance

[[[[Switch to English]]]]

常见工作流 ​

OpenSpec 足够灵活，可以适应不同的工作风格。以下是一些常见的模式。

快速功能 (Quick Feature) ​

对于您心里已经想好并只想快速实施的简单添加。

流程：

  1. /opsx:new add-login-button
  2. /opsx:ff (生成所有工件)
  3. 快速浏览生成的计划
  4. /opsx:apply (实施)
  5. /opsx:archive

何时使用：

  • 小的 UI 调整
  • 简单的 CRUD 操作
  • 具有既定模式的次要功能

示例对话：

text
User: /opsx:new add-logout-button
AI:   Created change.

User: /opsx:ff
AI:   Generating proposal... done.
      Generating specs... done.
      Generating design... done.
      Generating tasks... done.
      Plan ready.

User: Looks good. /opsx:apply
AI:   Implementing tasks...
      [Writes code]
      All tasks complete.

User: /opsx:archive

探索性变更 (Exploratory Change) ​

当您不确定如何构建某物并需要先弄清楚时。

流程：

  1. /opsx:explore "我们应该如何进行 API 缓存？"
  2. 讨论选项的来回对话
  3. /opsx:new add-api-caching
  4. /opsx:continue (创建提案)
  5. 手动编辑提案以完善所选方法
  6. /opsx:continue (创建设计)
  7. 审查设计以确保它符合代码库约束
  8. /opsx:apply

何时使用：

  • 新的架构组件
  • 复杂的重构
  • 具有多种潜在解决方案的功能

规格优先 (Spec-First) ​

当行为正确性至关重要时。

流程：

  1. /opsx:new update-pricing-logic
  2. /opsx:continue (创建提案)
  3. /opsx:continue (创建规格)
  4. 花费时间审查和编辑规格场景
  5. 如果需要，添加边缘情况
  6. /opsx:ff (完成其余计划)
  7. /opsx:apply
  8. /opsx:verify (严格检查实施是否符合规格)

何时使用：

  • 计费/支付逻辑
  • 安全功能
  • 核心业务逻辑
  • 合规性要求

纯文档变更 (Docs-Only) ​

当您只更新文档或配置，而不触及业务逻辑时。

流程：

  1. /opsx:new update-readme
  2. 手动编辑任务以仅包含文档更新
  3. /opsx:apply
  4. /opsx:archive --skip-specs (跳过规格更新，因为它不影响系统行为)

何时使用：

  • 更新 README
  • 修复错别字
  • 更新 CI 配置
  • 重构不改变行为的代码

并行变更 (Parallel Changes) ​

与团队成员或在不同功能上并行工作。

流程：

  1. 您：/opsx:new feature-a
  2. 您：/opsx:ff feature-a
  3. 队友：/opsx:new feature-b
  4. 队友：/opsx:ff feature-b
  5. 您：/opsx:apply feature-a... 完成并将代码推送到 git
  6. 队友：/opsx:apply feature-b... 完成并将代码推送到 git
  7. 合并 git 分支
  8. /opsx:bulk-archive feature-a feature-b (解决任何增量规格合并)

提示：

  • OpenSpec 的设计使得并行工作是安全的。
  • 即使您都触及 auth/spec.md，只要您修改不同的需求，归档就会干净地处理它。
  • 如果存在冲突（例如，您都修改了同一个需求），bulk-archive 将帮助解决它。