mcpField
O
openspec-new

openspec-new

github.com/full-stack-skillsエージェントワークフロー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 新規スキル

新しい変更を開始するには /opsx:new を使用します。openspec/changes/<name>/ の下に、メタデータ（.openspec.yaml）を含む変更用フォルダー構造を作成し、最初のアーティファクトを作成できる状態にします。

使用するタイミング

  • 新機能、バグ修正、リファクタリングに着手するとき。
  • ユーザーが「変更を開始して」「新機能を作って」「新しい OpenSpec の変更を始めて」と言ったとき。
  • openspec-explore でアイデアを検討し、何を構築するか決めた後。

前提条件

  • プロジェクトで OpenSpec が初期化済み であること（openspec-initial を参照）。

ワークフロー

  1. 変更を開始する

    • /opsx:new <change-name> — 例：/opsx:new add-dark-mode。
    • /opsx:new <change-name> --schema <schema> — 特定のワークフロースキーマを使用します（デフォルト：spec-driven）。
    • 名前が指定されていない場合、エージェントが名前を尋ねます。

  2. 作成されるもの

    • openspec/changes/<name>/ ディレクトリ。
    • openspec/changes/<name>/.openspec.yaml — 変更メタデータ（スキーマ、作成日）。

  3. 次のアクション

    • エージェントが、作成可能な最初のアーティファクト（通常は proposal）を表示します。
    • openspec-continue を使用してアーティファクトを1つずつ作成するか、openspec-ff を使用してすべての計画アーティファクトを一度に作成します。

命名規則

  • 内容が分かる名前を使用します：add-dark-mode、fix-login-bug、refactor-auth。
  • 一般的すぎる名前は避けます：update、changes、wip。
  • ケバブケースを使用します。

出力

  • .openspec.yaml を含む openspec/changes/<name>/ ディレクトリ。

次のステップ

  • openspec-continue を使用して、次のアーティファクトを段階的に作成します。
  • または、openspec-ff を使用して、すべての計画アーティファクトを一度に作成します。

トラブルシューティング

  • 「Change not found」：変更名が一致しているか確認します。openspec list を実行して、アクティブな変更を確認します。
  • 「Schema not found」：openspec schemas で利用可能なスキーマを一覧表示します。カスタムスキーマについては openspec-schema を参照してください。

参考資料

コメント

Markdown 対応