mcpField
O
openspec-new

openspec-new

github.com/full-stack-skillsAgent 工作流188 次安装4 周前更新
代码仓库

关于 openspec-new

openspec-new 是用于启动 OpenSpec 变更的技能，适用于功能、缺陷修复或重构。它会创建变更目录和元数据，并提示接下来要编写的规划文档。

主要功能

  1. 01启动命名变更
  2. 02选择工作流 schema
  3. 03创建变更目录和元数据
  4. 04提示下一份待创建文档

适用场景

  1. 01启动新功能的规划
  2. 02为缺陷修复或重构创建变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-new

安装后在 Claude Code 中输入/openspec-new确认已加载。

附带文件agents/openai.yaml

详细介绍

OpenSpec 新建 Skill

使用 /opsx:new 开始一项新变更。此命令会在 openspec/changes/<name>/ 下创建变更文件夹结构，添加元数据（.openspec.yaml），并准备好创建第一个产物。

适用场景

  • 开始开发新功能、修复 Bug 或重构。
  • 用户说“开始一项变更”“新功能”或“新建 OpenSpec 变更”。
  • 使用 openspec-explore 探索想法并确定要构建的内容后。

前置条件

  • 项目中已初始化 OpenSpec（请参阅 openspec-initial）。

工作流

  1. 开始变更

    • /opsx:new <change-name> — 例如：/opsx:new add-dark-mode。
    • /opsx:new <change-name> --schema <schema> — 使用指定的工作流 Schema（默认值：spec-driven）。
    • 如果未提供名称，Agent 会提示输入名称。

  2. 创建的内容

    • openspec/changes/<name>/ 目录。
    • openspec/changes/<name>/.openspec.yaml — 变更元数据（Schema、创建日期）。

  3. 下一步操作

    • Agent 会显示准备创建的第一个产物（通常是 proposal）。
    • 使用 openspec-continue 一次创建一个产物，或使用 openspec-ff 一次性创建所有规划产物。

命名约定

  • 使用描述性名称：add-dark-mode、fix-login-bug、refactor-auth。
  • 避免使用通用名称：update、changes、wip。
  • 使用 kebab-case。

输出

  • 包含 .openspec.yaml 的 openspec/changes/<name>/ 目录。

后续步骤

  • 使用 openspec-continue 逐步创建下一个产物。
  • 或使用 openspec-ff 一次性快进完成所有规划产物。

故障排除

  • “找不到变更”：检查变更名称是否匹配；运行 openspec list 查看活跃变更。
  • “找不到 Schema”：运行 openspec schemas 查看可用 Schema；自定义 Schema 请参阅 openspec-schema。

参考资料

评论

支持 Markdown