openspec-ff-change

アーティファクト作成を高速処理 - 実装を開始するために必要なすべてを一度に生成します。

入力: ユーザーのリクエストには以下を含める必要があります:

• Jira チケット ID (例: SCRUM-123) - Jira MCP を使用してチケット内容を取得します
• チェンジ名 (ケバブケース) - その名前をそのまま使用します
• 構築したい内容の説明 - ケバブケース名を派生させます

ステップ

1. 入力タイプを判定してコンテキストを取得

   a. 入力が Jira チケット ID のように見える場合 (SCRUM-123、PROJ-456 などのパターンに一致):

   • getAccessibleAtlassianResources MCP ツールを使用して cloudId を取得
   • getJiraIssue MCP ツールを以下で使用:
     • cloudId: 上記で取得したもの
     • issueIdOrKey: 提供されたチケット ID
   • チケット内容 (タイトル、説明、受け入れ基準など) を抽出
   • チケットタイトルからケバブケースのチェンジ名を派生させます:
     • チケットタイトルを小文字に変換
     • スペースと特殊文字をハイフンに置換
     • 先頭と末尾のハイフンを削除
     • 例: "Update Position API" → update-position-api, "Add User Auth" → add-user-auth
     • チケットタイトルが不明確または長すぎる場合は、短い意味のあるバージョンを使用
   • 派生したケバブケース名をチェンジディレクトリの <name> として使用
   • チェンジコンテキストの作成にチケット内容を使用
   • 参照用にチケット ID を保存 (例: proposal またはメタデータ内)

   b. 入力がチェンジ名の場合 (ケバブケース形式):

   • 提供された名前をそのまま使用
   • チェンジが既に存在するかをチェック。存在する場合はユーザーに続行するかを確認

   c. 入力が説明の場合:

   • ケバブケース名を派生させます (例: "add user authentication" → add-user-auth)

   d. 入力が提供されない場合:

   • AskUserQuestion ツール (オープンエンド、プリセットオプションなし) を使用して以下を質問:

     "どのようなチェンジに取り組みたいですか? Jira チケット ID (例: SCRUM-123)、チェンジ名、または構築したい内容を説明してください。"

   重要: ユーザーが何を構築したいかを理解せずに進行しないでください。

2. チェンジディレクトリを作成

   openspec new change "<name>"
   

   これは openspec/changes/<name>/ にスキャフォルドされたチェンジを作成します。

2.5. 添付ファイルを処理 (存在する場合) ユーザーがこの会話にファイルを添付している場合:

• 会話コンテキストで任意のファイルをチェック (添付ファイルはファイルリストに表示されます)
• 各添付ファイルについて:
  • ファイルを読み取って現在のパスを取得
  • ファイルをチェンジディレクトリのルートに移動: openspec/changes/<name>/<filename>
  • ファイルシステムツールを使用してファイルをコピー/移動し、元のファイル名を保持
• ファイルが移動された場合、ユーザーに通知: "N 個の添付ファイルをチェンジディレクトリのルートに移動しました。"

3. アーティファクトビルド順を取得

   openspec status --change "<name>" --json
   

   JSON を解析して以下を取得:

   • applyRequires: 実装前に必要なアーティファクト ID の配列 (例: ["tasks"])
   • artifacts: すべてのアーティファクトのリストとそのステータスおよび依存関係

4. 適用準備完了まで順序に従ってアーティファクトを作成

   TodoWrite ツール を使用してアーティファクトの進捗を追跡します。

   依存関係の順序でアーティファクトをループ (最初に依存関係がないアーティファクト):

   a. ready (依存関係が満たされた) 状態のアーティファクトごと:

   • 指示を取得:

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

   • 指示 JSON には以下を含みます:
     • context: プロジェクト背景 (あなたの制約 - 出力に含めないでください)
     • rules: アーティファクト固有のルール (あなたの制約 - 出力に含めないでください)
     • template: 出力ファイルに使用する構造
     • instruction: このアーティファクトタイプのスキーマ固有のガイダンス
     • outputPath: アーティファクトを書き込む場所
     • dependencies: コンテキスト読み取り用の完了済みアーティファクト
   • tasks アーティファクトの場合、重大な注意: tasks.md を作成する場合:
     • openspec/config.yaml を読み取ってバックエンド固有のルール (必須ステップ、ブランチ命名規則など) を取得
     • .claude/rules/openspec-tasks-mandatory-steps.mdc を読み取って必須テスト要件とエージェント実行責任を理解
     • タスク構造要件
     • 含める必須のすべてのステップ (例: ステップ 0: 機能ブランチを作成)
   • Jira チケットが提供された場合: チケット内容を使用してアーティファクト作成に情報を提供 (特に proposal と tasks)
   • コンテキスト用に完了済み依存ファイルを読み取る
   • template を構造として使用してアーティファクトファイルを作成
   • context と rules を制約として適用 - ただしファイルにコピーしないでください
   • tasks アーティファクトの場合: config.yaml とルールファイルからのすべての必須ステップが含まれていることを確認:
     • ステップ 0: 機能ブランチを作成 (バックエンド変更の場合は必ず最初のステップ)
     • 既存の単体テストを確認して更新 (必須)
     • 単体テストを実行してデータベースの状態を確認 (必須)
     • curl による手動エンドポイントテスト (必須 - エージェントが実行する必要があります)
     • Playwright MCP による E2E テスト (該当する場合は必須 - エージェントが実行する必要があります)
     • 技術ドキュメンテーションを更新 (必須)
   • 手動テストタスクの場合: エージェントがテストを実行する必要があることを明確にするサブタスクを含める (例: "curl で GET エンドポイントをテスト"、"データベースの状態を復元" など)
   • 簡潔な進捗を表示: "✓ <artifact-id> を作成しました"

   b. すべての applyRequires アーティファクトが完了するまで続行

   • 各アーティファクト作成後、openspec status --change "<name>" --json を再実行
   • applyRequires のすべてのアーティファクト ID がアーティファクト配列内で status: "done" を持っているかをチェック
   • すべての applyRequires アーティファクトが完了したら停止

   c. アーティファクトがユーザー入力を必要とする場合 (不明確なコンテキスト):

   • AskUserQuestion ツール を使用して明確化
   • その後、作成を続行

5. 最終ステータスを表示

   openspec status --change "<name>"
   

出力

すべてのアーティファクト完了後、以下を要約:

• チェンジ名とロケーション
• 作成されたアーティファクトのリストと簡潔な説明
• 準備完了: "すべてのアーティファクトが作成されました! 実装準備完了です。"
• プロンプト: "/opsx:apply を実行するか、タスク作業を開始するよう私に依頼してください。"

アーティファクト作成ガイドライン

• 各アーティファクトタイプについて openspec instructions の instruction フィールドに従う
• スキーマは各アーティファクトが含むべき内容を定義 - それに従う
• 新しいアーティファクトを作成する前にコンテキスト用の依存アーティファクトを読み取る
• template を出力ファイルの構造として使用 - そのセクションを埋める
• 重要: context と rules はあなたのための制約であり、ファイルの内容ではありません
  • <context>、<rules>、<project_context> ブロックをアーティファクトにコピーしないでください
  • これらはあなたが何を書くかをガイドしますが、出力に決して表示されません

ガードレール

• 実装に必要なすべてのアーティファクトを作成 (スキーマの apply.requires で定義される)
• 常に新しいアーティファクトを作成する前に依存アーティファクトを読み取る
• tasks.md の場合: .claude/rules/openspec-tasks-mandatory-steps.mdc を読み取り、すべての必須ステップが適切なエージェント実行要件とともに含まれていることを確認
• コンテキストが重大に不明な場合はユーザーに質問 - ただし勢いを保つために合理的な決定を優先
• その名前のチェンジが既に存在する場合は、代わりにそのチェンジを続行することを提案
• 書き込み後に各アーティファクトファイルが存在することを確認してから次に進む