openspec-new-change

実験的なアーティファクト駆動アプローチを使用して、新しい変更を開始します。

入力: ユーザーのリクエストには、変更名（ケバブケース）または構築したいものの説明を含める必要があります。

手順

1. 明確な入力が提供されていない場合は、構築したいものを尋ねる

   AskUserQuestion ツール（自由回答、プリセットオプションなし）を使用して、次のように尋ねます:

   「どの変更に取り組みたいですか？ 構築または修正したいものを説明してください。」

   その説明から、ケバブケースの名前を導き出します（例: 「add user authentication」→ add-user-auth）。

   重要: ユーザーが構築したいものを理解せずに先に進まないでください。

2. ワークフロースキーマを決定する

   ユーザーが明示的に異なるワークフローを要求しない限り、デフォルトのスキーマを使用します（--schema を省略）。

   異なるスキーマを使用するのは、ユーザーが次のように言及した場合のみです:

   • 「tdd」または「test-driven」→ --schema tdd を使用
   • 特定のスキーマ名 → --schema <name> を使用
   • 「show workflows」または「what workflows」→ openspec schemas --json を実行して選択させる

   それ以外の場合: --schema を省略してデフォルトを使用します。

3. 変更ディレクトリを作成する

   openspec new change "<name>"
   

   ユーザーが特定のワークフローを要求した場合にのみ、--schema <name> を追加します。 これにより、選択したスキーマで openspec/changes/<name>/ にスキャフォールドされた変更が作成されます。

4. アーティファクトのステータスを表示する

   openspec status --change "<name>"
   

   これにより、作成する必要があるアーティファクトと、準備ができている（依存関係が満たされている）アーティファクトが表示されます。

5. 最初のアーティファクトの手順を取得する 最初のアーティファクトはスキーマによって異なります（例: spec-driven の場合は proposal、tdd の場合は spec）。 ステータス出力を確認して、ステータスが「ready」の最初のアーティファクトを見つけます。

   openspec instructions <first-artifact-id> --change "<name>"
   

   これにより、最初のアーティファクトを作成するためのテンプレートとコンテキストが出力されます。

6. 停止して、ユーザーの指示を待つ

出力

手順を完了したら、次を要約します:

• 変更名と場所
• 使用しているスキーマ/ワークフローとそのアーティファクトの順序
• 現在のステータス（0/N 個のアーティファクトが完了）
• 最初のアーティファクトのテンプレート
• プロンプト: 「最初のアーティファクトを作成する準備はできましたか？ この変更が何についてなのかを説明していただければ私が草案を作成します。または、続行するように依頼してください。」

ガードレール

• まだアーティファクトを作成しないでください - 手順を表示するだけです
• 最初のアーティファクトのテンプレートを表示する以上に先に進まないでください
• 名前が無効な場合（ケバブケースでない場合）、有効な名前を尋ねてください
• その名前の変更がすでに存在する場合は、代わりにその変更を続行することを提案してください
• デフォルト以外のワークフローを使用する場合は --schema を渡してください