Communitygithub.com

AmanVarshney01/tcut

OpenSpec 変更の既存の計画成果物を改訂し、相互の一貫性を保ちます。ユーザーが変更の計画を修正したり、新しい決定を組み込んだり、編集後に成果物間の整合性を取る際に使用します。コードは編集しません。

tcut とは?

このスキルは、OpenSpec ワークフローにおける「変更 (change)」の既存の計画成果物(設計書、仕様書など)を改訂し、それらが相互に矛盾なく一貫性を保つように調整するためのAIエージェント向けツールです。開発者は、計画を修正したり、新しい技術的判断を計画に反映させたい場合にこのスキルを使用します。主に Claude Code, Cursor, Codex などのAIエージェントが、OpenSpec CLI を通じて成果物を読み取り、編集します。 このスキルの核心は、特定の変更に関連する成果物群を解析し、ある成果物に対する編集が他の成果物と矛盾しないかを自動的にチェックする点にあります。例えば、設計の後半部分を編集した場合、その影響が前半の要件定義に及ぶかどうかも検証し、必要に応じて修正を提案します。これは単なる順方向の編集ではなく、任意の成果物間での双方向の一貫性チェックを行います。 重要なのは、**コードを一切編集しない**というガードレールです。計画の改訂に専念し、コードの変更が必要な場合は `/opsx:apply` を提案します。また、新しい成果物の作成は行わず、未作成の成果物については `/opsx:continue` を推奨します。編集は常にユーザーの確認を得てから実行され、変更の意図自体が変わる場合には `/opsx:new` で新規作成を促します。 対応プラットフォーム: Claude Code (推奨), Cursor, Codex などの OpenSpec CLI と連携可能な AI コーディングエージェント。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AmanVarshney01/tcut/tree/HEAD/.claude/skills/openspec-update-change

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

変更の既存の計画成果物を改訂し、相互の一貫性を保ちます。コードは絶対に編集しません。

ストアの選択: ユーザーがストア(このマシンに登録されているスタンドアロンのOpenSpecリポジトリ)を指定した場合、または作業がストア内にある場合は、openspec store list --json を実行して登録済みのストアIDを確認し、仕様や変更を読み書きするコマンド(new change、status、instructions、list、show、validate、archive、doctor、context)には --store <id> を渡します。その他のコマンドはこのフラグを受け付けません。コマンドが出力するヒントには既にフラグが含まれているため、フォローアップでもそのまま使用します。ストアがない場合、コマンドは最も近いローカルの openspec/ ルートに対して動作します。

入力: 変更名をオプションで指定できます。省略された場合は、会話の文脈から推測できるか確認します。曖昧または不明な場合は、利用可能な変更をユーザーに問い合わせる必要があります。

手順

  1. 変更名が指定されていない場合、選択を促す

    openspec list --json を実行して、最後に変更された順に並べられた利用可能な変更を取得します。次に AskUserQuestion ツール を使用して、ユーザーに更新する変更を選択させます。

    最新の変更3〜4件をオプションとして表示し、以下を示します:

    • 変更名
    • スキーマ(schema フィールドがあればそれ、なければ "spec-driven")
    • ステータス(例: "0/5 tasks"、"complete"、"no tasks")
    • 最終更新日時(lastModified フィールドから)

    最も最近変更された変更には "(推奨)" とマークします。これはユーザーが更新したい可能性が高いためです。

    重要: 変更を推測したり自動選択したりしないでください。常にユーザーに選択させます。

  2. 変更の成果物を取得する

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

    JSON を解析して現在の状態を理解します。レスポンスには以下が含まれます:

    • schemaName: 使用されているワークフロースキーマ(例: "spec-driven")
    • artifacts: 成果物の配列(ステータスは "done"、"ready"、"blocked")
    • isComplete: すべての成果物が完了しているかを示すブール値
    • planningHome、changeRoot、artifactPaths、actionContext: パスとスコープのコンテキスト。リポジトリローカルのパスを仮定せずにこれらを使用します。

    成果物IDとパスはアクティブなスキーマから取得されます。ハードコードされた成果物名を仮定したり、分岐したりしないでください。カスタムスキーマでもそのまま動作する必要があります。

    編集するファイルは artifactPaths.<id>.existingOutputPaths です。これはディスク上に存在する具体的なファイルで、グロブ成果物(例: specs/**/*.md)の場合は既に展開されています。resolvedOutputPath には書き込まないでください。グロブ成果物の場合、それは依然としてグロブパターンであり、実際のファイルではありません。

  3. リクエストを理解する

    • ユーザーが特定の改訂を依頼した場合("設計は今後Xを使用する")、それが編集の起点となります。
    • 単に "更新" や "一貫性を保つ" とだけ言われた場合は、一貫性レビューとして扱います。既存の成果物を読み、それらを相互にチェックして矛盾、欠落、重複がないか確認します。
  4. 読み取りと調整

    • リクエストが触れる成果物と、変更の他の既存の成果物を読みます。
    • 要求された編集を適用します。その後、他のすべての既存の成果物をそれに対してチェックします。任意の方向で: 後の成果物への編集は前の成果物の修正を必要とする場合があり、その逆も同様です。ビルド順序は有用な読み取り順序ですが、どの成果物が改訂されるかの制約ではありません。
    • 矛盾、欠落、または矛盾しているものをすべて記録します。
    • 既に存在するファイル(existingOutputPaths)のみを改訂します。まだ存在しない成果物を作成したり、グロブ成果物の下に新しいファイルを作成したりしないでください。それらを記録し、ユーザーに /opsx:continue を実行して作成するよう促します。
    • 変更が既に一貫している場合は、その旨を伝え、編集を行いません。
  5. 確認と適用を1つの成果物ずつ行う

    • 各修正案とその理由を示します。ユーザーが確認した後にのみ書き込みます。
    • ユーザーが修正を拒否した場合、書き込まず、その成果物は変更しないままにします。
    • 大幅な書き換えが必要な場合は、まずその成果物のルールとテンプレートを取得します:
      openspec instructions <artifact-id> --change "<name>" --json
      
  6. 次のステップを指示する(ガイダンスのみ - 決して実行しない)

    • まだ存在しない成果物がある場合 -> /opsx:continue を実行して作成するよう提案します。
    • 変更が既に実装済み(タスクがチェック済み、または既に適用済み)の場合 -> コードが改訂された計画と一致しなくなっている可能性があります。 /opsx:apply を実行して差分をコードに反映するよう提案します。
    • すべて完了し実装済みの場合 -> /opsx:archive を提案します。

出力

各呼び出しの後、以下を表示します:

  • どの成果物が改訂されたか(およびどの修正案が拒否されたか)
  • /opsx:continue に先送りされたもの(未作成の成果物やファイル)
  • 変更の現状と推奨される次のコマンド

ガードレール

  • 計画成果物のみ - 実装コードは決して編集しません。改訂された計画がコードの変更を意味する場合は、そこで止めて /opsx:apply を指示します。
  • openspec status が報告する成果物IDとパスを使用します。ハードコードされた成果物名で分岐しないでください。
  • existingOutputPaths 内の具体的なファイルのみを編集します。グロブの resolvedOutputPath には書き込まないでください。
  • ビルドフロンティアを進めないでください。新しい成果物の作成や、グロブ成果物の下への新しいファイルの追加は行いません。それは /opsx:continue の役割です。
  • すべての編集は、書き込む前にユーザーに確認します。
  • リクエストが変更の意図を変更するものであり、洗練するものではない場合は、/opsx:new で新規作成を推奨します(「更新 vs 新規作成」のヒューリスティック)。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

関連スキル