Communitygithub.com

AmanVarshney01/tcut

実験ワークフローで完了した変更をアーカイブします。実装が完了した変更を最終確定してアーカイブする際に使用します。

tcut とは?

このスキルは、実験的なワークフローにおいて完了した変更を確実にアーカイブするためのものです。開発者は「tcut」スキルを使用することで、変更名の指定、未完了のアーティファクトやタスクの確認、デルタスペックの同期状態の評価、そして最終的なアーカイブ処理を一貫して実行できます。複数のOpenSpecストアやローカルのopenspec/ディレクトリをサポートし、コマンドラインのヒントに従って適切なストアIDを自動選択します。主なステップとして、変更の選択、アーティファクト完了状態のJSON解析、タスクファイルのチェック、デルタスペックの同期評価、日付ベースのアーカイブディレクトリ作成、およびアーカイブ完了後の明確なサマリー表示が含まれます。未完了の項目がある場合は確認プロンプトが表示され、ユーザーは強制的にアーカイブを続行できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AmanVarshney01/tcut/tree/HEAD/.claude/skills/openspec-archive-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ツール を使用してユーザーに選択させます。

    既にアーカイブされていないアクティブな変更のみを表示します。 各変更で使用されているスキーマがあれば含めます。

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

  2. アーティファクトの完了状態を確認

    openspec status --change "<name>" --json を実行してアーティファクトの完了状態を確認します。

    JSONを解析して以下を把握します:

    • schemaName:使用されているワークフロー
    • planningHome、changeRoot、artifactPaths、actionContext:パスとスコープのコンテキスト
    • artifacts:ステータス(done またはその他)を持つアーティファクトのリスト

    done でないアーティファクトがある場合:

    • 未完了のアーティファクトをリストした警告を表示
    • AskUserQuestionツール を使用してユーザーに続行確認
    • ユーザーが確認した場合のみ続行
  3. タスクの完了状態を確認

    タスクファイル(通常は tasks.md)を読み取り、未完了のタスクを確認します。

    - [ ](未完了)と - [x](完了)のマークが付いたタスクをカウントします。

    未完了のタスクがある場合:

    • 未完了タスクの数を示す警告を表示
    • AskUserQuestionツール を使用してユーザーに続行確認
    • ユーザーが確認した場合のみ続行

    タスクファイルが存在しない場合: タスク関連の警告なしで続行します。

  4. デルタスペックの同期状態を評価

    ステータスJSONの artifactPaths.specs.existingOutputPaths を使用してデルタスペックを確認します。存在しない場合は、同期プロンプトなしで続行します。

    デルタスペックが存在する場合:

    • 各デルタスペックを、openspec/specs/<capability>/spec.md にある対応するメインスペックと比較
    • 適用される変更(追加、修正、削除、リネーム)を特定
    • プロンプトの前に結合サマリーを表示

    プロンプトオプション:

    • 変更が必要な場合:「今すぐ同期(推奨)」、「同期せずにアーカイブ」
    • 既に同期済みの場合:「今すぐアーカイブ」、「とにかく同期」、「キャンセル」

    ユーザーが同期を選択した場合、Taskツール(subagent_type: "general-purpose"、プロンプト: "Use Skill tool to invoke openspec-sync-specs for change ''. Delta spec analysis: <分析したデルタスペックのサマリーをここに含める>")を使用します。選択にかかわらずアーカイブに進みます。

  5. アーカイブを実行

    planningHome.changesDir の下に archive ディレクトリが存在しない場合は作成します:

    mkdir -p "<planningHome.changesDir>/archive"
    

    現在の日付を使用してターゲット名を生成:YYYY-MM-DD-<change-name>

    ターゲットが既に存在する場合:

    • エラーで失敗し、既存のアーカイブの名前変更または別の日付の使用を提案
    • 存在しない場合:changeRoot をアーカイブディレクトリに移動
    mv "<changeRoot>" "<planningHome.changesDir>/archive/YYYY-MM-DD-<name>"
    
  6. サマリーを表示

    アーカイブ完了サマリーを表示(以下を含む):

    • 変更名
    • 使用されたスキーマ
    • アーカイブ場所
    • スペックが同期されたかどうか(該当する場合)
    • 警告に関するメモ(未完了のアーティファクト/タスク)

成功時の出力

## アーカイブ完了

**変更:** <change-name>
**スキーマ:** <schema-name>
**アーカイブ先:** `planningHome.changesDir` から派生したアーカイブパス/YYYY-MM-DD-<name>/
**スペック:** ✓ メインスペックに同期済み(または「デルタスペックなし」「同期スキップ」)

全アーティファクト完了。全タスク完了。

ガードレール

  • 変更名が指定されていない場合は必ず選択を促す
  • 完了確認にはアーティファクトグラフ(openspec status --json)を使用
  • 警告があってもアーカイブをブロックせず、通知と確認のみ行う
  • 移動時に .openspec.yaml を保持(ディレクトリごと移動するため)
  • 何が行われたかを明確に示すサマリーを表示
  • 同期が要求された場合は openspec-sync-specs アプローチ(エージェント駆動)を使用
  • デルタスペックが存在する場合は、常に同期評価を実行し、プロンプトの前に結合サマリーを表示

Individual skills in this repo

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

AmanVarshney01/tcut

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

AmanVarshney01/tcut

Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.

AmanVarshney01/tcut

Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation.

AmanVarshney01/tcut

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

AmanVarshney01/tcut

Update an OpenSpec change by revising its existing planning artifacts and keeping them coherent with one another. Use when the user wants to revise a change's plan, fold new decisions into it, or reconcile its artifacts after an edit. Never edits code.

AmanVarshney01/tcut

Combine tcut terminal recordings with Remotion to produce polished, motion-designed launch/promo videos (title cards, animated captions, layered terminal footage). Use when the user wants a product video, launch video, or social video that features terminal/CLI footage.

AmanVarshney01/tcut

Record reproducible terminal videos (MP4/GIF/SVG/HTML) from TypeScript scripts or live sessions with the tcut CLI. Use when the user wants a terminal demo, CLI screencast, TUI recording, or animated terminal GIF for a README, website, or social post.

関連スキル